aliasmate 1.6.2 → 2.3.0

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3C,yFAAyF;AACzF,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAEtD,iDAAiD;AACjD,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC"}

package/dist/core/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/core/validate.d.ts

@@ -0,0 +1,6 @@
+import { SavedCommand, ValidationIssue } from './types';
+/** Static checks on a saved command; errors block execution, warnings do not. */
+export declare function validateSavedCommand(cmd: SavedCommand): ValidationIssue[];
+/** Human-readable warnings when a command looks destructive. */
+export declare function getDangerWarnings(command: string): string[];
+//# sourceMappingURL=validate.d.ts.map

package/dist/core/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/core/validate.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAwDxD,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,YAAY,GAAG,eAAe,EAAE,CAkCzE;AAUD,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAI3D"}

package/dist/core/validate.js

@@ -0,0 +1,139 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateSavedCommand = validateSavedCommand;
+exports.getDangerWarnings = getDangerWarnings;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const SHELL_BUILTINS = new Set([
+    'cd',
+    'echo',
+    'export',
+    'source',
+    'alias',
+    'set',
+    'unset',
+    'read',
+    'eval',
+    'exec',
+    'exit',
+    'true',
+    'false',
+    'test',
+    'pwd',
+    'type',
+    'command',
+    'wait',
+]);
+function executableExistsInPath(name) {
+    const pathVar = process.env.PATH ?? '';
+    const exts = os.platform() === 'win32' ? (process.env.PATHEXT ?? '.EXE;.CMD;.BAT').split(';') : [''];
+    for (const dir of pathVar.split(path.delimiter)) {
+        if (!dir)
+            continue;
+        for (const ext of exts) {
+            try {
+                const candidate = path.join(dir, name + ext.toLowerCase());
+                if (fs.existsSync(candidate) || fs.existsSync(path.join(dir, name + ext)))
+                    return true;
+            }
+            catch {
+                // Unreadable PATH entry; skip.
+            }
+        }
+    }
+    return false;
+}
+function hasBalancedQuotes(command) {
+    let single = false;
+    let double = false;
+    for (let i = 0; i < command.length; i++) {
+        const ch = command[i];
+        if (ch === '\\' && !single) {
+            i++;
+            continue;
+        }
+        if (ch === "'" && !double)
+            single = !single;
+        if (ch === '"' && !single)
+            double = !double;
+    }
+    return !single && !double;
+}
+/** Static checks on a saved command; errors block execution, warnings do not. */
+function validateSavedCommand(cmd) {
+    const issues = [];
+    const executable = cmd.command.trim().split(/\s+/)[0] ?? '';
+    const looksLikePath = executable.includes('/') || executable.includes('\\');
+    const isEnvAssignment = /^[A-Za-z_][A-Za-z0-9_]*=/.test(executable);
+    if (executable && !looksLikePath && !isEnvAssignment) {
+        if (!SHELL_BUILTINS.has(executable) && !executableExistsInPath(executable)) {
+            issues.push({ level: 'warning', message: `Command "${executable}" not found in PATH` });
+        }
+    }
+    else if (looksLikePath) {
+        const resolved = path.isAbsolute(executable)
+            ? executable
+            : path.join(cmd.directory, executable);
+        if (!fs.existsSync(resolved)) {
+            issues.push({ level: 'warning', message: `File "${executable}" does not exist` });
+        }
+    }
+    if (!hasBalancedQuotes(cmd.command)) {
+        issues.push({ level: 'error', message: 'Unbalanced quotes in command' });
+    }
+    if ((cmd.pathMode ?? 'saved') === 'saved' && !fs.existsSync(cmd.directory)) {
+        issues.push({ level: 'error', message: `Directory does not exist: ${cmd.directory}` });
+    }
+    for (const key of Object.keys(cmd.env ?? {})) {
+        if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) {
+            issues.push({ level: 'warning', message: `Invalid environment variable name: ${key}` });
+        }
+    }
+    return issues;
+}
+const DANGEROUS_PATTERNS = [
+    { pattern: /rm\s+(-[a-z]*[rf][a-z]*\s+)+/i, label: 'recursive/forced delete (rm -rf)' },
+    { pattern: /\bdd\s+.*of=/i, label: 'raw disk write (dd)' },
+    { pattern: /\bmkfs(\.\w+)?\b/i, label: 'filesystem format (mkfs)' },
+    { pattern: />\s*\/dev\/sd[a-z]/i, label: 'write to block device' },
+    { pattern: /:\(\)\s*\{.*\};\s*:/, label: 'fork bomb' },
+];
+/** Human-readable warnings when a command looks destructive. */
+function getDangerWarnings(command) {
+    return DANGEROUS_PATTERNS.filter(({ pattern }) => pattern.test(command)).map(({ label }) => label);
+}
+//# sourceMappingURL=validate.js.map

