@mudah-cli/mudah 0.8.0 → 0.9.2

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

@@ -0,0 +1,66 @@
+import { schemaAt, validateSchema } from '@mudah-cli/config';
+import { Command } from '@mudah-cli/console';
+/** Built-in `config:set {key} {value}` command. */
+export default class ConfigSetCommand extends Command {
+    signature = 'config:set {key} {value}';
+    description = 'Set a config value (dotted key)';
+    descriptionKey = 'cmd.config.set.description';
+    async handle() {
+        const key = this.arg('key');
+        const value = this.arg('value');
+        if (!key || value === undefined) {
+            this.output.error('Usage: config:set {key} {value}');
+            return 1;
+        }
+        // Best-effort coercion: numbers/booleans/JSON literals become their typed
+        // form so `config:set app.port 8080` doesn't store the string "8080".
+        const coerced = coerceLiteral(value);
+        const schema = this.app.config().schema;
+        if (schema !== undefined) {
+            const node = schemaAt(schema, key);
+            if (node === undefined) {
+                this.output.error(`Unknown config key "${key}".`);
+                this.output.hint('Only keys declared in the bound schema can be set.');
+                return 1;
+            }
+            const result = validateSchema(node, coerced, key);
+            if (!result.ok) {
+                this.output.error(`Invalid value for ${key}:`);
+                for (const issue of result.issues) {
+                    this.output.hint(`${issue.path || key}: ${issue.message}`);
+                }
+                return 1;
+            }
+        }
+        this.app.config().set(key, coerced);
+        if (this.output.isMachineReadable) {
+            this.output.emit('data', 'config', { key, value: coerced });
+        }
+        else {
+            this.output.success(`Set ${key} = ${JSON.stringify(coerced)}`);
+        }
+        return 0;
+    }
+}
+function coerceLiteral(raw) {
+    if (raw === 'true')
+        return true;
+    if (raw === 'false')
+        return false;
+    if (raw === 'null')
+        return null;
+    if (raw === '')
+        return '';
+    if (/^-?\d+$/.test(raw)) {
+        const n = Number(raw);
+        if (Number.isSafeInteger(n))
+            return n;
+    }
+    if (/^-?\d+\.\d+$/.test(raw)) {
+        const n = Number(raw);
+        if (Number.isFinite(n))
+            return n;
+    }
+    return raw;
+}
+//# sourceMappingURL=config.set.command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.set.command.js","sourceRoot":"","sources":["../../src/commands/config.set.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,mDAAmD;AACnD,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,OAAO;IACnD,SAAS,GAAG,0BAA0B,CAAC;IACvC,WAAW,GAAG,iCAAiC,CAAC;IAChD,cAAc,GAAG,4BAA4B,CAAC;IAE9C,KAAK,CAAC,MAAM;QACV,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,GAAG,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACrD,OAAO,CAAC,CAAC;QACX,CAAC;QAED,0EAA0E;QAC1E,sEAAsE;QACtE,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QAErC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC;QACxC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YACnC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC;gBAClD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;gBACvE,OAAO,CAAC,CAAC;YACX,CAAC;YACD,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;YAClD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,GAAG,GAAG,CAAC,CAAC;gBAC/C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;oBAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,GAAG,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC7D,CAAC;gBACD,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;CACF;AAED,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,GAAG,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAClC,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC1B,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/commands/config.show.command.d.ts

@@ -0,0 +1,8 @@
+import { Command } from '@mudah-cli/console';
+/** Built-in `config:show {key?}` command. */
+export default class ConfigShowCommand extends Command {
+    signature: string;
+    description: string;
+    descriptionKey: string;
+    handle(): Promise<1 | undefined>;
+}

package/dist/commands/config.show.command.js

