@mudah-cli/mudah 0.7.0 → 0.9.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mudah Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,70 @@
+# @mudah-cli/mudah
+
+*An ergonomic, animation-rich CLI framework* for the modern terminal. This is the umbrella
+package: one dependency that wires the whole stack together with `run()`, command
+auto-discovery, providers, and 26 built-in commands.
+
+## Install
+
+```sh
+npm install @mudah-cli/mudah
+```
+
+Or scaffold a complete app:
+
+```sh
+npm create @mudah-cli/mudah my-app
+```
+
+## Usage
+
+An app's `bin/<name>` stub is three lines:
+
+```js
+#!/usr/bin/env node
+import { run } from '@mudah-cli/mudah';
+process.exitCode = await run();
+```
+
+Commands are one file each, default-exporting a `Command`:
+
+```ts
+// src/commands/deploy.command.ts
+import { Command } from '@mudah-cli/mudah';
+
+export default class DeployCommand extends Command {
+  signature = 'deploy {branch?} [--force]';
+  description = 'Deploy the application';
+
+  async handle(): Promise<number> {
+    this.output.section(`Deploying ${this.arg('branch') ?? 'main'}`);
+    this.output.success('Deployed.');
+    return 0;
+  }
+}
+```
+
+Subpaths keep imports focused:
+
+| Import | Contents |
+| --- | --- |
+| `@mudah-cli/mudah` | `run()`, `Command`, `Application`, `ServiceProvider`, config, terminal |
+| `@mudah-cli/mudah/tui` | `Program`, `Screen`, `Column`, `Row`, `Split`, widgets |
+| `@mudah-cli/mudah/testing` | `TestApp`, `TestTui` |
+| `@mudah-cli/mudah/ui` | `Output`, themes, tables, panels, markdown |
+| `@mudah-cli/mudah/terminal` | capability detection, OSC, key/mouse parsing |
+| `@mudah-cli/mudah/animation` | `Spinner`, `ProgressBar`, `TaskRunner` |
+
+Every app ships with `help`, `version`, `make`, `build`, `doctor`, `dev`, `watch`, `test`,
+`config:*`, `plugins:*`, and more — see the
+[full list](https://github.com/thesimonharms/mudah#built-in-commands). Global flags: `--json`,
+`--plain`, `--profile`, `--timeout`, `--memory`, `--headless`, `--trace`, `--a11y-tree`,
+`--autocomplete`.
+
+Requires Node ≥ 26 (or Bun). Zero third-party runtime dependencies.
+
+## Links
+
+- [Full documentation](https://github.com/thesimonharms/mudah#readme)
+- [llms.txt](https://github.com/thesimonharms/mudah/blob/main/llms.txt) — compact agent reference
+- [License: MIT](LICENSE)

package/dist/autocomplete.d.ts

@@ -0,0 +1,8 @@
+/** Shells that `--autocomplete` / `autocomplete` can emit a script for. */
+export type AutocompleteShell = 'bash' | 'zsh' | 'fish';
+export declare function normalizeAutocompleteShell(value: string | undefined): AutocompleteShell;
+/**
+ * Emit a shell integration script that calls `<bin> complete` so the
+ * kernel's {@link ConsoleKernel.complete} results drive tab completion.
+ */
+export declare function renderAutocompleteScript(bin: string, shell?: AutocompleteShell): string;

package/dist/autocomplete.js

@@ -0,0 +1,38 @@
+export function normalizeAutocompleteShell(value) {
+    if (value === 'zsh' || value === 'fish' || value === 'bash')
+        return value;
+    return 'bash';
+}
+/**
+ * Emit a shell integration script that calls `<bin> complete` so the
+ * kernel's {@link ConsoleKernel.complete} results drive tab completion.
+ */
+export function renderAutocompleteScript(bin, shell = 'bash') {
+    const name = bin.length > 0 ? bin : 'mudah';
+    if (shell === 'zsh') {
+        return `#compdef ${name}
+# Mudah zsh completion — calls \`${name} complete\`
+_${name}_complete() {
+  local -a opts
+  opts=(\${(f)"$(\${words[1]} complete -- \${words[2,-1]} 2>/dev/null)"})
+  _describe 'commands' opts
+}
+_${name}_complete
+`;
+    }
+    if (shell === 'fish') {
+        return `# Mudah fish completion — calls \`${name} complete\`
+complete -c ${name} -f -a '(${name} complete (commandline -opc)[2..-1])'
+`;
+    }
+    return `# Mudah bash completion — calls \`${name} complete\`
+_${name}_complete() {
+  local cur="\${COMP_WORDS[COMP_CWORD]}"
+  local words
+  words="$(\${COMP_WORDS[0]} complete -- "\${COMP_WORDS[@]:1}" 2>/dev/null)"
+  COMPREPLY=($(compgen -W "\${words}" -- "\${cur}"))
+}
+complete -F _${name}_complete ${name}
+`;
+}
+//# sourceMappingURL=autocomplete.js.map

package/dist/autocomplete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autocomplete.js","sourceRoot":"","sources":["../src/autocomplete.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,0BAA0B,CAAC,KAAyB;IAClE,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAW,EAAE,KAAK,GAAsB,MAAM;IACrF,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;IAC5C,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QACpB,OAAO,YAAY,IAAI;mCACQ,IAAI;GACpC,IAAI;;;;;GAKJ,IAAI;CACN,CAAC;IACA,CAAC;IACD,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO,qCAAqC,IAAI;cACtC,IAAI,YAAY,IAAI;CACjC,CAAC;IACA,CAAC;IACD,OAAO,qCAAqC,IAAI;GAC/C,IAAI;;;;;;eAMQ,IAAI,aAAa,IAAI;CACnC,CAAC;AACF,CAAC"}

package/dist/built-ins.d.ts

@@ -0,0 +1,9 @@
+import { type ConsoleKernel } from '@mudah-cli/console';
+/** First argv token that is not a flag. Used to load `watch`/`dev` targets. */
+export declare function firstNonFlag(tokens: readonly string[]): string | undefined;
+/**
+ * Register framework commands the current argv needs.
+ * Help and completion load every remaining name. A normal command loads
+ * only that name (and `watch`/`dev` also load their target).
+ */
+export declare function registerWantedFrameworkBuiltIns(kernel: ConsoleKernel, seen: Set<string>, argv: readonly string[], listing: boolean): Promise<void>;

package/dist/built-ins.js

@@ -0,0 +1,144 @@
+import { parseSignature } from '@mudah-cli/console';
+function wrapDefault(load) {
+    return async () => load();
+}
+const FRAMEWORK_BUILTINS = [
+    { name: 'make', load: wrapDefault(() => import('./commands/make.command.js')) },
+    { name: 'build', load: wrapDefault(() => import('./commands/build.command.js')) },
+    { name: 'doctor', load: wrapDefault(() => import('./commands/doctor.command.js')) },
+    { name: 'config:show', load: wrapDefault(() => import('./commands/config.show.command.js')) },
+    { name: 'config:diff', load: wrapDefault(() => import('./commands/config.diff.command.js')) },
+    { name: 'info', load: wrapDefault(() => import('./commands/info.command.js')) },
+    { name: 'config:set', load: wrapDefault(() => import('./commands/config.set.command.js')) },
+    { name: 'config:source', load: wrapDefault(() => import('./commands/config.source.command.js')) },
+    { name: 'config:validate', load: wrapDefault(() => import('./commands/config.validate.command.js')) },
+    {
+        name: 'dev',
+        load: async (kernel) => {
+            const { default: DevCommand } = await import('./commands/dev.command.js');
+            return {
+                default: class extends DevCommand {
+                    constructor() {
+                        super(kernel);
+                    }
+                },
+            };
+        },
+    },
+    { name: 'plugins:list', load: wrapDefault(() => import('./commands/plugins.list.command.js')) },
+    { name: 'plugins:update', load: wrapDefault(() => import('./commands/plugins.update.command.js')) },
+    { name: 'plugins:watch', load: wrapDefault(() => import('./commands/plugins.watch.command.js')) },
+    { name: 'cache', load: wrapDefault(() => import('./commands/cache.command.js')) },
+    { name: 'telemetry', load: wrapDefault(() => import('./commands/telemetry.command.js')) },
+    { name: 'graph', load: wrapDefault(() => import('./commands/graph.command.js')) },
+    { name: 'autocomplete', load: wrapDefault(() => import('./commands/autocomplete.command.js')) },
+    {
+        name: 'complete',
+        load: async (kernel) => {
+            const { default: CompleteCommand } = await import('./commands/complete.command.js');
+            return {
+                default: class extends CompleteCommand {
+                    constructor() {
+                        super(kernel);
+                    }
+                },
+            };
+        },
+    },
+    {
+        name: 'watch',
+        load: async (kernel) => {
+            const { default: WatchCommand } = await import('./commands/watch.command.js');
+            return {
+                default: class extends WatchCommand {
+                    constructor() {
+                        super(kernel);
+                    }
+                },
+            };
+        },
+    },
+    { name: 'tutorial', load: wrapDefault(() => import('./commands/tutorial.command.js')) },
+    { name: 'lsp', load: wrapDefault(() => import('./commands/lsp.command.js')) },
+    { name: 'replay', load: wrapDefault(() => import('./commands/replay.command.js')) },
+    { name: 'test', load: wrapDefault(() => import('./commands/test.command.js')) },
+    { name: 'storybook', load: wrapDefault(() => import('./commands/storybook.command.js')) },
+    { name: 'docs:widgets', load: wrapDefault(() => import('./commands/docs.widgets.command.js')) },
+];
+const VALUE_FLAGS = new Set(['--debounce', '--speed', '--cols', '--rows', '--format', '--to']);
+/** First argv token that is not a flag. Used to load `watch`/`dev` targets. */
+export function firstNonFlag(tokens) {
+    for (let i = 0; i < tokens.length; i++) {
+        const token = tokens[i];
+        if (token.startsWith('--') && token.includes('='))
+            continue;
+        if (token.startsWith('-')) {
+            if (VALUE_FLAGS.has(token))
+                i += 1;
+            continue;
+        }
+        return token;
+    }
+    return undefined;
+}
+function nameTaken(seen, name) {
+    if (seen.has(name))
+        return true;
+    const prefix = `${name}:`;
+    for (const existing of seen) {
+        if (existing.startsWith(prefix))
+            return true;
+    }
+    return false;
+}
+function registerIfFree(kernel, seen, module) {
+    try {
+        const name = parseSignature(new module.default().signature ?? '').name;
+        if (name === '' || nameTaken(seen, name))
+            return;
+        seen.add(name);
+        kernel.register(module);
+    }
+    catch {
+        // Signature-less modules are skipped; kernel.register throws elsewhere.
+    }
+}
+async function registerMatching(kernel, seen, token) {
+    for (const spec of FRAMEWORK_BUILTINS) {
+        if (spec.name !== token && !spec.name.startsWith(`${token}:`))
+            continue;
+        if (nameTaken(seen, spec.name))
+            continue;
+        registerIfFree(kernel, seen, await spec.load(kernel));
+    }
+}
+async function registerAllFrameworkBuiltIns(kernel, seen) {
+    for (const spec of FRAMEWORK_BUILTINS) {
+        if (nameTaken(seen, spec.name))
+            continue;
+        registerIfFree(kernel, seen, await spec.load(kernel));
+    }
+}
+/**
+ * Register framework commands the current argv needs.
+ * Help and completion load every remaining name. A normal command loads
+ * only that name (and `watch`/`dev` also load their target).
+ */
+export async function registerWantedFrameworkBuiltIns(kernel, seen, argv, listing) {
+    if (listing) {
+        await registerAllFrameworkBuiltIns(kernel, seen);
+        return;
+    }
+    const first = argv[0];
+    if (first === undefined) {
+        await registerAllFrameworkBuiltIns(kernel, seen);
+        return;
+    }
+    await registerMatching(kernel, seen, first);
+    if (first === 'watch' || first === 'dev') {
+        const target = firstNonFlag(argv.slice(1));
+        if (target !== undefined)
+            await registerMatching(kernel, seen, target);
+    }
+}
+//# sourceMappingURL=built-ins.js.map

package/dist/built-ins.js.map

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

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

@@ -0,0 +1,11 @@
+import { Command } from '@mudah-cli/console';
+/**
+ * Built-in `autocomplete` — print a bash/zsh/fish completion script
+ * that calls `<bin> complete`.
+ */
+export default class AutocompleteCommand extends Command {
+    signature: string;
+    description: string;
+    descriptionKey: string;
+    handle(): Promise<void>;
+}

package/dist/commands/autocomplete.command.js

@@ -0,0 +1,16 @@
+import { Command } from '@mudah-cli/console';
+import { normalizeAutocompleteShell, renderAutocompleteScript } from '../autocomplete.js';
+/**
+ * Built-in `autocomplete` — print a bash/zsh/fish completion script
+ * that calls `<bin> complete`.
+ */
+export default class AutocompleteCommand extends Command {
+    signature = 'autocomplete {shell=bash}';
+    description = 'Emit a shell completion script';
+    descriptionKey = 'cmd.autocomplete.description';
+    async handle() {
+        const shell = normalizeAutocompleteShell(String(this.arg('shell') ?? 'bash'));
+        this.output.raw(renderAutocompleteScript(this.app.manifest.bin, shell));
+    }
+}
+//# sourceMappingURL=autocomplete.command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"autocomplete.command.js","sourceRoot":"","sources":["../../src/commands/autocomplete.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE1F;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,OAAO;IACtD,SAAS,GAAG,2BAA2B,CAAC;IACxC,WAAW,GAAG,gCAAgC,CAAC;IAC/C,cAAc,GAAG,8BAA8B,CAAC;IAEhD,KAAK,CAAC,MAAM;QACV,MAAM,KAAK,GAAG,0BAA0B,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC;QAC9E,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IAC1E,CAAC;CACF"}

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

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

package/dist/commands/build.command.js

@@ -1,5 +1,5 @@
-import { readFile } from 'node:fs/promises';
 import { spawn } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
 import { Command } from '@mudah-cli/console';
 function runChild(command, args, cwd) {
     return new Promise((resolve) => {
@@ -15,6 +15,7 @@ function runChild(command, args, cwd) {
 export default class BuildCommand extends Command {
     signature = 'build';
     description = 'Build the application (runs the package.json build script)';
+    descriptionKey = 'cmd.build.description';
     async handle() {
         const pkgPath = `${this.app.basePath}/package.json`;
         let pkg;

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

@@ -1 +1 @@
-{"version":3,"file":"build.command.js","sourceRoot":"","sources":["../../src/commands/build.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,SAAS,QAAQ,CAAC,OAAe,EAAE,IAAc,EAAE,GAAW;IAC5D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAC9D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,OAAO;IAC/C,SAAS,GAAG,OAAO,CAAC;IACpB,WAAW,GAAG,4DAA4D,CAAC;IAE3E,KAAK,CAAC,MAAM;QACV,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,eAAe,CAAC;QACpD,IAAI,GAAyC,CAAC;QAC9C,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,CAAC,UAAU,CAAC,6CAA6C,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;YACvE,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,MAAM,YAAY,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzE,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;YACvC,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,IAAI,GAAG,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
+{"version":3,"file":"build.command.js","sourceRoot":"","sources":["../../src/commands/build.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,SAAS,QAAQ,CAAC,OAAe,EAAE,IAAc,EAAE,GAAW;IAC5D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAC9D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,OAAO;IAC/C,SAAS,GAAG,OAAO,CAAC;IACpB,WAAW,GAAG,4DAA4D,CAAC;IAC3E,cAAc,GAAG,uBAAuB,CAAC;IAEzC,KAAK,CAAC,MAAM;QACV,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,eAAe,CAAC;QACpD,IAAI,GAAyC,CAAC;QAC9C,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,CAAC,UAAU,CAAC,6CAA6C,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;YACvE,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,MAAM,YAAY,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzE,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;YACvC,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,IAAI,GAAG,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

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

@@ -0,0 +1,11 @@
+import { Command } from '@mudah-cli/console';
+/**
+ * Built-in `cache` — list or clear `.mudah/cache/` and mention the
+ * update-check cache directory from {@link defaultCacheDir}.
+ */
+export default class CacheCommand extends Command {
+    signature: string;
+    description: string;
+    descriptionKey: string;
+    handle(): Promise<void>;
+}

package/dist/commands/cache.command.js

@@ -0,0 +1,47 @@
+import { mkdirSync, readdirSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { Command } from '@mudah-cli/console';
+import { defaultCacheDir, t } from '@mudah-cli/core';
+/**
+ * Built-in `cache` — list or clear `.mudah/cache/` and mention the
+ * update-check cache directory from {@link defaultCacheDir}.
+ */
+export default class CacheCommand extends Command {
+    signature = 'cache {action=ls}';
+    description = 'List or clear the local Mudah cache';
+    descriptionKey = 'cmd.cache.description';
+    async handle() {
+        const action = String(this.arg('action') ?? 'ls');
+        if (action !== 'ls' && action !== 'clear') {
+            throw this.usageError(`Unknown cache action "${action}".`, 'Use ls or clear.');
+        }
+        const appCache = join(this.app.basePath, '.mudah', 'cache');
+        const updateCache = defaultCacheDir();
+        if (action === 'clear') {
+            rmSync(appCache, { recursive: true, force: true });
+            mkdirSync(appCache, { recursive: true });
+            this.output.success(`Cleared ${appCache}`);
+            return;
+        }
+        this.output.section('Cache');
+        this.output.keyValue('app', appCache);
+        this.output.keyValue('updates', updateCache);
+        const entries = listDir(appCache);
+        if (entries.length === 0) {
+            this.output.info(t('cache.empty'));
+            return;
+        }
+        for (const name of entries) {
+            this.output.bullet(name);
+        }
+    }
+}
+function listDir(dir) {
+    try {
+        return readdirSync(dir).sort();
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=cache.command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.command.js","sourceRoot":"","sources":["../../src/commands/cache.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,CAAC,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,OAAO;IAC/C,SAAS,GAAG,mBAAmB,CAAC;IAChC,WAAW,GAAG,qCAAqC,CAAC;IACpD,cAAc,GAAG,uBAAuB,CAAC;IAEzC,KAAK,CAAC,MAAM;QACV,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;QAClD,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YAC1C,MAAM,IAAI,CAAC,UAAU,CAAC,yBAAyB,MAAM,IAAI,EAAE,kBAAkB,CAAC,CAAC;QACjF,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC5D,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;QAEtC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,QAAQ,EAAE,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;YACnC,OAAO;QACT,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF;AAED,SAAS,OAAO,CAAC,GAAW;IAC1B,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,13 @@
+import { Command, type ConsoleKernel } from '@mudah-cli/console';
+/**
+ * Built-in `complete` — print tab-completion candidates for a partial argv.
+ * Shell integration scripts (`--autocomplete`) call this.
+ */
+export default class CompleteCommand extends Command {
+    signature: string;
+    description: string;
+    descriptionKey: string;
+    private kernel;
+    constructor(kernel: ConsoleKernel);
+    handle(): Promise<void>;
+}

package/dist/commands/complete.command.js

@@ -0,0 +1,23 @@
+import { Command } from '@mudah-cli/console';
+/**
+ * Built-in `complete` — print tab-completion candidates for a partial argv.
+ * Shell integration scripts (`--autocomplete`) call this.
+ */
+export default class CompleteCommand extends Command {
+    signature = 'complete {line?}';
+    description = 'Print tab-completion candidates';
+    descriptionKey = 'cmd.complete.description';
+    kernel;
+    constructor(kernel) {
+        super();
+        this.kernel = kernel;
+    }
+    async handle() {
+        const line = this.arg('line');
+        const argv = line === undefined || line === '' ? [] : String(line).split(/\s+/);
+        const candidates = this.kernel.complete(argv);
+        if (candidates.length > 0)
+            this.output.raw(candidates.join('\n'));
+    }
+}
+//# sourceMappingURL=complete.command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"complete.command.js","sourceRoot":"","sources":["../../src/commands/complete.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAsB,MAAM,oBAAoB,CAAC;AAEjE;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,OAAO;IAClD,SAAS,GAAG,kBAAkB,CAAC;IAC/B,WAAW,GAAG,iCAAiC,CAAC;IAChD,cAAc,GAAG,0BAA0B,CAAC;IAEpC,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,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChF,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACpE,CAAC;CACF"}

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

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

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

@@ -0,0 +1,96 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { isPlainObject, redactSecrets } from '@mudah-cli/config';
+import { Command } from '@mudah-cli/console';
+const MASK = '[redacted]';
+/** Flatten an object into dot-path -> stringified leaf values. */
+function flatten(value, prefix = '') {
+    const out = {};
+    if (isPlainObject(value)) {
+        for (const [key, val] of Object.entries(value)) {
+            const path = prefix ? `${prefix}.${key}` : key;
+            if (isPlainObject(val))
+                Object.assign(out, flatten(val, path));
+            else
+                out[path] = Array.isArray(val) ? JSON.stringify(val) : String(val);
+        }
+    }
+    return out;
+}
+/** Compare two flattened configs into added/removed/changed buckets. */
+function diffFlat(base, current) {
+    const added = {};
+    const removed = {};
+    const changed = {};
+    for (const key of new Set([...Object.keys(base), ...Object.keys(current)])) {
+        const inBase = key in base;
+        const inCurrent = key in current;
+        if (inCurrent && !inBase)
+            added[key] = current[key];
+        else if (!inCurrent && inBase)
+            removed[key] = base[key];
+        else if (base[key] !== current[key])
+            changed[key] = { from: base[key], to: current[key] };
+    }
+    return { added, removed, changed };
+}
+function renderDiff(diff) {
+    const lines = [];
+    for (const key of Object.keys(diff.removed).sort())
+        lines.push(`- ${key} = ${diff.removed[key]}`);
+    for (const key of Object.keys(diff.added).sort())
+        lines.push(`+ ${key} = ${diff.added[key]}`);
+    for (const key of Object.keys(diff.changed).sort()) {
+        lines.push(`~ ${key}: ${diff.changed[key].from} -> ${diff.changed[key].to}`);
+    }
+    return lines;
+}
+/** Built-in `config:diff {baseline?}` command. */
+export default class ConfigDiffCommand extends Command {
+    signature = 'config:diff {baseline?}';
+    description = 'Diff current config against a baseline JSON file (secrets are redacted)';
+    descriptionKey = 'cmd.config.diff.description';
+    async handle() {
+        const cfg = this.app.config();
+        const current = redactSecrets(cfg.all(), { mask: MASK });
+        const baselinePath = this.arg('baseline');
+        let baseline;
+        if (baselinePath !== undefined) {
+            const resolved = resolve(this.app.basePath, baselinePath);
+            let raw;
+            try {
+                raw = readFileSync(resolved, 'utf8');
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                this.output.error(`Could not read baseline "${baselinePath}": ${message}`);
+                return 1;
+            }
+            try {
+                baseline = JSON.parse(raw);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                this.output.error(`Baseline "${baselinePath}" is not valid JSON: ${message}`);
+                return 1;
+            }
+        }
+        else {
+            baseline = {};
+        }
+        const diff = diffFlat(flatten(redactSecrets(baseline, { mask: MASK })), flatten(current));
+        if (this.output.isMachineReadable) {
+            this.output.emit('data', 'config', diff);
+            return;
+        }
+        if (Object.keys(diff.added).length === 0 &&
+            Object.keys(diff.removed).length === 0 &&
+            Object.keys(diff.changed).length === 0) {
+            this.output.success('Config matches the baseline.');
+            return;
+        }
+        this.output.raw(`${renderDiff(diff).join('\n')}\n`);
+        return 0;
+    }
+}
+//# sourceMappingURL=config.diff.command.js.map

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

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

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

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