package/dist/core/validate.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+// Version comes from package.json so releases can't drift out of sync.
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const APP_VERSION = require('../package.json').version;
+/**
+ * Command handlers are required lazily inside actions: `aliasmate run x`
+ * never pays to load inquirer, and the interactive menu never loads execa
+ * until a command actually runs.
+ */
+function wrap(fn) {
+    Promise.resolve()
+        .then(fn)
+        .catch((error) => {
+        // Ctrl+C inside inquirer surfaces as a benign abort.
+        if (error?.message?.includes('User force closed'))
+            process.exit(0);
+        console.error(`\x1b[31m✗ ${error.message}\x1b[0m`);
+        process.exit(1);
+    });
+}
+const program = new commander_1.Command();
+program
+    .name('aliasmate')
+    .description('Save shell commands with their working directories and re-run them from anywhere')
+    .version(APP_VERSION);
+program
+    .command('run <name> [path]')
+    .description('Run a saved command (name, alias, or @N recent reference)')
+    .option('--dry-run', 'Preview what would execute without running it')
+    .option('--verbose', 'Show full details in dry-run output')
+    .action((name, pathOverride, options) => wrap(async () => (await Promise.resolve().then(() => __importStar(require('./cli/run')))).runHandler(name, pathOverride, options)));
+program
+    .command('save')
+    .description('Open the TUI with a blank new-command form')
+    .action(() => wrap(async () => (await Promise.resolve().then(() => __importStar(require('./cli/save')))).saveHandler()));
+program
+    .command('prev [name]')
+    .description('Capture your previous shell command and open the TUI form prefilled')
+    .action((name) => wrap(async () => (await Promise.resolve().then(() => __importStar(require('./cli/save')))).prevHandler(name)));
+program
+    .command('list')
+    .alias('ls')
+    .description('List all saved commands')
+    .option('--format <type>', 'Output format: table, json, yaml, compact', 'table')
+    .action((options) => wrap(async () => {
+    const valid = ['table', 'json', 'yaml', 'compact'];
+    if (!valid.includes(options.format))
+        throw new Error(`Invalid format "${options.format}" (${valid.join(', ')})`);
+    (await Promise.resolve().then(() => __importStar(require('./cli/manage')))).listHandler(options.format);
+}));
+program
+    .command('search <query>')
+    .alias('find')
+    .description('Search commands by name, text, or directory')
+    .action((query) => wrap(async () => (await Promise.resolve().then(() => __importStar(require('./cli/manage')))).searchHandler(query)));
+program
+    .command('edit <name>')
+    .description('Edit a saved command in the TUI')
+    .action((name) => wrap(async () => (await Promise.resolve().then(() => __importStar(require('./cli/manage')))).editHandler(name)));
+program
+    .command('rename <old> <new>')
+    .alias('mv')
+    .description('Rename a saved command (aliases and history follow)')
+    .action((oldName, newName) => wrap(async () => (await Promise.resolve().then(() => __importStar(require('./cli/manage')))).renameHandler(oldName, newName)));
+program
+    .command('delete <name>')
+    .alias('rm')
+    .description('Delete a saved command')
+    .option('-f, --force', 'Delete without confirmation')
+    .action((name, options) => wrap(async () => (await Promise.resolve().then(() => __importStar(require('./cli/manage')))).deleteHandler(name, options)));
+program
+    .command('alias [short] [command]')
+    .description('Create, list, or remove shortcut aliases')
+    .option('--list', 'List all aliases')
+    .option('--remove <alias>', 'Remove an alias')
+    .action((short, command, options) => wrap(async () => (await Promise.resolve().then(() => __importStar(require('./cli/manage')))).aliasHandler(short, command, options)));
+program
+    .command('recent')
+    .description('Show recently run commands (@N references)')
+    .option('--limit <n>', 'Maximum entries to show', (v) => parseInt(v, 10))
+    .option('--clear', 'Clear execution history')
+    .action((options) => wrap(async () => (await Promise.resolve().then(() => __importStar(require('./cli/manage')))).recentHandler(options)));
+program
+    .command('stats')
+    .description('Show usage statistics for your commands')
+    .action(() => wrap(async () => (await Promise.resolve().then(() => __importStar(require('./cli/manage')))).statsHandler()));
+program
+    .command('validate [name]')
+    .description('Validate one command, or all commands')
+    .option('--all', 'Validate all saved commands')
+    .action((name, options) => wrap(async () => (await Promise.resolve().then(() => __importStar(require('./cli/manage')))).validateHandler(options.all ? undefined : name)));
+program
+    .command('export <file>')
+    .description('Export commands to a JSON or YAML file (secrets masked unless --full)')
+    .option('--format <type>', 'json or yaml')
+    .option('--full', 'Include real secret env values (restorable backup)')
+    .action((file, options) => wrap(async () => (await Promise.resolve().then(() => __importStar(require('./cli/transfer')))).exportHandler(file, options)));
+program
+    .command('import <file>')
+    .description('Import commands from a JSON file (auto-backup first)')
+    .action((file) => wrap(async () => (await Promise.resolve().then(() => __importStar(require('./cli/transfer')))).importHandler(file)));
+program
+    .command('completion [shell]')
+    .description('Generate or install shell completion (bash, zsh, fish)')
+    .option('--install', 'Install completion for your current shell')
+    .option('--names', 'Print saved command names (used by completion scripts)')
+    .action((shell, options) => wrap(async () => (await Promise.resolve().then(() => __importStar(require('./cli/completion')))).completionHandler(shell, options)));
+program
+    .command('config')
+    .description('Show where your commands are stored')
+    .action(() => wrap(async () => {
+    const { getConfigDir, getConfigPath } = await Promise.resolve().then(() => __importStar(require('./core/store')));
+    const { listCommands } = await Promise.resolve().then(() => __importStar(require('./core/commands')));
+    console.log(`Config directory: ${getConfigDir()}`);
+    console.log(`Config file:      ${getConfigPath()}`);
+    console.log(`Saved commands:   ${Object.keys(listCommands()).length}`);
+}));
+program.showSuggestionAfterError(true);
+const args = process.argv.slice(2);
+if (args.length === 0) {
+    // Zero-args: interactive home screen (with first-run welcome).
+    wrap(async () => {
+        const { maybeShowOnboarding } = await Promise.resolve().then(() => __importStar(require('./ui/onboarding')));
+        maybeShowOnboarding(APP_VERSION);
+        if (process.stdout.isTTY && process.stdin.isTTY) {
+            await (await Promise.resolve().then(() => __importStar(require('./ui/interactive')))).interactiveHome();
+        }
+        else {
+            program.outputHelp();
+        }
+    });
+}
+else {
+    program.parse(process.argv);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/ui/format.d.ts

@@ -0,0 +1,19 @@
+import { CommandMap, ListFormat, SavedCommand } from '../core/types';
+/** "2 minutes ago" style relative time. */
+export declare function timeAgo(iso: string, now?: Date): string;
+export declare function truncate(text: string, max: number): string;
+export declare function toJson(commands: CommandMap, mask?: boolean): string;
+export declare function toYaml(commands: CommandMap, mask?: boolean): string;
+export declare function toCompact(commands: CommandMap): string;
+export interface TableOptions {
+    runCounts?: Map<string, number>;
+    lastRuns?: Map<string, string>;
+}
+/** Shorten a path for display: home becomes ~. */
+export declare function prettyPath(dir: string): string;
+/** Boxed, width-aware table sorted by usage. */
+export declare function toTable(commands: CommandMap, options?: TableOptions): string;
+export declare function render(commands: CommandMap, format: ListFormat, options?: TableOptions): string;
+/** One-line summary of a command used in confirmation output. */
+export declare function summarize(name: string, cmd: SavedCommand): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/ui/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/ui/format.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAKrE,2CAA2C;AAC3C,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAcnE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D;AAUD,wBAAgB,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,UAAO,GAAG,MAAM,CAEhE;AAMD,wBAAgB,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,UAAO,GAAG,MAAM,CAgBhE;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,CAItD;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,kDAAkD;AAClD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED,gDAAgD;AAChD,wBAAgB,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,GAAE,YAAiB,GAAG,MAAM,CAiChF;AAED,wBAAgB,MAAM,CACpB,QAAQ,EAAE,UAAU,EACpB,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,YAAiB,GACzB,MAAM,CAWR;AAED,iEAAiE;AACjE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,CAEjE"}

package/dist/ui/format.js

@@ -0,0 +1,155 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.timeAgo = timeAgo;
+exports.truncate = truncate;
+exports.toJson = toJson;
+exports.toYaml = toYaml;
+exports.toCompact = toCompact;
+exports.prettyPath = prettyPath;
+exports.toTable = toTable;
+exports.render = render;
+exports.summarize = summarize;
+const os = __importStar(require("os"));
+const env_1 = require("../core/env");
+const table_1 = require("./table");
+const theme_1 = require("./theme");
+/** "2 minutes ago" style relative time. */
+function timeAgo(iso, now = new Date()) {
+    const seconds = Math.max(0, Math.floor((now.getTime() - new Date(iso).getTime()) / 1000));
+    const units = [
+        [31536000, 'year'],
+        [2592000, 'month'],
+        [86400, 'day'],
+        [3600, 'hour'],
+        [60, 'minute'],
+    ];
+    for (const [size, label] of units) {
+        const count = Math.floor(seconds / size);
+        if (count >= 1)
+            return `${count} ${label}${count > 1 ? 's' : ''} ago`;
+    }
+    return 'just now';
+}
+function truncate(text, max) {
+    return text.length <= max ? text : `${text.slice(0, max - 1)}…`;
+}
+function maskedCopy(commands) {
+    const out = {};
+    for (const [name, cmd] of Object.entries(commands)) {
+        out[name] = cmd.env ? { ...cmd, env: (0, env_1.maskSensitive)(cmd.env) } : cmd;
+    }
+    return out;
+}
+function toJson(commands, mask = true) {
+    return JSON.stringify(mask ? maskedCopy(commands) : commands, null, 2);
+}
+function yamlQuote(value) {
+    return /^[\w./-]+$/.test(value) ? value : JSON.stringify(value);
+}
+function toYaml(commands, mask = true) {
+    const data = mask ? maskedCopy(commands) : commands;
+    const lines = [];
+    for (const [name, cmd] of Object.entries(data)) {
+        lines.push(`${yamlQuote(name)}:`);
+        lines.push(`  command: ${yamlQuote(cmd.command)}`);
+        lines.push(`  directory: ${yamlQuote(cmd.directory)}`);
+        lines.push(`  pathMode: ${cmd.pathMode ?? 'saved'}`);
+        if (cmd.env && Object.keys(cmd.env).length > 0) {
+            lines.push('  env:');
+            for (const [k, v] of Object.entries(cmd.env))
+                lines.push(`    ${k}: ${yamlQuote(v)}`);
+        }
+        lines.push(`  createdAt: ${yamlQuote(cmd.createdAt)}`);
+        lines.push(`  updatedAt: ${yamlQuote(cmd.updatedAt)}`);
+    }
+    return lines.join('\n') + '\n';
+}
+function toCompact(commands) {
+    return Object.entries(commands)
+        .map(([name, cmd]) => `${name}: ${cmd.command} (${cmd.directory})`)
+        .join('\n');
+}
+/** Shorten a path for display: home becomes ~. */
+function prettyPath(dir) {
+    const home = os.homedir();
+    return dir.startsWith(home) ? `~${dir.slice(home.length)}` : dir;
+}
+/** Boxed, width-aware table sorted by usage. */
+function toTable(commands, options = {}) {
+    const names = Object.keys(commands).sort((a, b) => {
+        const runsA = options.runCounts?.get(a) ?? 0;
+        const runsB = options.runCounts?.get(b) ?? 0;
+        return runsB - runsA || a.localeCompare(b);
+    });
+    const rows = names.map((name) => {
+        const cmd = commands[name];
+        const runs = options.runCounts?.get(name) ?? 0;
+        const lastRun = options.lastRuns?.get(name);
+        const envCount = cmd.env ? Object.keys(cmd.env).length : 0;
+        const where = (cmd.pathMode ?? 'saved') === 'current' ? '(current dir)' : prettyPath(cmd.directory);
+        return [
+            name + (envCount > 0 ? ` ⁺${envCount}` : ''),
+            cmd.command,
+            where,
+            runs > 0 ? String(runs) : '·',
+            lastRun ? timeAgo(lastRun) : '—',
+        ];
+    });
+    return (0, table_1.renderTable)([
+        { header: 'Name', min: 12, flex: 1, style: (t) => theme_1.theme.name(t) },
+        { header: 'Command', min: 24, flex: 4 },
+        { header: 'Where', min: 14, flex: 2, style: (t) => theme_1.theme.dim(t) },
+        { header: 'Runs', min: 4, flex: 0, align: 'right', style: (t) => theme_1.theme.accent(t) },
+        { header: 'Last run', min: 14, flex: 0, style: (t) => theme_1.theme.dim(t) },
+    ], rows);
+}
+function render(commands, format, options = {}) {
+    switch (format) {
+        case 'json':
+            return toJson(commands);
+        case 'yaml':
+            return toYaml(commands);
+        case 'compact':
+            return toCompact(commands);
+        case 'table':
+            return toTable(commands, options);
+    }
+}
+/** One-line summary of a command used in confirmation output. */
+function summarize(name, cmd) {
+    return `${theme_1.theme.name(name)} ${theme_1.theme.dim('→')} ${cmd.command} ${theme_1.theme.dim(`(${cmd.directory})`)}`;
+}
+//# sourceMappingURL=format.js.map

package/dist/ui/format.js.map

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

package/dist/ui/interactive.d.ts

@@ -0,0 +1,62 @@
+import * as readline from 'readline';
+import { PathMode } from '../core/types';
+/** Simple subsequence fuzzy match: every query char appears in order. */
+export declare function fuzzyMatch(query: string, text: string): boolean;
+export interface FormSeed {
+    name?: string;
+    command?: string;
+    directory?: string;
+    pathMode?: PathMode;
+    /** When editing, the original name (kept fixed) and its saved env. */
+    editing?: string;
+    env?: Record<string, string>;
+}
+export type TuiAction = {
+    kind: 'run';
+    name: string;
+} | null;
+export declare class Tui {
+    private readonly out;
+    private mode;
+    private filter;
+    private selected;
+    private rows;
+    private form;
+    private input;
+    private message;
+    private resolve;
+    constructor(out?: (text: string) => void);
+    private get width();
+    private get height();
+    private visibleRows;
+    refresh(): void;
+    openForm(seed?: FormSeed): void;
+    private header;
+    private listPane;
+    private detailPane;
+    private statsPane;
+    private formPane;
+    private inputPane;
+    private footer;
+    render(): void;
+    /** Clear the filter but keep the same row highlighted. */
+    private clearFilter;
+    private move;
+    private openInput;
+    private handleInputKey;
+    private submitInput;
+    private submitForm;
+    private handleFormKey;
+    handleKey(str: string | undefined, key: readline.Key): void;
+    private selectRun;
+    private finish;
+    /** Show the TUI until the user runs a command or quits (null). */
+    waitForAction(): Promise<TuiAction>;
+}
+/**
+ * The full-screen home: everything (browse, create, edit, delete, stats)
+ * happens in the TUI. Only running a command hands the terminal back so
+ * output lands in normal scrollback.
+ */
+export declare function interactiveHome(seed?: FormSeed): Promise<void>;
+//# sourceMappingURL=interactive.d.ts.map

package/dist/ui/interactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../src/ui/interactive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAYrC,OAAO,EAAE,QAAQ,EAAgB,MAAM,eAAe,CAAC;AAIvD,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAS/D;AAKD,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAmED,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC;AAqB7D,qBAAa,GAAG;IAUF,OAAO,CAAC,QAAQ,CAAC,GAAG;IAThC,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,IAAI,CAA0B;IACtC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,OAAO,CAA8C;gBAEhC,GAAG,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAqC;IAEzF,OAAO,KAAK,KAAK,GAEhB;IACD,OAAO,KAAK,MAAM,GAEjB;IAED,OAAO,CAAC,WAAW;IAUnB,OAAO,IAAI,IAAI;IAKf,QAAQ,CAAC,IAAI,GAAE,QAAa,GAAG,IAAI;IAqBnC,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,QAAQ;IAgChB,OAAO,CAAC,UAAU;IAuBlB,OAAO,CAAC,SAAS;IAkBjB,OAAO,CAAC,QAAQ;IA6ChB,OAAO,CAAC,SAAS;IAejB,OAAO,CAAC,MAAM;IAgCd,MAAM,IAAI,IAAI;IAoCd,0DAA0D;IAC1D,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,WAAW;IA8BnB,OAAO,CAAC,UAAU;IAkDlB,OAAO,CAAC,aAAa;IA6CrB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,GAAG,IAAI;IAoF3D,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,MAAM;IAMd,kEAAkE;IAClE,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC;CAMpC;AAgBD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBpE"}