@@ -0,0 +1,38 @@
+import { redactSecrets } from '@mudah-cli/config';
+import { Command } from '@mudah-cli/console';
+/** Built-in `config:show {key?}` command. */
+export default class ConfigShowCommand extends Command {
+    signature = 'config:show {key?}';
+    description = 'Dump configuration (secrets are redacted by default)';
+    descriptionKey = 'cmd.config.show.description';
+    async handle() {
+        const cfg = this.app.config();
+        const key = this.arg('key');
+        const opts = {};
+        if (key) {
+            if (!cfg.has(key)) {
+                this.output.error(`No configuration at key "${key}".`);
+                return 1;
+            }
+            const leaf = key.split('.').pop();
+            const value = cfg.get(key);
+            const redacted = redactSecrets({ [leaf]: value }, opts);
+            const result = redacted[leaf];
+            if (this.output.isMachineReadable) {
+                this.output.emit('data', 'config', { key, value: result });
+            }
+            else {
+                this.output.keyValue(key, JSON.stringify(result));
+            }
+            return;
+        }
+        const tree = redactSecrets(cfg.all(), opts);
+        if (this.output.isMachineReadable) {
+            this.output.emit('data', 'config', tree);
+        }
+        else {
+            this.output.raw(JSON.stringify(tree, null, 2));
+        }
+    }
+}
+//# sourceMappingURL=config.show.command.js.map

package/dist/commands/config.show.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.show.command.js","sourceRoot":"","sources":["../../src/commands/config.show.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,6CAA6C;AAC7C,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,OAAO;IACpD,SAAS,GAAG,oBAAoB,CAAC;IACjC,WAAW,GAAG,sDAAsD,CAAC;IACrE,cAAc,GAAG,6BAA6B,CAAC;IAE/C,KAAK,CAAC,MAAM;QACV,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAkB,EAAE,CAAC;QAE/B,IAAI,GAAG,EAAE,CAAC;YACR,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAAC;gBACvD,OAAO,CAAC,CAAC;YACX,CAAC;YACD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC;YACnC,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC3B,MAAM,QAAQ,GAAG,aAAa,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,CAA4B,CAAC;YACnF,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;gBAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;YACpD,CAAC;YACD,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;CACF"}

package/dist/commands/config.source.command.d.ts

@@ -0,0 +1,8 @@
+import { Command } from '@mudah-cli/console';
+/** Built-in `config:source {key?}` command. */
+export default class ConfigSourceCommand extends Command {
+    signature: string;
+    description: string;
+    descriptionKey: string;
+    handle(): Promise<0 | 1>;
+}

package/dist/commands/config.source.command.js

@@ -0,0 +1,42 @@
+import { formatPrecedence, redactSecrets } from '@mudah-cli/config';
+import { Command } from '@mudah-cli/console';
+/** Built-in `config:source {key?}` command. */
+export default class ConfigSourceCommand extends Command {
+    signature = 'config:source {key?}';
+    description = 'Show which layer a config key resolved from (secrets are redacted)';
+    descriptionKey = 'cmd.config.source.description';
+    async handle() {
+        const cfg = this.app.config();
+        const key = this.arg('key');
+        let rows;
+        if (key) {
+            const source = cfg.source(key);
+            if (source === undefined) {
+                this.output.error(`No configuration at key "${key}".`);
+                return 1;
+            }
+            rows = [{ key, layer: source.layer, value: source.value }];
+        }
+        else {
+            rows = cfg.precedence();
+        }
+        const redacted = rows.map(redactRow);
+        if (this.output.isMachineReadable) {
+            this.output.emit('data', 'config', key ? redacted[0] : redacted);
+            return 0;
+        }
+        const lines = formatPrecedence(redacted);
+        if (lines.length === 0) {
+            this.output.success('No configuration keys recorded.');
+            return 0;
+        }
+        this.output.raw(lines.join('\n'));
+        return 0;
+    }
+}
+function redactRow(row) {
+    const leaf = row.key.split('.').pop();
+    const redacted = redactSecrets({ [leaf]: row.value });
+    return { key: row.key, layer: row.layer, value: redacted[leaf] };
+}
+//# sourceMappingURL=config.source.command.js.map

package/dist/commands/config.source.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.source.command.js","sourceRoot":"","sources":["../../src/commands/config.source.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAsB,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,+CAA+C;AAC/C,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,OAAO;IACtD,SAAS,GAAG,sBAAsB,CAAC;IACnC,WAAW,GAAG,oEAAoE,CAAC;IACnF,cAAc,GAAG,+BAA+B,CAAC;IAEjD,KAAK,CAAC,MAAM;QACV,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAE5B,IAAI,IAAqB,CAAC;QAC1B,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAAC;gBACvD,OAAO,CAAC,CAAC;YACX,CAAC;YACD,IAAI,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;QAC1B,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACjE,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC;YACvD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAClC,OAAO,CAAC,CAAC;IACX,CAAC;CACF;AAED,SAAS,SAAS,CAAC,GAAkB;IACnC,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC;IACvC,MAAM,QAAQ,GAAG,aAAa,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,KAAK,EAAE,CAA4B,CAAC;IACjF,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;AACnE,CAAC"}

