@wasmsoft/fantastic 1.0.0

package/dist/commands/config/set.js

@@ -0,0 +1,56 @@
+import { Args } from "@oclif/core";
+import { BaseCommand } from "../../base-command.js";
+import { CONFIG_KEYS, ConfigError, configPath, setConfigValue } from "../../config/local-config.js";
+import { buildEnvelope, renderJson } from "../../render/json.js";
+import { c, glyph } from "../../render/theme.js";
+import { EXIT } from "../../exit-codes.js";
+// AR: يكتب إعدادًا واحدًا، **بعد رفض التعارض** (017/FR-009). منفذان متطابقان لا يظهران عند الكتابة
+//     بل عند الإقلاع التالي، فالرفض هنا يوفّر تشخيصًا لاحقًا.
+// EN: Writes one setting, **after rejecting a collision** (017/FR-009). Two equal ports do not
+//     surface at write time but at the next boot, so refusing here saves a diagnosis later.
+export default class ConfigSet extends BaseCommand {
+    static description = "Change one CLI setting, refusing a port that collides with another";
+    static examples = ["<%= config.bin %> config set corePort 3026", "<%= config.bin %> config set defaultProfile dev"];
+    static args = {
+        key: Args.string({ description: "Setting name", required: true, options: [...CONFIG_KEYS] }),
+        value: Args.string({ description: "New value", required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ConfigSet);
+        const profile = this.loadProfile(flags.profile, true, flags.product);
+        const key = args.key;
+        try {
+            const next = setConfigValue(profile, key, args.value);
+            if (flags.json) {
+                this.log(renderJson(buildEnvelope({ command: "config set", profile, data: { key, value: next[key], file: configPath(profile) } })));
+                return;
+            }
+            this.log(`${c.ok(glyph.pass)} ${key} = ${c.value(String(next[key]))}`);
+            this.log(c.dim(`written to ${configPath(profile)} · restart to apply: fantastic restart`));
+        }
+        catch (error) {
+            if (!(error instanceof ConfigError))
+                throw error;
+            if (flags.json) {
+                this.log(renderJson(buildEnvelope({
+                    command: "config set",
+                    profile,
+                    data: { key, written: false },
+                    problems: [
+                        {
+                            id: "config.set",
+                            severity: "fail",
+                            message: error.message,
+                            remedy: "Pick a free value, or change the conflicting setting first: fantastic config list",
+                        },
+                    ],
+                })));
+                this.exit(EXIT.FAILURE);
+            }
+            this.log(c.bad(error.message));
+            this.log(`${c.accent(glyph.arrow)} See what is taken: fantastic config list`);
+            this.exit(EXIT.FAILURE);
+        }
+    }
+}
+//# sourceMappingURL=set.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../src/commands/config/set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAkB,MAAM,8BAA8B,CAAC;AACpH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C,mGAAmG;AACnG,8DAA8D;AAC9D,+FAA+F;AAC/F,4FAA4F;AAE5F,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,MAAM,CAAC,WAAW,GAAG,oEAAoE,CAAC;IAE1F,MAAM,CAAC,QAAQ,GAAG,CAAC,4CAA4C,EAAE,iDAAiD,CAAC,CAAC;IAEpH,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;QAC5F,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;KACjE,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,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAErE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAgB,CAAC;QAElC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAEtD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACf,IAAI,CAAC,GAAG,CACN,UAAU,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAC1H,CAAC;gBACF,OAAO;YACT,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACvE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,UAAU,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC,CAAC;QAC7F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,CAAC,KAAK,YAAY,WAAW,CAAC;gBAAE,MAAM,KAAK,CAAC;YAEjD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACf,IAAI,CAAC,GAAG,CACN,UAAU,CACR,aAAa,CAAC;oBACZ,OAAO,EAAE,YAAY;oBACrB,OAAO;oBACP,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;oBAC7B,QAAQ,EAAE;wBACR;4BACE,EAAE,EAAE,YAAY;4BAChB,QAAQ,EAAE,MAAM;4BAChB,OAAO,EAAE,KAAK,CAAC,OAAO;4BACtB,MAAM,EAAE,mFAAmF;yBAC5F;qBACF;iBACF,CAAC,CACH,CACF,CAAC;gBACF,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1B,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAC/B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAC9E,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC"}

package/dist/commands/db/migrate.d.ts

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

package/dist/commands/db/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/commands/db/migrate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAWpD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,MAAM,CAAC,WAAW,SAAuC;IAEzD,MAAM,CAAC,QAAQ,WAA8E;IAE7F,MAAM,CAAC,KAAK;;MAKV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAqD3B"}

package/dist/commands/db/migrate.js

@@ -0,0 +1,67 @@
+import { Flags } from "@oclif/core";
+import ora from "ora";
+import { BaseCommand } from "../../base-command.js";
+import { runCoreScript } 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: تشغيل الهجرات المعلَّقة من أي مجلد. الإقلاع العادي يشغّلها تلقائيًا؛ هذا للاستخدام الصريح —
+//     قبل الإقلاع في ‎setup‎، وبعد تحديثٍ يضيف جداول.
+// EN: Applies pending migrations from any directory. Normal boot runs them automatically; this is for
+//     explicit use — before boot in `setup`, and after an update that adds tables.
+export default class DbMigrate extends BaseCommand {
+    static description = "Apply pending database migrations";
+    static examples = ["<%= config.bin %> db migrate", "<%= config.bin %> db migrate --dry-run"];
+    static flags = {
+        "dry-run": Flags.boolean({
+            description: "Report where migrations would be applied without applying them.",
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(DbMigrate);
+        const profile = this.loadProfile(flags.profile, true, flags.product);
+        if (flags["dry-run"]) {
+            // لا نشغّل شيئًا: نقول أين ستُطبَّق. الوجهة هي ما يخطئ فيه الناس عادةً، لا المحتوى.
+            const target = `${profile.dataDir}\\fantastic.db`;
+            if (flags.json) {
+                this.log(renderJson(buildEnvelope({ command: "db migrate", profile, data: { dryRun: true, target } })));
+                return;
+            }
+            this.log(`${c.dim("would apply migrations to:")} ${c.value(target)}`);
+            return;
+        }
+        const spinner = ora({ isEnabled: isTty && !flags.json, discardStdin: false });
+        spinner.start("applying migrations…");
+        const result = await runCoreScript(profile, "db:migrate");
+        spinner.stop();
+        if (flags.json) {
+            this.log(renderJson(buildEnvelope({
+                command: "db migrate",
+                profile,
+                data: { applied: result.ok, output: result.output.trim() },
+                problems: result.ok
+                    ? []
+                    : [
+                        {
+                            id: "db.migrate",
+                            severity: "fail",
+                            message: "migrations failed",
+                            remedy: "Run: fantastic doctor — check the database file exists and can be opened.",
+                        },
+                    ],
+            })));
+            if (!result.ok)
+                this.exit(EXIT.FAILURE);
+            return;
+        }
+        if (!result.ok) {
+            this.log(c.bad("Migrations failed."));
+            this.log(result.output.split("\n").slice(-15).join("\n"));
+            this.log(`${c.accent(glyph.arrow)} Run: fantastic doctor`);
+            this.exit(EXIT.FAILURE);
+        }
+        this.log(`${c.ok(glyph.pass)} Migrations applied  ${c.dim(profile.dataDir)}`);
+    }
+}
+//# sourceMappingURL=migrate.js.map

package/dist/commands/db/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../../src/commands/db/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C,kGAAkG;AAClG,sDAAsD;AACtD,sGAAsG;AACtG,mFAAmF;AAEnF,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,MAAM,CAAC,WAAW,GAAG,mCAAmC,CAAC;IAEzD,MAAM,CAAC,QAAQ,GAAG,CAAC,8BAA8B,EAAE,wCAAwC,CAAC,CAAC;IAE7F,MAAM,CAAC,KAAK,GAAG;QACb,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;YACvB,WAAW,EAAE,iEAAiE;YAC9E,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAErE,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YACrB,oFAAoF;YACpF,MAAM,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,gBAAgB,CAAC;YAClD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACf,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;gBACxG,OAAO;YACT,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,4BAA4B,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACtE,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9E,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,EAAE,CAAC;QAEf,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CACN,UAAU,CACR,aAAa,CAAC;gBACZ,OAAO,EAAE,YAAY;gBACrB,OAAO;gBACP,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE;gBAC1D,QAAQ,EAAE,MAAM,CAAC,EAAE;oBACjB,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC;wBACE;4BACE,EAAE,EAAE,YAAY;4BAChB,QAAQ,EAAE,MAAM;4BAChB,OAAO,EAAE,mBAAmB;4BAC5B,MAAM,EAAE,2EAA2E;yBACpF;qBACF;aACN,CAAC,CACH,CACF,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,EAAE;gBAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1D,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAC3D,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChF,CAAC"}

package/dist/commands/dev.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from "../base-command.js";
+export default class Dev extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        only: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    private running;
+    private stopping;
+    run(): Promise<void>;
+    /** فحص المنافذ قبل أي إطلاق: رفض يسمّي صاحب المنفذ بدل EADDRINUSE خام. */
+    private preflight;
+    private startOne;
+    /** ينتظر Ctrl+C أو موت خدمة. أيّهما وقع أوّلًا أنهى الجلسة بترتيب معكوس. */
+    private waitForInterrupt;
+    private reportDeath;
+    private shutdown;
+}
+//# sourceMappingURL=dev.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAoBjD,MAAM,CAAC,OAAO,OAAO,GAAI,SAAQ,WAAW;IAC1C,MAAM,CAAC,WAAW,SAAqE;IAEvF,MAAM,CAAC,QAAQ,WAAuE;IAEtF,MAAM,CAAC,KAAK;;MAOV;IAEF,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,QAAQ,CAAS;IAEnB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAiC1B,0EAA0E;YAC5D,SAAS;YAWT,QAAQ;IAmDtB,4EAA4E;YAC9D,gBAAgB;IAkB9B,OAAO,CAAC,WAAW;YAQL,QAAQ;CAoBvB"}

package/dist/commands/dev.js

@@ -0,0 +1,149 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand } from "../base-command.js";
+import { findPortConflicts } from "../probes/port.probe.js";
+import { probeService } from "../probes/service.probe.js";
+import { launchAttached } from "../supervisor/spawn.js";
+import { waitForReady } from "../supervisor/readiness.js";
+import { terminateTree } from "../supervisor/tree-kill.js";
+import { readProcessIdentity } from "../supervisor/process-identity.js";
+import { removePidRecord, writePidRecord } from "../supervisor/pidfile.js";
+import { renderConflicts, renderUrls } from "../render/boot.render.js";
+import { c, glyph, servicePrefixColor } from "../render/theme.js";
+// AR: وضع التطوير المرتبط بالطرفية. هو ما يستبدل النوافذ الثلاث فعليًا: إقلاع مرتّب، سجلات مدموجة
+//     ببادئة ملوّنة، وCtrl+C واحدة توقف الجميع بترتيب معكوس بلا عمليات يتيمة.
+//     لا إعادة تشغيل تلقائية هنا عن قصد: حلقة إعادة تشغيل أثناء التطوير تُخفي خطأ صياغة بدل إظهاره.
+// EN: The attached development mode. This is what actually replaces the three windows: an ordered
+//     boot, merged logs with a coloured prefix, and one Ctrl+C that stops everything in reverse with
+//     no orphans left. There is deliberately no auto-restart: a restart loop during development hides
+//     a syntax error instead of surfacing it.
+export default class Dev extends BaseCommand {
+    static description = "Run in the foreground with merged logs; Ctrl+C stops everything";
+    static examples = ["<%= config.bin %> dev", "<%= config.bin %> dev --only core,live"];
+    static flags = {
+        only: Flags.string({
+            description: "Limit to specific services, comma separated",
+            multiple: true,
+            delimiter: ",",
+            options: ["live", "core", "portal"],
+        }),
+    };
+    running = [];
+    stopping = false;
+    async run() {
+        const { flags } = await this.parse(Dev);
+        const profile = this.loadProfile(flags.profile, true, flags.product);
+        const only = flags.only;
+        const targets = only
+            ? profile.services.filter((service) => only.includes(service.name))
+            : profile.services;
+        this.log("");
+        this.log(`${c.dim("profile:")} ${c.value(profile.kind)}   ${c.dim("data:")} ${c.value(profile.dataDir)}`);
+        if (!(await this.preflight(targets)))
+            return;
+        for (const definition of targets) {
+            const ready = await this.startOne(profile, definition);
+            if (!ready) {
+                await this.shutdown(profile);
+                this.exit(1);
+                return;
+            }
+        }
+        this.log("");
+        this.log(renderUrls(profile));
+        this.log("");
+        this.log(c.dim("— Ctrl+C to stop everything —"));
+        this.log("");
+        await this.waitForInterrupt(profile);
+    }
+    /** فحص المنافذ قبل أي إطلاق: رفض يسمّي صاحب المنفذ بدل EADDRINUSE خام. */
+    async preflight(targets) {
+        const conflicts = await findPortConflicts(targets.map((service) => service.port));
+        if (conflicts.length === 0)
+            return true;
+        this.log("");
+        this.log(renderConflicts(conflicts));
+        this.log("");
+        this.exit(3);
+        return false;
+    }
+    async startOne(profile, definition) {
+        this.log(`${c.dim(glyph.step)} starting ${definition.label}…`);
+        const attached = launchAttached(profile, definition, {
+            onLine: (service, line) => {
+                this.log(`${servicePrefixColor[service.name](`[${service.name.padEnd(6)}]`)} ${line}`);
+            },
+        });
+        this.running.push(attached);
+        // العملية المرتبطة تحيا مع الـ CLI؛ نكتب سجلّها ليجدها ‎status‎ من طرفية أخرى.
+        if (attached.pid) {
+            const identity = await readProcessIdentity(attached.pid);
+            writePidRecord(profile, {
+                service: definition.name,
+                pid: attached.pid,
+                port: definition.port,
+                profile: profile.kind,
+                startedAt: identity?.startedAt ?? "",
+                commandLine: identity?.commandLine ?? "",
+                writtenAt: new Date().toISOString(),
+            });
+        }
+        let exited = false;
+        void attached.child.then(() => {
+            exited = true;
+        }, () => {
+            exited = true;
+        });
+        const outcome = await waitForReady(definition, {
+            logDir: profile.logDir,
+            stillRunning: async () => !exited,
+        });
+        if (!outcome.ready) {
+            this.log("");
+            this.log(`  ${c.bad(glyph.bad)} ${definition.label}: ${c.bad(outcome.reason ?? "failed to start")}`);
+            for (const line of outcome.tail ?? [])
+                this.log(c.dim(`  │ ${line}`));
+            return false;
+        }
+        this.log(`  ${c.ok(glyph.ok)} ${definition.label} ${c.dim(`${definition.host}:${definition.port}`)}`);
+        return true;
+    }
+    /** ينتظر Ctrl+C أو موت خدمة. أيّهما وقع أوّلًا أنهى الجلسة بترتيب معكوس. */
+    async waitForInterrupt(profile) {
+        await new Promise((resolvePromise) => {
+            const finish = () => {
+                void this.shutdown(profile).then(resolvePromise);
+            };
+            process.once("SIGINT", finish);
+            process.once("SIGTERM", finish);
+            for (const service of this.running) {
+                void service.child.then(() => this.reportDeath(service, finish), () => this.reportDeath(service, finish));
+            }
+        });
+    }
+    reportDeath(service, finish) {
+        if (this.stopping)
+            return;
+        this.log("");
+        this.log(c.bad(`${glyph.bad} ${service.definition.label} exited on its own. Shutting down.`));
+        finish();
+    }
+    async shutdown(profile) {
+        if (this.stopping)
+            return;
+        this.stopping = true;
+        this.log("");
+        this.log(c.dim("stopping services…"));
+        // بترتيب معكوس: نُسقط الواجهة أولًا فلا يصل طلب إلى خدمة تُغلَق تحته.
+        for (const service of [...this.running].reverse()) {
+            if (service.pid)
+                await terminateTree(service.pid);
+            service.close();
+            removePidRecord(profile, service.definition.name);
+            const probe = await probeService(service.definition, 1_000);
+            const mark = probe.reachable ? c.warn(glyph.warn) : c.ok(glyph.ok);
+            this.log(`  ${mark} ${service.definition.label}`);
+        }
+        this.log("");
+    }
+}
+//# sourceMappingURL=dev.js.map

package/dist/commands/dev.js.map

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

package/dist/commands/doctor.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAkB,MAAM,oBAAoB,CAAC;AAajE,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,WAAW;IAC7C,MAAM,CAAC,WAAW,SAAqE;IAEvF,MAAM,CAAC,QAAQ,WAAyG;IAGxH,MAAM,CAAC,IAAI,SAAkB;IAE7B,MAAM,CAAC,KAAK;;MAKV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAyD3B"}

package/dist/commands/doctor.js

@@ -0,0 +1,75 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand, EXIT_CODE_HELP } from "../base-command.js";
+import { runDoctor } from "../doctor/registry.js";
+import { doctorJsonData, doctorProblems, renderDoctorReport } from "../render/doctor.render.js";
+import { buildEnvelope, renderJson } from "../render/json.js";
+import { renderBrand } from "../render/brand.js";
+import { c } from "../render/theme.js";
+import { latestPublished } from "../updating/self.js";
+import { EXIT } from "../exit-codes.js";
+// AR: التشخيص. أمر رقيق: يشغّل السجلّ ويسلّم النتيجة إلى العارضة، ولا يحسب شيئًا بنفسه.
+// EN: Diagnosis. A thin command: it runs the registry and hands the result to the renderer,
+//     computing nothing itself.
+export default class Doctor extends BaseCommand {
+    static description = "Check the machine and report every problem with a suggested fix";
+    static examples = ["<%= config.bin %> doctor", "<%= config.bin %> doctor --json", "<%= config.bin %> doctor --verbose"];
+    // العقد يُعرض حيث يُقرأ: ‎doctor‎ هو الأمر الذي تُستدعى رموزه في سكربتات البوّابة أكثر من غيره.
+    static help = EXIT_CODE_HELP;
+    static flags = {
+        verbose: Flags.boolean({
+            description: "Show the evidence behind every check, not only the failing ones.",
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(Doctor);
+        const profile = this.loadProfile(flags.profile, false, flags.product);
+        const report = await runDoctor({ profile });
+        if (flags.json) {
+            this.log(renderJson(buildEnvelope({
+                command: "doctor",
+                profile,
+                data: doctorJsonData(report),
+                problems: doctorProblems(report),
+            })));
+            if (report.blocking > 0)
+                this.exit(EXIT.DIAGNOSTIC_BLOCKED);
+            return;
+        }
+        const brand = renderBrand({ profile: profile.kind, root: profile.root });
+        if (brand)
+            this.log(brand);
+        this.log(renderDoctorReport(report, flags.verbose));
+        this.log("");
+        // AR: **إعلانٌ عابر عن نسخةٍ أحدث من الواجهة** (٠٢٦/FR-«يُعلَن بلا إلحاح»).
+        //
+        //     موضعه ‎doctor‎ وحده لا كلّ أمر: هذا هو الأمر الذي يُنادى حين يبحث الفنّي عن خلل، وهو
+        //     الموضع الذي يُقرأ فيه سطرٌ إضافيّ. وإعلانٌ في كل أمرٍ يصير ضجيجًا يُتخطّى بالعين.
+        //
+        //     **ولا يُعطّل شيئًا ولا يغيّر رمز الخروج.** السؤال بمهلة ثانيتين، وفشله صامتٌ تمامًا:
+        //     جهازٌ في استراحةٍ بلا إنترنت يجب أن يشخّص نفسه كاملًا، وتحديثٌ لم يُسأل عنه ليس عطلًا.
+        //
+        //     ويُطبَع **بعد** التقرير لا قبله: ما جاء الفنّي لأجله يسبق ما لم يطلبه.
+        // EN: **A passing notice that a newer CLI exists** (026).
+        //
+        //     It belongs to `doctor` alone rather than to every command: this is the command run when a
+        //     technician is looking for something wrong, and it is where an extra line gets read. A
+        //     notice on every command becomes noise the eye skips.
+        //
+        //     **It blocks nothing and changes no exit code.** The question carries a two-second timeout
+        //     and fails in complete silence: an appliance in a rest-house with no internet must diagnose
+        //     itself fully, and an update nobody asked about is not a fault.
+        //
+        //     And it prints **after** the report, never before: what the technician came for precedes
+        //     what they did not ask for.
+        const published = await latestPublished();
+        if (published?.newer) {
+            this.log("");
+            this.log(c.dim(`a newer CLI is published: ${published.version} — fantastic self-update`));
+        }
+        // رمز مميّز عن الفشل العام: التشخيص **نجح** ووجد مشكلة، وهما حالتان مختلفتان لسكربت البوّابة.
+        if (report.blocking > 0)
+            this.exit(EXIT.DIAGNOSTIC_BLOCKED);
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/health.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from "../base-command.js";
+export default class Health extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        interval: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        once: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private printSnapshot;
+}
+//# sourceMappingURL=health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/commands/health.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAiBjD,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,WAAW;IAC7C,MAAM,CAAC,WAAW,SAA6E;IAE/F,MAAM,CAAC,QAAQ,WAIb;IAEF,MAAM,CAAC,KAAK;;;MAGV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAgE1B,OAAO,CAAC,aAAa;CAwCtB"}

package/dist/commands/health.js

@@ -0,0 +1,109 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand } from "../base-command.js";
+import { fetchInternalHealth, fetchLicenseStatus } from "../probes/internal.client.js";
+import { renderLicenceCard } from "../render/licence.render.js";
+import { inspectServices } from "../supervisor/inspect.js";
+import { buildEnvelope, renderJson } from "../render/json.js";
+import { c, glyph, isTty } from "../render/theme.js";
+import { EXIT } from "../exit-codes.js";
+// AR: لوحة الصحة. ‎Ink‎ يُستورَد **كسولًا** داخل المسار الذي يحتاجه وحده: هو أثقل اعتمادية في
+//     الـ CLI (يجرّ React)، وتحميله عند كل ‎status‎ أو ‎logs‎ ثمنٌ بلا مقابل.
+//     خارج الطرفية أو مع ‎--once‎ أو ‎--json‎ لا لوحة أصلًا: لقطة واحدة تُطبع وتنتهي.
+// EN: The health panel. Ink is imported **lazily**, inside the one path that needs it: it is the
+//     heaviest dependency in the CLI (it pulls React), and loading it on every `status` or `logs` is
+//     a cost with no return.
+//     Outside a terminal, or with --once or --json, there is no panel at all: one snapshot prints
+//     and the command ends.
+export default class Health extends BaseCommand {
+    static description = "Show a live panel of services, transcoding, streams, library and drives";
+    static examples = [
+        "<%= config.bin %> health",
+        "<%= config.bin %> health --once",
+        "<%= config.bin %> health --json",
+    ];
+    static flags = {
+        interval: Flags.integer({ description: "Seconds between refreshes.", default: 2 }),
+        once: Flags.boolean({ description: "Print one snapshot instead of a live panel.", default: false }),
+    };
+    async run() {
+        const { flags } = await this.parse(Health);
+        const profile = this.loadProfile(flags.profile, false, flags.product);
+        // مسار اللقطة الواحدة: يخدم ‎--json‎ و‎--once‎ وأي مخرَج غير طرفيّ.
+        if (flags.json || flags.once || !isTty) {
+            const [services, health, licence] = await Promise.all([
+                inspectServices(profile),
+                fetchInternalHealth(profile),
+                fetchLicenseStatus(profile),
+            ]);
+            const device = licence.ok ? licence.data : null;
+            if (flags.json) {
+                this.log(renderJson(buildEnvelope({
+                    command: "health",
+                    profile,
+                    data: {
+                        services: services.map((state) => ({
+                            name: state.definition.name,
+                            running: state.running,
+                            port: state.definition.port,
+                            uptimeSeconds: state.uptimeSeconds ?? null,
+                        })),
+                        snapshot: health.ok ? health.data : null,
+                        licence: device,
+                    },
+                    problems: health.ok
+                        ? []
+                        : [
+                            {
+                                id: "core.unreachable",
+                                severity: "fail",
+                                message: `the core is not reachable: ${health.reason}`,
+                                remedy: "Start it: fantastic start",
+                            },
+                        ],
+                })));
+                if (!health.ok)
+                    this.exit(EXIT.UNREACHABLE);
+                return;
+            }
+            this.printSnapshot(services, health, device);
+            if (!health.ok)
+                this.exit(EXIT.UNREACHABLE);
+            return;
+        }
+        const [{ render }, React, { HealthPanel }] = await Promise.all([
+            import("ink"),
+            import("react"),
+            import("../ui/health-panel.js"),
+        ]);
+        const instance = render(React.createElement(HealthPanel, { profile, intervalMs: Math.max(1, flags.interval) * 1_000 }));
+        await instance.waitUntilExit();
+    }
+    printSnapshot(services, health, device) {
+        this.log("");
+        for (const state of services) {
+            const mark = state.running ? c.ok("●") : c.bad("○");
+            this.log(` ${mark} ${state.definition.label.padEnd(16)} ${c.dim(`:${state.definition.port}`)}`);
+        }
+        if (!health.ok) {
+            this.log("");
+            this.log(c.bad(`core unreachable — ${health.reason}`));
+            this.log(`${c.accent(glyph.arrow)} Start it: fantastic start`);
+            return;
+        }
+        const snapshot = health.data;
+        const dash = c.dim("—");
+        this.log("");
+        this.log(` ${c.dim("Transcode".padEnd(16))} ${snapshot.transcode ? `${snapshot.transcode.running} / ${snapshot.transcode.capacity}` : dash}`);
+        this.log(` ${c.dim("Active streams".padEnd(16))} ${snapshot.streams ? snapshot.streams.active : dash}`);
+        this.log(` ${c.dim("Library".padEnd(16))} ${snapshot.library ? `${snapshot.library.titles} titles` : dash}`);
+        for (const drive of snapshot.drives ?? []) {
+            const mark = drive.present ? c.ok("●") : c.bad("○");
+            this.log(` ${mark} ${(drive.mountPath ?? "?").padEnd(15)} ${c.dim(drive.label || "(no label)")}`);
+        }
+        // كتلة الرخصة كاملة (P4.4): الحالة والانتهاء والسقف وبصمة الجهاز.
+        this.log("");
+        this.log(renderLicenceCard(device));
+        this.log("");
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/commands/health.js.map

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