@mudah-cli/mudah 0.8.0 → 0.9.2

package/dist/commands/help.command.js

@@ -1,11 +1,11 @@
-import { Command } from '@mudah-cli/console';
-import { renderCommandHelp, renderCommandList } from '@mudah-cli/console';
+import { Command, renderCommandHelp, renderCommandList } from '@mudah-cli/console';
 /**
  * Built-in `help` command: lists all commands, or shows details for one.
  */
 export default class HelpCommand extends Command {
     signature = 'help {command?}';
     description = 'Show help for the CLI or a specific command';
+    descriptionKey = 'cmd.help.description';
     kernel;
     constructor(kernel) {
         super();

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

@@ -1 +1 @@
-{"version":3,"file":"help.command.js","sourceRoot":"","sources":["../../src/commands/help.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAsB,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE1E;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,OAAO;IAC9C,SAAS,GAAG,iBAAiB,CAAC;IAC9B,WAAW,GAAG,6CAA6C,CAAC;IAEpD,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,CAAC,CAAC;QACnC,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACtC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,CAAC,UAAU,CAAC,oBAAoB,MAAM,IAAI,EAAE,kCAAkC,CAAC,CAAC;YAC5F,CAAC;YACD,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;QAClG,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;CACF"}
+{"version":3,"file":"help.command.js","sourceRoot":"","sources":["../../src/commands/help.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAsB,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvG;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,OAAO;IAC9C,SAAS,GAAG,iBAAiB,CAAC;IAC9B,WAAW,GAAG,6CAA6C,CAAC;IAC5D,cAAc,GAAG,sBAAsB,CAAC;IAEhC,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,CAAC,CAAC;QACnC,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACtC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,CAAC,UAAU,CAAC,oBAAoB,MAAM,IAAI,EAAE,kCAAkC,CAAC,CAAC;YAC5F,CAAC;YACD,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;QAClG,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;CACF"}

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

@@ -0,0 +1,8 @@
+import { Command } from '@mudah-cli/console';
+/** Built-in `info` command: dump runtime, app, and config info. */
+export default class InfoCommand extends Command {
+    signature: string;
+    description: string;
+    descriptionKey: string;
+    handle(): Promise<void>;
+}

package/dist/commands/info.command.js

@@ -0,0 +1,61 @@
+import { Command } from '@mudah-cli/console';
+/** Built-in `info` command: dump runtime, app, and config info. */
+export default class InfoCommand extends Command {
+    signature = 'info [--json]';
+    description = 'Show runtime, app, and config information';
+    descriptionKey = 'cmd.info.description';
+    async handle() {
+        const app = this.app;
+        const output = this.output;
+        const plugins = typeof app.plugins === 'function' ? app.plugins() : [];
+        const pluginSummary = plugins.map((plugin) => ({
+            name: plugin.name,
+            providers: plugin.providers.length,
+        }));
+        let health;
+        if (typeof app.health === 'function') {
+            health = await app.health();
+        }
+        if (output.isMachineReadable || this.option('json') === true) {
+            output.emit('data', 'info', {
+                name: app.manifest.name,
+                version: app.manifest.version,
+                node: process.version,
+                plugins: pluginSummary,
+                ...(health === undefined ? {} : { health }),
+            });
+            return;
+        }
+        output.section('Runtime');
+        output.keyValue('node', process.version);
+        output.keyValue('platform', `${process.platform} ${process.arch}`);
+        output.section('Application');
+        output.keyValue('name', app.manifest.name);
+        output.keyValue('version', app.manifest.version);
+        output.keyValue('basePath', app.basePath);
+        output.keyValue('bin', app.manifest.bin);
+        if (pluginSummary.length > 0) {
+            output.section('Plugins');
+            for (const plugin of pluginSummary) {
+                output.keyValue(plugin.name, `${plugin.providers} provider(s)`);
+            }
+        }
+        if (health !== undefined && health.length > 0) {
+            output.section('Health');
+            for (const row of health) {
+                const detail = row.detail ? ` ${row.detail}` : '';
+                output.keyValue(row.provider, `${row.status} (${row.latencyMs}ms)${detail}`);
+            }
+        }
+        const configKeys = Object.keys(app.config().all());
+        if (configKeys.length > 0) {
+            output.section('Configuration');
+            for (const key of configKeys) {
+                output.keyValue(key, String(app.config().get(key)));
+            }
+        }
+        output.line();
+        output.success('info complete');
+    }
+}
+//# sourceMappingURL=info.command.js.map

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

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

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

@@ -0,0 +1,12 @@
+import { Command } from '@mudah-cli/console';
+/**
+ * Built-in `lsp` command: stdio JSON-RPC (Content-Length framed, with a
+ * newline-delimited fallback for probes).
+ */
+export default class LspCommand extends Command {
+    signature: string;
+    description: string;
+    descriptionKey: string;
+    handle(): Promise<number>;
+    private serveStdio;
+}

package/dist/commands/lsp.command.js

@@ -0,0 +1,57 @@
+import { Command } from '@mudah-cli/console';
+import { decodeLspFrames, encodeLspFrame, handleLspMessage, initializeResult, publishDiagnostics, uriOf, } from '../lsp.js';
+/**
+ * Built-in `lsp` command: stdio JSON-RPC (Content-Length framed, with a
+ * newline-delimited fallback for probes).
+ */
+export default class LspCommand extends Command {
+    signature = 'lsp [--stdio] [--probe]';
+    description = 'Language server for mudah.json keys and command signatures';
+    descriptionKey = 'cmd.lsp.description';
+    async handle() {
+        if (this.option('probe') === true) {
+            const ready = initializeResult();
+            this.output.raw(`${JSON.stringify({ jsonrpc: '2.0', id: 1, result: ready })}\n`);
+            return 0;
+        }
+        if (this.option('stdio') === true) {
+            return this.serveStdio();
+        }
+        this.output.success('mudah-lsp ready');
+        this.output.muted('Pass --stdio to speak JSON-RPC on stdin/stdout, or --probe to print initialize.');
+        return 0;
+    }
+    serveStdio() {
+        return new Promise((resolve) => {
+            let buffer = '';
+            const write = (msg) => {
+                process.stdout.write(encodeLspFrame(msg));
+            };
+            process.stdin.setEncoding('utf8');
+            process.stdin.on('data', (chunk) => {
+                buffer += chunk;
+                const decoded = decodeLspFrames(buffer);
+                buffer = decoded.rest;
+                for (const msg of decoded.messages) {
+                    if (msg.method === 'exit') {
+                        resolve(0);
+                        return;
+                    }
+                    const reply = handleLspMessage(msg);
+                    if (reply !== undefined)
+                        write(reply);
+                    if (msg.method === 'textDocument/didOpen' || msg.method === 'textDocument/didChange') {
+                        const notice = publishDiagnostics(uriOf(msg.params));
+                        if (notice !== undefined)
+                            write(notice);
+                    }
+                    if (msg.method === 'shutdown') {
+                        resolve(0);
+                    }
+                }
+            });
+            process.stdin.on('end', () => resolve(0));
+        });
+    }
+}
+//# sourceMappingURL=lsp.command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lsp.command.js","sourceRoot":"","sources":["../../src/commands/lsp.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EACL,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAEhB,kBAAkB,EAClB,KAAK,GACN,MAAM,WAAW,CAAC;AAEnB;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,OAAO;IAC7C,SAAS,GAAG,yBAAyB,CAAC;IACtC,WAAW,GAAG,4DAA4D,CAAC;IAC3E,cAAc,GAAG,qBAAqB,CAAC;IAEvC,KAAK,CAAC,MAAM;QACV,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC;YACjF,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iFAAiF,CAAC,CAAC;QACrG,OAAO,CAAC,CAAC;IACX,CAAC;IAEO,UAAU;QAChB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG,CAAC,GAAe,EAAQ,EAAE;gBACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5C,CAAC,CAAC;YACF,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACzC,MAAM,IAAI,KAAK,CAAC;gBAChB,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;gBACxC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;gBACtB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;oBACnC,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;wBAC1B,OAAO,CAAC,CAAC,CAAC,CAAC;wBACX,OAAO;oBACT,CAAC;oBACD,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;oBACpC,IAAI,KAAK,KAAK,SAAS;wBAAE,KAAK,CAAC,KAAK,CAAC,CAAC;oBACtC,IAAI,GAAG,CAAC,MAAM,KAAK,sBAAsB,IAAI,GAAG,CAAC,MAAM,KAAK,wBAAwB,EAAE,CAAC;wBACrF,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;wBACrD,IAAI,MAAM,KAAK,SAAS;4BAAE,KAAK,CAAC,MAAM,CAAC,CAAC;oBAC1C,CAAC;oBACD,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;wBAC9B,OAAO,CAAC,CAAC,CAAC,CAAC;oBACb,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -5,5 +5,10 @@ import { Command } from '@mudah-cli/console';
 export default class MakeCommand extends Command {
     signature: string;
     description: string;
+    descriptionKey: string;
     handle(): Promise<void>;
+    private writeTui;
+    private hintNext;
+    private writeNew;
+    private writePlugin;
 }

package/dist/commands/make.command.js

@@ -1,6 +1,13 @@
+import { existsSync, readFileSync } from 'node:fs';
 import { mkdir, writeFile } from 'node:fs/promises';
 import { isAbsolute, join, relative } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { Command } from '@mudah-cli/console';
+/** Peer range for a generated plugin, matching the installed framework version. */
+function mudahRange() {
+    const pkg = JSON.parse(readFileSync(fileURLToPath(new URL('../../package.json', import.meta.url)), 'utf8'));
+    return `^${pkg.version}`;
+}
 function kebab(name) {
     return name.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();
 }
@@ -10,6 +17,8 @@ function pascal(name) {
         .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
         .join('');
 }
+const TUI_RECIPES = ['picker', 'wizard', 'dashboard', 'form'];
+const HINT = 'Use: make command {name} | make tui {picker|wizard|dashboard|form} {name?} | make provider {name} | make config {name} | make plugin {name}';
 const COMMAND_TEMPLATE = (command, className) => `import { Command } from '@mudah-cli/mudah';
 
 export default class ${className} extends Command {
@@ -17,14 +26,30 @@ export default class ${className} extends Command {
   description = 'Describe ${command} in one line.';
 
   async handle() {
-    this.output.success('Hello from ${command}!');
+    this.output.success(\`Hello from ${command}!\`);
   }
 }
 `;
+const COMMAND_TEST = (command) => `import { fileURLToPath } from 'node:url';
+import { describe, it } from 'vitest';
+import { TestApp } from '@mudah-cli/mudah/testing';
+
+const appDir = fileURLToPath(new URL('..', import.meta.url));
+
+describe('${command}', () => {
+  it('runs', async () => {
+    const app = await TestApp.create({ cwd: appDir });
+    const result = await app.dispatch(['${command}']);
+    result.exit(0).outContains('Hello from ${command}!');
+  });
+});
+`;
 const PROVIDER_TEMPLATE = (className) => `import { ServiceProvider } from '@mudah-cli/mudah';
 
 export default class ${className} extends ServiceProvider {
-  register(): void {}
+  register(): void {
+    // this.app.singleton('db', () => new Db());
+  }
 
   boot(): void {}
 }
@@ -35,23 +60,65 @@ export default defineConfig({
   // Add configuration for this component.
 });
 `;
-const TUI_HINT = 'Use: make {command|provider|config|tui} {name}';
+const PLUGIN_PACKAGE = (name) => `${JSON.stringify({
+    name,
+    version: '0.1.0',
+    private: true,
+    description: `${name} — a Mudah plugin`,
+    type: 'module',
+    license: 'MIT',
+    keywords: ['mudah-plugin', 'cli'],
+    exports: { '.': './src/index.ts' },
+    dependencies: { '@mudah-cli/mudah': mudahRange() },
+}, null, 2)}\n`;
+const PLUGIN_INDEX = (name, className) => `import { Command, ServiceProvider } from '@mudah-cli/mudah';
+
+/** Binds services this plugin contributes. */
+export class ${className}Provider extends ServiceProvider {
+  register(): void {}
+
+  boot(): void {}
+}
+
+export class ${className}HelloCommand extends Command {
+  signature = '${name}:hello';
+  description = 'Hello from the ${name} plugin';
+  groupDescription = '${className} plugin';
+
+  async handle(): Promise<number> {
+    this.output.success('Hello from ${name}');
+    return 0;
+  }
+}
+
+export const providers = [${className}Provider];
+export const commands = [${className}HelloCommand];
+`;
 const TUI_PICKER = (command, className) => `import { Command } from '@mudah-cli/mudah';
-import { Program, Screen } from '@mudah-cli/mudah/tui';
+import { Screen } from '@mudah-cli/mudah/tui';
+
+const ITEMS = ['one', 'two', 'three'];
 
 export default class ${className} extends Command {
-  signature = '${command}';
+  signature = '${command} {item?}';
   description = 'Pick one item';
 
   async handle(): Promise<number> {
+    const flagged = this.arg('item');
+    if (flagged) {
+      if (!ITEMS.includes(flagged)) {
+        throw this.usageError(\`Unknown item "\${flagged}".\`, \`Known: \${ITEMS.join(', ')}\`);
+      }
+      this.output.success(\`Picked \${flagged}.\`);
+      return 0;
+    }
     if (process.stdout.isTTY !== true) {
       this.output.error('This command needs an interactive terminal.');
+      this.output.hint('Pass an item: ${command} one');
       return 2;
     }
-    const screen = Screen.picker({ title: '${command}', items: ['one', 'two', 'three'] });
-    const program = new Program();
-    screen.attach(program);
-    const code = await program.run();
+    const screen = Screen.picker({ title: '${command}', items: ITEMS });
+    const code = await screen.run();
     const picked = screen.result();
     if (picked) this.output.success(\`Picked \${picked}.\`);
     return code;
@@ -59,16 +126,20 @@ export default class ${className} extends Command {
 }
 `;
 const TUI_WIZARD = (command, className) => `import { Command } from '@mudah-cli/mudah';
-import { Program, Screen } from '@mudah-cli/mudah/tui';
+import { Screen } from '@mudah-cli/mudah/tui';
 
 export default class ${className} extends Command {
-  signature = '${command}';
+  signature = '${command} [--env=] [--note=]';
   description = 'Multi-step wizard';
 
   async handle(): Promise<number> {
-    if (process.stdout.isTTY !== true) {
-      this.output.error('This command needs an interactive terminal.');
-      return 2;
+    const envFlag = this.option('env');
+    const noteFlag = this.option('note');
+    if (typeof envFlag === 'string' || process.stdout.isTTY !== true) {
+      const env = typeof envFlag === 'string' && envFlag.length > 0 ? envFlag : 'staging';
+      const note = typeof noteFlag === 'string' ? noteFlag : '';
+      this.output.success(JSON.stringify({ env, note }));
+      return 0;
     }
     const screen = Screen.wizard({
       title: '${command}',
@@ -77,9 +148,7 @@ export default class ${className} extends Command {
         { name: 'note', kind: 'text', label: 'Note' },
       ],
     });
-    const program = new Program();
-    screen.attach(program);
-    const code = await program.run();
+    const code = await screen.run();
     const result = screen.result();
     if (result) this.output.success(JSON.stringify(result));
     return code;
@@ -87,81 +156,234 @@ export default class ${className} extends Command {
 }
 `;
 const TUI_DASHBOARD = (command, className) => `import { Command } from '@mudah-cli/mudah';
-import { Program, Screen } from '@mudah-cli/mudah/tui';
+import { Screen } from '@mudah-cli/mudah/tui';
+
+const ROWS = [
+  ['api', 'ok'],
+  ['worker', 'ok'],
+];
 
 export default class ${className} extends Command {
-  signature = '${command}';
+  signature = '${command} [--dump]';
   description = 'Full-screen dashboard';
 
   async handle(): Promise<number> {
-    if (process.stdout.isTTY !== true) {
-      this.output.error('This command needs an interactive terminal.');
-      return 2;
+    if (this.option('dump') === true || process.stdout.isTTY !== true) {
+      this.output.section('${command}');
+      for (const [name, status] of ROWS) this.output.keyValue(name ?? '', status ?? '');
+      return 0;
     }
     const screen = Screen.dashboard({
       title: '${command}',
       sidebar: ['esc to quit', 'drag the split'],
       columns: [{ header: 'name' }, { header: 'status' }],
-      rows: [['api', 'ok'], ['worker', 'ok']],
+      rows: ROWS,
     });
-    const program = new Program({ mouse: true });
-    screen.attach(program);
-    return program.run();
+    return screen.run({ mouse: true });
+  }
+}
+`;
+const TUI_FORM = (command, className) => `import { Command, s } from '@mudah-cli/mudah';
+import { Screen } from '@mudah-cli/mudah/tui';
+
+const schema = s.object({
+  name: s.string(),
+  live: s.boolean(),
+});
+
+export default class ${className} extends Command {
+  signature = '${command} [--name=] [--live]';
+  description = 'Schema-backed form';
+
+  async handle(): Promise<number> {
+    const named = this.option('name');
+    if (typeof named === 'string' || this.option('live') === true || process.stdout.isTTY !== true) {
+      this.output.success(
+        JSON.stringify({ name: typeof named === 'string' ? named : '', live: this.option('live') === true }),
+      );
+      return 0;
+    }
+    const screen = Screen.form({ title: '${command}', schema });
+    const code = await screen.run();
+    const values = screen.result();
+    if (values) this.output.success(JSON.stringify(values));
+    return code;
   }
 }
 `;
+const TUI_PICKER_TEST = (command) => `import { fileURLToPath } from 'node:url';
+import { describe, expect, it } from 'vitest';
+import { Screen } from '@mudah-cli/mudah/tui';
+import { TestApp, TestTui } from '@mudah-cli/mudah/testing';
+
+const appDir = fileURLToPath(new URL('..', import.meta.url));
+
+describe('${command}', () => {
+  it('picks from an argument without a TTY', async () => {
+    const app = await TestApp.create({ cwd: appDir });
+    const result = await app.dispatch(['${command}', 'two']);
+    result.exit(0).outContains('Picked two.');
+  });
+
+  it('renders the picker', () => {
+    const screen = Screen.picker({ title: '${command}', items: ['one', 'two', 'three'] });
+    const tui = TestTui.mount(screen.root, { cols: 40, rows: 10 });
+    expect(tui.snapshot()).toContain('${command}');
+    tui.send('down').send('enter');
+    expect(screen.result()).toBe('two');
+  });
+});
+`;
+const TUI_SCREEN_TEST = (command, recipe) => {
+    if (recipe === 'picker')
+        return TUI_PICKER_TEST(command);
+    const factory = recipe === 'wizard'
+        ? `Screen.wizard({ title: '${command}', steps: [{ name: 'env', kind: 'pick', items: ['staging', 'production'] }] })`
+        : recipe === 'form'
+            ? `Screen.form({ title: '${command}', schema: s.object({ name: s.string() }) })`
+            : `Screen.dashboard({ title: '${command}', sidebar: ['esc'], columns: [{ header: 'name' }], rows: [['api']] })`;
+    const extraImport = recipe === 'form' ? `\nimport { s } from '@mudah-cli/mudah';` : '';
+    const cli = recipe === 'wizard'
+        ? `['${command}', '--env=production']`
+        : recipe === 'form'
+            ? `['${command}', '--name=Ada']`
+            : `['${command}', '--dump']`;
+    const expectOut = recipe === 'wizard' ? 'production' : recipe === 'form' ? 'Ada' : 'api';
+    return `import { fileURLToPath } from 'node:url';
+import { describe, expect, it } from 'vitest';
+import { Screen } from '@mudah-cli/mudah/tui';
+import { TestApp, TestTui } from '@mudah-cli/mudah/testing';${extraImport}
+
+const appDir = fileURLToPath(new URL('..', import.meta.url));
+
+describe('${command}', () => {
+  it('runs without a TTY', async () => {
+    const app = await TestApp.create({ cwd: appDir });
+    const result = await app.dispatch(${cli});
+    result.exit(0).outContains('${expectOut}');
+  });
+
+  it('renders the ${recipe}', () => {
+    const screen = ${factory};
+    const tui = TestTui.mount(screen.root, { cols: 60, rows: 16 });
+    expect(tui.snapshot()).toContain('${command}');
+    expect(tui.tree().role).toBeTruthy();
+  });
+});
+`;
+};
+function tuiSource(recipe, command, className) {
+    if (recipe === 'wizard')
+        return TUI_WIZARD(command, className);
+    if (recipe === 'dashboard')
+        return TUI_DASHBOARD(command, className);
+    if (recipe === 'form')
+        return TUI_FORM(command, className);
+    return TUI_PICKER(command, className);
+}
 /**
  * Built-in `make` command: scaffold commands, providers, config files, and TUI recipes.
  */
 export default class MakeCommand extends Command {
-    signature = 'make {type} {name}';
-    description = 'Scaffold a command, provider, config file, or TUI screen';
+    signature = 'make {type} {name} {extra?}';
+    description = 'Scaffold a command, provider, config file, TUI screen, or plugin';
+    descriptionKey = 'cmd.make.description';
     async handle() {
         const type = this.arg('type');
         const name = this.arg('name');
-        if (!['command', 'provider', 'config', 'tui'].includes(type)) {
-            throw this.usageError(`Unknown make type "${type}".`, TUI_HINT);
+        const extra = this.arg('extra');
+        if (!['command', 'provider', 'config', 'tui', 'plugin'].includes(type)) {
+            throw this.usageError(`Unknown make type "${type}".`, HINT);
+        }
+        for (const part of [name, extra]) {
+            if (part !== undefined && !/^[a-zA-Z][a-zA-Z0-9-]*$/.test(part)) {
+                throw this.usageError(`Invalid name "${part}".`, 'Use letters, numbers, and dashes (e.g. "deploy-site").');
+            }
         }
-        if (!/^[a-zA-Z][a-zA-Z0-9-]*$/.test(name)) {
-            throw this.usageError(`Invalid name "${name}".`, 'Use letters, numbers, and dashes (e.g. "deploy-site").');
+        if (extra && type !== 'tui') {
+            throw this.usageError(`"${type}" takes one name.`, HINT);
         }
         const k = kebab(name);
         const className = pascal(name);
+        if (type === 'plugin') {
+            await this.writePlugin(k, className);
+            return;
+        }
+        if (type === 'tui') {
+            await this.writeTui(k, extra);
+            return;
+        }
         let filePath;
         let content;
+        let testPath;
+        let testContent;
         if (type === 'command') {
             filePath = join(this.app.basePath, 'src', 'commands', `${k}.command.ts`);
             content = COMMAND_TEMPLATE(k, className);
+            testPath = join(this.app.basePath, 'test', `${k}.test.ts`);
+            testContent = COMMAND_TEST(k);
         }
         else if (type === 'provider') {
             filePath = join(this.app.basePath, 'src', 'providers', `${className}Provider.ts`);
             content = PROVIDER_TEMPLATE(`${className}Provider`);
         }
-        else if (type === 'tui') {
-            if (!['picker', 'wizard', 'dashboard'].includes(k)) {
-                throw this.usageError(`Unknown TUI recipe "${name}".`, 'Use: make tui {picker|wizard|dashboard}');
-            }
-            filePath = join(this.app.basePath, 'src', 'commands', `${k}.command.ts`);
-            content = k === 'wizard' ? TUI_WIZARD(k, className) : k === 'dashboard' ? TUI_DASHBOARD(k, className) : TUI_PICKER(k, className);
-        }
         else {
             filePath = join(this.app.basePath, 'config', `${k}.ts`);
             content = CONFIG_TEMPLATE;
         }
+        await this.writeNew(filePath, content);
+        this.output.success(`Created ${relative(this.app.basePath, filePath)}`);
+        if (testPath && testContent) {
+            await this.writeNew(testPath, testContent);
+            this.output.success(`Created ${relative(this.app.basePath, testPath)}`);
+        }
+        this.hintNext(type === 'command' ? k : undefined);
+    }
+    async writeTui(recipe, extra) {
+        if (!TUI_RECIPES.includes(recipe)) {
+            throw this.usageError(`Unknown TUI recipe "${recipe}".`, 'Use: make tui {picker|wizard|dashboard|form} {name?}');
+        }
+        const command = extra ? kebab(extra) : recipe;
+        const className = pascal(command);
+        const filePath = join(this.app.basePath, 'src', 'commands', `${command}.command.ts`);
+        const testPath = join(this.app.basePath, 'test', `${command}.test.ts`);
+        await this.writeNew(filePath, tuiSource(recipe, command, className));
+        await this.writeNew(testPath, TUI_SCREEN_TEST(command, recipe));
+        this.output.success(`Created ${relative(this.app.basePath, filePath)}`);
+        this.output.success(`Created ${relative(this.app.basePath, testPath)}`);
+        this.hintNext(command);
+    }
+    hintNext(command) {
+        const bin = this.app.manifest.bin;
+        if (command) {
+            this.output.hint(`Next: node bin/${bin}.js ${command}   then npm test`);
+        }
+    }
+    async writeNew(filePath, content) {
         if (isAbsolute(filePath) === false || !filePath.startsWith(this.app.basePath)) {
             throw this.usageError('Refusing to write outside the app directory.');
         }
-        try {
-            await mkdir(join(filePath, '..'), { recursive: true });
-            await writeFile(filePath, content, { flag: 'wx' });
+        if (existsSync(filePath)) {
+            throw this.usageError(`${relative(this.app.basePath, filePath)} already exists.`);
         }
-        catch (error) {
-            if (error.code === 'EEXIST') {
-                throw this.usageError(`${relative(this.app.basePath, filePath)} already exists.`);
-            }
-            throw error;
+        await mkdir(join(filePath, '..'), { recursive: true });
+        await writeFile(filePath, content, { flag: 'wx' });
+    }
+    async writePlugin(k, className) {
+        const dir = join(this.app.basePath, `${k}-plugin`);
+        if (isAbsolute(dir) === false || !dir.startsWith(this.app.basePath)) {
+            throw this.usageError('Refusing to write outside the app directory.');
         }
-        this.output.success(`Created ${relative(this.app.basePath, filePath)}`);
+        const pkgPath = join(dir, 'package.json');
+        const srcPath = join(dir, 'src', 'index.ts');
+        if (existsSync(pkgPath) || existsSync(srcPath)) {
+            throw this.usageError(`${relative(this.app.basePath, dir)} already exists.`);
+        }
+        await mkdir(join(dir, 'src'), { recursive: true });
+        await writeFile(pkgPath, PLUGIN_PACKAGE(k), { flag: 'wx' });
+        await writeFile(srcPath, PLUGIN_INDEX(k, className), { flag: 'wx' });
+        this.output.success(`Created ${relative(this.app.basePath, srcPath)}`);
+        this.output.hint(`Next: npm install ./${k}-plugin`);
     }
 }
 //# sourceMappingURL=make.command.js.map