package/dist/commands/config.validate.command.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@mudah-cli/console';
+/**
+ * Built-in `config:validate {key?}` command.
+ *
+ * When a schema is bound on `app.config()`, this runs `validateSchema` and
+ * reports every offending key. Without a schema the command falls back to a
+ * shallow walk that flags `undefined` values.
+ */
+export default class ConfigValidateCommand extends Command {
+    signature: string;
+    description: string;
+    descriptionKey: string;
+    handle(): Promise<0 | 1>;
+}

package/dist/commands/config.validate.command.js

@@ -0,0 +1,63 @@
+import { schemaAt, validateSchema } from '@mudah-cli/config';
+import { Command } from '@mudah-cli/console';
+/**
+ * Built-in `config:validate {key?}` command.
+ *
+ * When a schema is bound on `app.config()`, this runs `validateSchema` and
+ * reports every offending key. Without a schema the command falls back to a
+ * shallow walk that flags `undefined` values.
+ */
+export default class ConfigValidateCommand extends Command {
+    signature = 'config:validate {key?}';
+    description = 'Run a schema check against the (current) config tree';
+    descriptionKey = 'cmd.config.validate.description';
+    async handle() {
+        const cfg = this.app.config();
+        const key = this.arg('key');
+        const issues = collectIssues(cfg.schema, cfg.all(), key, (k) => cfg.get(k));
+        if (this.output.isMachineReadable) {
+            this.output.emit('data', 'config', { ok: issues.length === 0, issues });
+        }
+        else if (issues.length === 0) {
+            this.output.success(`Config ${key ?? '(root)'} looks healthy.`);
+        }
+        else {
+            this.output.error(`Found ${issues.length} issue(s):`);
+            for (const issue of issues) {
+                this.output.hint(`${issue.path || '(root)'}: ${issue.message}`);
+            }
+        }
+        return issues.length === 0 ? 0 : 1;
+    }
+}
+function collectIssues(schema, root, key, get) {
+    if (schema !== undefined) {
+        if (key) {
+            const node = schemaAt(schema, key);
+            if (node === undefined)
+                return [{ path: key, message: 'is not a known key' }];
+            return [...validateSchema(node, get(key), key).issues];
+        }
+        return [...validateSchema(schema, root).issues];
+    }
+    const issues = [];
+    const target = key ? get(key) : root;
+    walk(valueFor(target), key ?? '', issues);
+    return issues;
+}
+function valueFor(value) {
+    return value !== null && typeof value === 'object' ? value : {};
+}
+function walk(value, prefix, issues) {
+    if (value === null || typeof value !== 'object')
+        return;
+    if (Array.isArray(value))
+        return;
+    for (const [key, v] of Object.entries(value)) {
+        const path = prefix ? `${prefix}.${key}` : key;
+        if (v === undefined)
+            issues.push({ path, message: 'value is undefined' });
+        walk(v, path, issues);
+    }
+}
+//# sourceMappingURL=config.validate.command.js.map

package/dist/commands/config.validate.command.js.map

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

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

@@ -6,6 +6,7 @@ import { Command, type ConsoleKernel } from '@mudah-cli/console';
 export default class DevCommand extends Command {
     signature: string;
     description: string;
+    descriptionKey: string;
     private kernel;
     constructor(kernel: ConsoleKernel);
     handle(): Promise<void>;

package/dist/commands/dev.command.js

@@ -8,6 +8,7 @@ import { createWatcher } from '../watcher.js';
 export default class DevCommand extends Command {
     signature = 'dev {command}';
     description = 'Watch mode: re-run a command when files change';
+    descriptionKey = 'cmd.dev.description';
     kernel;
     constructor(kernel) {
         super();

package/dist/commands/dev.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev.command.js","sourceRoot":"","sources":["../../src/commands/dev.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAsB,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,OAAO;IAC7C,SAAS,GAAG,eAAe,CAAC;IAC5B,WAAW,GAAG,gDAAgD,CAAC;IAEvD,MAAM,CAAgB;IAE9B,YAAY,MAAqB;QAC/B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,UAAU,CAAC,oBAAoB,MAAM,IAAI,EAAE,kCAAkC,CAAC,CAAC;QAC5F,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;YACxC,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YACvC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,OAAO,EAAE,CAAC;QAEhB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC/B,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE;YACnG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACnD,KAAK,OAAO,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE;gBAC1B,IAAI,EAAE,CAAC;gBACP,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"dev.command.js","sourceRoot":"","sources":["../../src/commands/dev.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAsB,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,OAAO;IAC7C,SAAS,GAAG,eAAe,CAAC;IAC5B,WAAW,GAAG,gDAAgD,CAAC;IAC/D,cAAc,GAAG,qBAAqB,CAAC;IAE/B,MAAM,CAAgB;IAE9B,YAAY,MAAqB;QAC/B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,UAAU,CAAC,oBAAoB,MAAM,IAAI,EAAE,kCAAkC,CAAC,CAAC;QAC5F,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;YACxC,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YACvC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,OAAO,EAAE,CAAC;QAEhB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC/B,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE;YACnG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACnD,KAAK,OAAO,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE;gBAC1B,IAAI,EAAE,CAAC;gBACP,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/commands/docs.widgets.command.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@mudah-cli/console';
+/**
+ * Built-in `docs:widgets` command: print the inspect()-generated
+ * component reference.
+ */
+export default class DocsWidgetsCommand extends Command {
+    signature: string;
+    description: string;
+    descriptionKey: string;
+    handle(): Promise<number>;
+}

package/dist/commands/docs.widgets.command.js

@@ -0,0 +1,17 @@
+import { Command } from '@mudah-cli/console';
+/**
+ * Built-in `docs:widgets` command: print the inspect()-generated
+ * component reference.
+ */
+export default class DocsWidgetsCommand extends Command {
+    signature = 'docs:widgets';
+    description = 'Print the TUI widget reference generated from inspect()';
+    descriptionKey = 'cmd.docs.widgets.description';
+    async handle() {
+        const { widgetReference, widgetReferenceMarkdown } = await import('@mudah-cli/tui');
+        this.output.raw(`${widgetReferenceMarkdown()}\n`);
+        this.output.keyValue('widgets', String(widgetReference().length));
+        return 0;
+    }
+}
+//# sourceMappingURL=docs.widgets.command.js.map

package/dist/commands/docs.widgets.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.widgets.command.js","sourceRoot":"","sources":["../../src/commands/docs.widgets.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,OAAO;IACrD,SAAS,GAAG,cAAc,CAAC;IAC3B,WAAW,GAAG,yDAAyD,CAAC;IACxE,cAAc,GAAG,8BAA8B,CAAC;IAEhD,KAAK,CAAC,MAAM;QACV,MAAM,EAAE,eAAe,EAAE,uBAAuB,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACpF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,uBAAuB,EAAE,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAClE,OAAO,CAAC,CAAC;IACX,CAAC;CACF"}

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

@@ -6,5 +6,6 @@ import { Command } from '@mudah-cli/console';
 export default class DoctorCommand extends Command {
     signature: string;
     description: string;
+    descriptionKey: string;
     handle(): Promise<void>;
 }

package/dist/commands/doctor.command.js

@@ -1,17 +1,27 @@
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { Command } from '@mudah-cli/console';
+import { formatGraph, pluginGraph } from '@mudah-cli/core';
 import { detectCapabilities } from '@mudah-cli/terminal';
-import { Column, Label, List, dumpTree } from '@mudah-cli/tui';
+function binStubPresent(basePath, bin) {
+    const dir = join(basePath, 'bin');
+    return existsSync(join(dir, `${bin}.js`)) || existsSync(join(dir, bin));
+}
 /**
  * Built-in `doctor` command: a quick health check of the runtime, manifest,
  * scaffolding, and terminal capabilities.
  */
 export default class DoctorCommand extends Command {
-    signature = 'doctor';
+    signature = 'doctor [--deps] [--a11y-tree]';
     description = 'Check the runtime, app, and terminal setup';
+    descriptionKey = 'cmd.doctor.description';
     async handle() {
-        const caps = detectCapabilities();
+        const headless = this.app.config().get('mudah.headless') === true;
+        const a11y = this.option('a11y-tree') === true;
+        const caps = detectCapabilities({
+            env: process.env,
+            isTty: headless ? false : undefined,
+        });
         this.output.section('Runtime');
         const nodeMajor = Number(process.versions.node.split('.')[0]);
         if (nodeMajor >= 26) {
@@ -26,12 +36,12 @@ export default class DoctorCommand extends Command {
         this.output.section('Application');
         this.output.keyValue('name', this.app.manifest.name);
         this.output.keyValue('version', this.app.manifest.version);
-        const binDir = join(this.app.basePath, 'bin');
-        if (existsSync(join(binDir, this.app.manifest.bin)) || existsSync(binDir)) {
-            this.output.success(`bin/${this.app.manifest.bin} present`);
+        const bin = this.app.manifest.bin;
+        if (binStubPresent(this.app.basePath, bin)) {
+            this.output.success(`bin/${bin} present`);
         }
         else {
-            this.output.warn(`bin/${this.app.manifest.bin} missing — add the bin stub`);
+            this.output.warn(`bin/${bin}.js missing — add the bin stub`);
         }
         const modules = await this.app.discoverCommandModules();
         if (modules.length > 0) {
@@ -40,6 +50,21 @@ export default class DoctorCommand extends Command {
         else {
             this.output.warn('no commands discovered in src/commands');
         }
+        if (this.option('deps') === true) {
+            this.output.section('Dependencies');
+            const plugins = (typeof this.app.plugins === 'function' ? this.app.plugins() : []);
+            const extra = typeof this.app.providerNames === 'function' ? this.app.providerNames() : [];
+            this.output.raw(formatGraph(pluginGraph(plugins, extra), 'ascii'));
+        }
+        if (typeof this.app.health === 'function') {
+            const report = await this.app.health();
+            if (report.length > 0) {
+                this.output.section('Health');
+                for (const row of report) {
+                    this.output.keyValue(row.provider, `${row.status} (${row.latencyMs}ms)`);
+                }
+            }
+        }
         this.output.section('Terminal');
         this.output.keyValue('brand', caps.brand);
         this.output.keyValue('color', caps.trueColor ? 'truecolor' : caps.colorLevel === 8 ? '256' : caps.colorLevel === 1 ? '16' : 'off');
@@ -47,13 +72,22 @@ export default class DoctorCommand extends Command {
         this.output.keyValue('animations', String(caps.animations));
         this.output.keyValue('notifications', caps.osc9 ? 'osc 9' : 'none');
         this.output.keyValue('semantic prompts', caps.osc133 ? 'osc 133' : 'none');
+        this.output.keyValue('cwd tracking', caps.osc7 ? 'osc 7' : 'none');
         this.output.keyValue('graphics', caps.kittyGraphics ? 'kitty' : 'none');
         this.output.keyValue('keyboard', caps.kittyKeyboard ? 'kitty key-up' : 'legacy');
         this.output.section('TUI');
-        const demo = new Column().add(new Label('demo'), new List(['a', 'b']));
-        demo.resize(40, 8);
-        this.output.keyValue('dump', JSON.stringify(dumpTree(demo)));
-        this.output.hint('Mount a layout and call program.dump() or TestTui.tree()');
+        if (a11y) {
+            const { Column, Label, List, dumpTree } = await import('@mudah-cli/tui');
+            const demo = new Column().add(new Label('demo'), new List(['a', 'b']));
+            demo.resize(40, 8);
+            const tree = dumpTree(demo);
+            this.output.emit('data', 'a11y-tree', tree);
+            if (!this.output.isMachineReadable)
+                this.output.raw(JSON.stringify(tree));
+        }
+        else {
+            this.output.hint('Dump a live tree with doctor --a11y-tree, program.dump(), or TestTui.tree()');
+        }
         this.output.line();
         this.output.success('doctor complete');
     }

package/dist/commands/doctor.command.js.map

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

package/dist/commands/gallery.command.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@mudah-cli/console';
+/**
+ * Built-in `gallery` command: widget gallery. Prints snapshots when not a
+ * TTY. On a TTY, opens a Program: left/right pick a widget, +/− resize.
+ */
+export default class GalleryCommand extends Command {
+    signature: string;
+    description: string;
+    descriptionKey: string;
+    handle(): Promise<number>;
+}

package/dist/commands/gallery.command.js

@@ -0,0 +1,84 @@
+import { Command } from '@mudah-cli/console';
+async function widgets() {
+    const { Calendar, Chart, Checkbox, Column, DatePicker, Label, List, Pager, ProgressBar, Table, Toolbar } = await import('@mudah-cli/tui');
+    return [
+        { name: 'label', build: () => new Column().add(new Label('Label story')) },
+        { name: 'list', build: () => new Column().add(new Label('List story'), new List(['alpha', 'beta'])) },
+        {
+            name: 'toolbar',
+            build: () => new Column().add(new Label('Toolbar story'), new Toolbar({
+                items: [
+                    { id: 'run', label: 'Run' },
+                    { id: 'stop', label: 'Stop' },
+                ],
+            })),
+        },
+        {
+            name: 'checkbox',
+            build: () => new Column().add(new Label('Checkbox story'), new Checkbox({ label: 'enabled', checked: true })),
+        },
+        { name: 'progress', build: () => new Column().add(new Label('Progress story'), new ProgressBar(0.42)) },
+        {
+            name: 'table',
+            build: () => new Column().add(new Label('Table story'), new Table([{ header: 'Host' }, { header: 'State' }], [['db', 'up']])),
+        },
+        {
+            name: 'pager',
+            build: () => new Column().add(new Pager({ title: 'Pager story', lines: ['alpha', 'beta', 'gamma'] })),
+        },
+        {
+            name: 'calendar',
+            build: () => new Column().add(new Label('Calendar story'), new Calendar({ date: new Date('2026-09-01T00:00:00Z') })),
+        },
+        {
+            name: 'datepicker',
+            build: () => new Column().add(new Label('DatePicker story'), new DatePicker({ date: new Date('2026-09-01T00:00:00Z') })),
+        },
+        {
+            name: 'chart',
+            build: () => new Column().add(new Label('Chart story'), new Chart({
+                kind: 'bar',
+                entries: [
+                    { label: 'a', value: 3 },
+                    { label: 'b', value: 1 },
+                ],
+            })),
+        },
+    ];
+}
+/**
+ * Built-in `gallery` command: widget gallery. Prints snapshots when not a
+ * TTY. On a TTY, opens a Program: left/right pick a widget, +/− resize.
+ */
+export default class GalleryCommand extends Command {
+    signature = 'gallery {widget?} [--cols=] [--rows=]';
+    description = 'Open a TUI widget gallery with live resize';
+    descriptionKey = 'cmd.gallery.description';
+    async handle() {
+        const cols = Number(this.option('cols') ?? 40) || 40;
+        const rows = Number(this.option('rows') ?? 8) || 8;
+        const filter = this.arg('widget');
+        const all = await widgets();
+        const shown = filter ? all.filter((entry) => entry.name === filter) : all;
+        if (shown.length === 0) {
+            throw this.usageError(`Unknown widget "${filter}".`, `Known: ${all.map((s) => s.name).join(', ')}`);
+        }
+        const tty = process.stdin.isTTY === true && process.stdout.isTTY === true;
+        if (tty && process.env['VITEST'] === undefined) {
+            const { Program, WidgetGallery } = await import('@mudah-cli/tui');
+            const gallery = new WidgetGallery(shown, cols, rows);
+            const program = new Program();
+            program.mount(gallery);
+            return program.run();
+        }
+        const { renderWidgetToText } = await import('@mudah-cli/tui');
+        this.output.section(`Gallery ${cols}x${rows}`);
+        for (const entry of shown) {
+            this.output.raw(renderWidgetToText(entry.build(cols, rows), cols, rows));
+            this.output.line();
+        }
+        this.output.success('gallery complete');
+        return 0;
+    }
+}
+//# sourceMappingURL=gallery.command.js.map

package/dist/commands/gallery.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gallery.command.js","sourceRoot":"","sources":["../../src/commands/gallery.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,KAAK,UAAU,OAAO;IACpB,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,GACtG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACjC,OAAO;QACL,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE;QAC1E,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE;QACrG;YACE,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,GAAG,EAAE,CACV,IAAI,MAAM,EAAE,CAAC,GAAG,CACd,IAAI,KAAK,CAAC,eAAe,CAAC,EAC1B,IAAI,OAAO,CAAC;gBACV,KAAK,EAAE;oBACL,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;oBAC3B,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;iBAC9B;aACF,CAAC,CACH;SACJ;QACD;YACE,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,GAAG,EAAE,CACV,IAAI,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,EAAE,IAAI,QAAQ,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;SACnG;QACD,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE;QACvG;YACE,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,GAAG,EAAE,CACV,IAAI,MAAM,EAAE,CAAC,GAAG,CACd,IAAI,KAAK,CAAC,aAAa,CAAC,EACxB,IAAI,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CACrE;SACJ;QACD;YACE,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;SACtG;QACD;YACE,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,GAAG,EAAE,CACV,IAAI,MAAM,EAAE,CAAC,GAAG,CACd,IAAI,KAAK,CAAC,gBAAgB,CAAC,EAC3B,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,sBAAsB,CAAC,EAAE,CAAC,CACzD;SACJ;QACD;YACE,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,GAAG,EAAE,CACV,IAAI,MAAM,EAAE,CAAC,GAAG,CACd,IAAI,KAAK,CAAC,kBAAkB,CAAC,EAC7B,IAAI,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAC3D;SACJ;QACD;YACE,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,GAAG,EAAE,CACV,IAAI,MAAM,EAAE,CAAC,GAAG,CACd,IAAI,KAAK,CAAC,aAAa,CAAC,EACxB,IAAI,KAAK,CAAC;gBACR,IAAI,EAAE,KAAK;gBACX,OAAO,EAAE;oBACP,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE;oBACxB,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE;iBACzB;aACF,CAAC,CACH;SACJ;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;IACjD,SAAS,GAAG,uCAAuC,CAAC;IACpD,WAAW,GAAG,4CAA4C,CAAC;IAC3D,cAAc,GAAG,yBAAyB,CAAC;IAE3C,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC1E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,CAAC,UAAU,CAAC,mBAAmB,MAAM,IAAI,EAAE,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtG,CAAC;QAED,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;QAC1E,IAAI,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,CAAC;YAC/C,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAClE,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YACrD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACvB,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;QAC/C,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YACzE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACxC,OAAO,CAAC,CAAC;IACX,CAAC;CACF"}

package/dist/commands/graph.command.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@mudah-cli/console';
+/**
+ * Built-in `graph` — render the plugin/provider DAG as ASCII or DOT.
+ */
+export default class GraphCommand extends Command {
+    signature: string;
+    description: string;
+    descriptionKey: string;
+    handle(): Promise<void>;
+}

package/dist/commands/graph.command.js

@@ -0,0 +1,21 @@
+import { Command } from '@mudah-cli/console';
+import { formatGraph, pluginGraph } from '@mudah-cli/core';
+/**
+ * Built-in `graph` — render the plugin/provider DAG as ASCII or DOT.
+ */
+export default class GraphCommand extends Command {
+    signature = 'graph [--format=ascii]';
+    description = 'Render the provider dependency graph';
+    descriptionKey = 'cmd.graph.description';
+    async handle() {
+        const format = String(this.option('format') ?? 'ascii');
+        if (format !== 'ascii' && format !== 'dot') {
+            throw this.usageError(`Unknown graph format "${format}".`, 'Use ascii or dot.');
+        }
+        const plugins = (typeof this.app.plugins === 'function' ? this.app.plugins() : []);
+        const extra = typeof this.app.providerNames === 'function' ? this.app.providerNames() : [];
+        const graph = pluginGraph(plugins, extra);
+        this.output.raw(formatGraph(graph, format));
+    }
+}
+//# sourceMappingURL=graph.command.js.map

package/dist/commands/graph.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.command.js","sourceRoot":"","sources":["../../src/commands/graph.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAmB,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE5E;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,OAAO;IAC/C,SAAS,GAAG,wBAAwB,CAAC;IACrC,WAAW,GAAG,sCAAsC,CAAC;IACrD,cAAc,GAAG,uBAAuB,CAAC;IAEzC,KAAK,CAAC,MAAM;QACV,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,CAAC;QACxD,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YAC3C,MAAM,IAAI,CAAC,UAAU,CAAC,yBAAyB,MAAM,IAAI,EAAE,mBAAmB,CAAC,CAAC;QAClF,CAAC;QACD,MAAM,OAAO,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAiB,CAAC;QACnG,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3F,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9C,CAAC;CACF"}

package/dist/commands/help.command.d.ts

@@ -5,6 +5,7 @@ import { Command, type ConsoleKernel } from '@mudah-cli/console';
 export default class HelpCommand extends Command {
     signature: string;
     description: string;
+    descriptionKey: string;
     private kernel;
     constructor(kernel: ConsoleKernel);
     handle(): Promise<void>;