monomind 1.10.1 → 1.10.2

package/packages/@monomind/cli/dist/src/commands/tokens.js

@@ -0,0 +1,107 @@
+/**
+ * Monomind Tokens Command
+ * Token usage tracking and visualization — powered by token-tracker.cjs
+ */
+import { output } from '../output.js';
+import { createRequire } from 'module';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+function getTrackerPath() {
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    // From dist/src/commands/ -> back to project root -> .claude/helpers/
+    return join(__dirname, '..', '..', '..', '..', '..', '..', '.claude', 'helpers', 'token-tracker.cjs');
+}
+function loadTracker() {
+    const require = createRequire(import.meta.url);
+    return require(getTrackerPath());
+}
+const dashboardSubcommand = {
+    name: 'dashboard',
+    description: 'Launch interactive token usage dashboard',
+    options: [
+        { name: 'period', short: 'p', type: 'string', description: 'Time period: today|week|30days|month', default: 'today' },
+        { name: 'no-interactive', type: 'boolean', description: 'Render once and exit', default: false },
+    ],
+    action: async (ctx) => {
+        const period = ctx.flags['period'] || 'today';
+        const noInteractive = ctx.flags['no-interactive'];
+        try {
+            const tracker = loadTracker();
+            if (noInteractive) {
+                tracker.renderDashboard(period);
+            }
+            else {
+                tracker.runInteractive();
+            }
+            return { success: true };
+        }
+        catch (err) {
+            output.error('Token tracker not available: ' + (err instanceof Error ? err.message : String(err)));
+            return { success: false, message: 'Token tracker unavailable' };
+        }
+    },
+};
+const summarySubcommand = {
+    name: 'summary',
+    description: 'Show token usage summary for a period',
+    options: [
+        { name: 'period', short: 'p', type: 'string', description: 'Time period: today|week|30days|month', default: 'today' },
+        { name: 'json', type: 'boolean', description: 'Output as JSON', default: false },
+    ],
+    action: async (ctx) => {
+        const period = ctx.flags['period'] || 'today';
+        const asJson = ctx.flags['json'];
+        try {
+            const tracker = loadTracker();
+            const range = tracker.getDateRange(period);
+            const projects = tracker.parseAllSessions(range.start, range.end);
+            if (asJson) {
+                output.writeln(JSON.stringify(projects, null, 2));
+                return { success: true, data: projects };
+            }
+            const totalCost = projects.reduce((s, p) => s + p.totalCost, 0);
+            const totalCalls = projects.reduce((s, p) => s + p.totalApiCalls, 0);
+            output.writeln('');
+            output.writeln(`Token Usage — ${period}`);
+            output.writeln('─'.repeat(50));
+            output.writeln(`Total Cost:  ${tracker.fmt$(totalCost)}`);
+            output.writeln(`API Calls:   ${totalCalls}`);
+            output.writeln(`Projects:    ${projects.length}`);
+            output.writeln('');
+            for (const p of projects.slice(0, 10)) {
+                const name = p.projectPath.split('/').pop() || p.projectPath;
+                output.writeln(`  ${name.padEnd(30)} ${tracker.fmt$(p.totalCost).padStart(10)}  ${p.totalApiCalls} calls`);
+            }
+            output.writeln('');
+            return { success: true, data: { totalCost, totalCalls, projects } };
+        }
+        catch (err) {
+            output.error('Token tracker not available: ' + (err instanceof Error ? err.message : String(err)));
+            return { success: false, message: 'Token tracker unavailable' };
+        }
+    },
+};
+const todaySubcommand = {
+    name: 'today',
+    description: 'Quick today/month token usage summary',
+    options: [],
+    action: async (_ctx) => {
+        try {
+            const tracker = loadTracker();
+            const summary = tracker.quickSummary();
+            output.writeln(summary || 'No token data available for today.');
+            return { success: true };
+        }
+        catch (err) {
+            output.error('Token tracker not available: ' + (err instanceof Error ? err.message : String(err)));
+            return { success: false };
+        }
+    },
+};
+export const tokensCommand = {
+    name: 'tokens',
+    description: 'Token usage tracking and cost visualization',
+    subcommands: [dashboardSubcommand, summarySubcommand, todaySubcommand],
+};
+export default tokensCommand;
+//# sourceMappingURL=tokens.js.map

package/packages/@monomind/cli/dist/src/commands/transfer-store.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CLI Transfer Store Commands
+ * Pattern marketplace - list, search, download, publish
+ */
+import type { Command } from '../types.js';
+export declare const storeListCommand: Command;
+export declare const storeSearchCommand: Command;
+export declare const storeDownloadCommand: Command;
+export declare const storePublishCommand: Command;
+export declare const storeInfoCommand: Command;
+export declare const storeCommand: Command;
+export default storeCommand;
+//# sourceMappingURL=transfer-store.d.ts.map

package/packages/@monomind/cli/dist/src/commands/transfer-store.js

@@ -0,0 +1,428 @@
+/**
+ * CLI Transfer Store Commands
+ * Pattern marketplace - list, search, download, publish
+ */
+import { output } from '../output.js';
+import { createDiscoveryService, createDownloader, createPublisher, searchPatterns, } from '../transfer/index.js';
+// Store list subcommand
+export const storeListCommand = {
+    name: 'list',
+    aliases: ['ls'],
+    description: 'List patterns from decentralized registry',
+    options: [
+        { name: 'registry', short: 'r', type: 'string', description: 'Registry name (default: monomind-official)' },
+        { name: 'category', short: 'c', type: 'string', description: 'Filter by category' },
+        { name: 'featured', short: 'f', type: 'boolean', description: 'Show featured patterns' },
+        { name: 'trending', short: 't', type: 'boolean', description: 'Show trending patterns' },
+        { name: 'newest', short: 'n', type: 'boolean', description: 'Show newest patterns' },
+        { name: 'limit', short: 'l', type: 'number', description: 'Maximum results', default: 20 },
+    ],
+    examples: [
+        { command: 'monomind hooks transfer store list', description: 'List all patterns' },
+        { command: 'monomind hooks transfer store list --category routing', description: 'List routing patterns' },
+        { command: 'monomind hooks transfer store list --featured', description: 'List featured patterns' },
+    ],
+    action: async (ctx) => {
+        const registryName = ctx.flags.registry;
+        const category = ctx.flags.category;
+        const featured = ctx.flags.featured;
+        const trending = ctx.flags.trending;
+        const newest = ctx.flags.newest;
+        const limit = ctx.flags.limit || 20;
+        const spinner = output.createSpinner({ text: 'Discovering registry...', spinner: 'dots' });
+        spinner.start();
+        try {
+            const discovery = createDiscoveryService();
+            const result = await discovery.discoverRegistry(registryName);
+            if (!result.success || !result.registry) {
+                spinner.fail('Failed to discover registry');
+                output.printError(result.error || 'Unknown error');
+                return { success: false, exitCode: 1 };
+            }
+            spinner.succeed(`Connected to ${result.source}`);
+            // Get patterns based on flags
+            let patterns = result.registry.patterns;
+            let title = 'Available Patterns';
+            if (featured) {
+                patterns = result.registry.featured
+                    .map(id => patterns.find(p => p.id === id))
+                    .filter((p) => p !== undefined);
+                title = 'Featured Patterns';
+            }
+            else if (trending) {
+                patterns = result.registry.trending
+                    .map(id => patterns.find(p => p.id === id))
+                    .filter((p) => p !== undefined);
+                title = 'Trending Patterns';
+            }
+            else if (newest) {
+                patterns = result.registry.newest
+                    .map(id => patterns.find(p => p.id === id))
+                    .filter((p) => p !== undefined);
+                title = 'Newest Patterns';
+            }
+            if (category) {
+                patterns = patterns.filter(p => p.categories.includes(category));
+                title = `Patterns in "${category}"`;
+            }
+            patterns = patterns.slice(0, limit);
+            output.writeln();
+            output.writeln(output.bold(title));
+            output.writeln(output.dim('─'.repeat(70)));
+            if (patterns.length === 0) {
+                output.writeln(output.dim('No patterns found'));
+            }
+            else {
+                output.printTable({
+                    columns: [
+                        { key: 'name', header: 'Name', width: 25 },
+                        { key: 'version', header: 'Version', width: 10 },
+                        { key: 'downloads', header: 'Downloads', width: 12 },
+                        { key: 'rating', header: 'Rating', width: 10 },
+                        { key: 'verified', header: 'Status', width: 12 },
+                    ],
+                    data: patterns.map(p => ({
+                        name: p.displayName,
+                        version: p.version,
+                        downloads: p.downloads.toLocaleString(),
+                        rating: `${p.rating.toFixed(1)}/5`,
+                        verified: p.verified ? output.success('Verified') : output.dim('Community'),
+                    })),
+                });
+            }
+            output.writeln();
+            output.writeln(output.dim(`Registry: ${result.source} | Total: ${result.registry.totalPatterns} patterns`));
+            return { success: true };
+        }
+        catch (error) {
+            spinner.fail('Error listing patterns');
+            output.printError(String(error));
+            return { success: false, exitCode: 1 };
+        }
+    },
+};
+// Store search subcommand
+export const storeSearchCommand = {
+    name: 'search',
+    description: 'Search patterns in the decentralized registry',
+    options: [
+        { name: 'query', short: 'q', type: 'string', description: 'Search query', required: true },
+        { name: 'category', short: 'c', type: 'string', description: 'Filter by category' },
+        { name: 'language', short: 'l', type: 'string', description: 'Filter by language' },
+        { name: 'framework', short: 'f', type: 'string', description: 'Filter by framework' },
+        { name: 'tags', short: 't', type: 'string', description: 'Filter by tags (comma-separated)' },
+        { name: 'min-rating', type: 'number', description: 'Minimum rating (0-5)' },
+        { name: 'verified', short: 'v', type: 'boolean', description: 'Only verified patterns' },
+        { name: 'limit', type: 'number', description: 'Maximum results', default: 20 },
+    ],
+    examples: [
+        { command: 'monomind hooks transfer store search -q "routing"', description: 'Search for routing patterns' },
+        { command: 'monomind hooks transfer store search -q "react" --language typescript', description: 'Search with filters' },
+    ],
+    action: async (ctx) => {
+        const query = (ctx.args[0] || ctx.flags.query);
+        if (!query) {
+            output.printError('Search query is required. Use --query or -q flag.');
+            return { success: false, exitCode: 1 };
+        }
+        const spinner = output.createSpinner({ text: 'Searching patterns...', spinner: 'dots' });
+        spinner.start();
+        try {
+            const discovery = createDiscoveryService();
+            const result = await discovery.discoverRegistry();
+            if (!result.success || !result.registry) {
+                spinner.fail('Failed to discover registry');
+                return { success: false, exitCode: 1 };
+            }
+            const searchOptions = {
+                query,
+                category: ctx.flags.category,
+                language: ctx.flags.language,
+                framework: ctx.flags.framework,
+                tags: ctx.flags.tags ? ctx.flags.tags.split(',') : undefined,
+                minRating: ctx.flags['min-rating'],
+                verified: ctx.flags.verified,
+                limit: ctx.flags.limit || 20,
+            };
+            const searchResult = searchPatterns(result.registry, searchOptions);
+            spinner.succeed(`Found ${searchResult.total} patterns`);
+            output.writeln();
+            output.writeln(output.bold(`Search Results for "${query}"`));
+            output.writeln(output.dim('─'.repeat(70)));
+            if (searchResult.patterns.length === 0) {
+                output.writeln(output.dim('No patterns match your search'));
+            }
+            else {
+                for (const pattern of searchResult.patterns) {
+                    output.writeln();
+                    output.writeln(`  ${output.bold(pattern.displayName)} ${output.dim(`v${pattern.version}`)}`);
+                    output.writeln(`  ${output.dim(pattern.description.slice(0, 70))}...`);
+                    output.writeln(`  ${output.dim('Tags:')} ${pattern.tags.slice(0, 5).join(', ')}`);
+                    output.writeln(`  ${output.dim('Rating:')} ${pattern.rating.toFixed(1)}/5 | ${output.dim('Downloads:')} ${pattern.downloads}`);
+                }
+            }
+            output.writeln();
+            output.writeln(output.dim(`Showing ${searchResult.patterns.length} of ${searchResult.total} results`));
+            return { success: true, data: searchResult };
+        }
+        catch (error) {
+            spinner.fail('Search failed');
+            output.printError(String(error));
+            return { success: false, exitCode: 1 };
+        }
+    },
+};
+// Store download subcommand
+export const storeDownloadCommand = {
+    name: 'download',
+    aliases: ['get', 'install'],
+    description: 'Download a pattern from the registry',
+    options: [
+        { name: 'name', short: 'n', type: 'string', description: 'Pattern name or ID', required: true },
+        { name: 'output', short: 'o', type: 'string', description: 'Output path' },
+        { name: 'verify', short: 'v', type: 'boolean', description: 'Verify checksum', default: true },
+        { name: 'import', short: 'i', type: 'boolean', description: 'Import after download' },
+    ],
+    examples: [
+        { command: 'monomind hooks transfer store download -n seraphine-genesis', description: 'Download pattern' },
+        { command: 'monomind hooks transfer store download -n seraphine-genesis --import', description: 'Download and import' },
+    ],
+    action: async (ctx) => {
+        const patternName = (ctx.args[0] || ctx.flags.name);
+        if (!patternName) {
+            output.printError('Pattern name is required. Use --name or -n flag.');
+            return { success: false, exitCode: 1 };
+        }
+        const spinner = output.createSpinner({ text: 'Finding pattern...', spinner: 'dots' });
+        spinner.start();
+        try {
+            const discovery = createDiscoveryService();
+            const result = await discovery.discoverRegistry();
+            if (!result.success || !result.registry) {
+                spinner.fail('Failed to discover registry');
+                return { success: false, exitCode: 1 };
+            }
+            // Find pattern by name or ID
+            const pattern = result.registry.patterns.find(p => p.name === patternName || p.id === patternName || p.displayName === patternName);
+            if (!pattern) {
+                spinner.fail(`Pattern not found: ${patternName}`);
+                return { success: false, exitCode: 1 };
+            }
+            spinner.setText(`Downloading ${pattern.displayName}...`);
+            const downloader = createDownloader();
+            const downloadResult = await downloader.downloadPattern(pattern, {
+                output: ctx.flags.output,
+                verify: ctx.flags.verify,
+                import: ctx.flags.import,
+            }, (progress) => {
+                spinner.setText(`Downloading... ${progress.percentage}%`);
+            });
+            if (!downloadResult.success) {
+                spinner.fail('Download failed');
+                return { success: false, exitCode: 1 };
+            }
+            spinner.succeed(`Downloaded ${pattern.displayName}`);
+            output.writeln();
+            output.printBox([
+                `Pattern: ${pattern.displayName}`,
+                `Version: ${pattern.version}`,
+                `Size: ${downloadResult.size.toLocaleString()} bytes`,
+                `Verified: ${downloadResult.verified ? 'Yes' : 'No'}`,
+                downloadResult.outputPath ? `Path: ${downloadResult.outputPath}` : '',
+                downloadResult.imported ? 'Status: Imported' : '',
+            ].filter(Boolean).join('\n'), 'Download Complete');
+            return { success: true, data: downloadResult };
+        }
+        catch (error) {
+            spinner.fail('Download failed');
+            output.printError(String(error));
+            return { success: false, exitCode: 1 };
+        }
+    },
+};
+// Store publish subcommand
+export const storePublishCommand = {
+    name: 'publish',
+    aliases: ['contribute'],
+    description: 'Publish a pattern to the decentralized registry',
+    options: [
+        { name: 'input', short: 'i', type: 'string', description: 'Input CFP file path', required: true },
+        { name: 'name', short: 'n', type: 'string', description: 'Pattern name', required: true },
+        { name: 'description', short: 'd', type: 'string', description: 'Pattern description', required: true },
+        { name: 'categories', short: 'c', type: 'string', description: 'Categories (comma-separated)', required: true },
+        { name: 'tags', short: 't', type: 'string', description: 'Tags (comma-separated)', required: true },
+        { name: 'license', short: 'l', type: 'string', description: 'SPDX license', default: 'MIT' },
+        { name: 'anonymize', short: 'a', type: 'string', description: 'Anonymization level', default: 'strict' },
+        { name: 'language', type: 'string', description: 'Primary language' },
+        { name: 'framework', type: 'string', description: 'Primary framework' },
+    ],
+    examples: [
+        { command: 'monomind hooks transfer store publish -i patterns.cfp -n my-patterns -d "My patterns" -c routing -t custom', description: 'Publish pattern' },
+    ],
+    action: async (ctx) => {
+        const inputPath = ctx.flags.input;
+        const name = ctx.flags.name;
+        const description = ctx.flags.description;
+        if (!inputPath || !name || !description) {
+            output.printError('Input path, name, and description are required.');
+            return { success: false, exitCode: 1 };
+        }
+        const spinner = output.createSpinner({ text: 'Preparing pattern...', spinner: 'dots' });
+        spinner.start();
+        try {
+            // Read and parse CFP file
+            const fs = await import('fs');
+            if (!fs.existsSync(inputPath)) {
+                spinner.fail(`File not found: ${inputPath}`);
+                return { success: false, exitCode: 1 };
+            }
+            const content = fs.readFileSync(inputPath, 'utf-8');
+            const cfp = JSON.parse(content);
+            spinner.setText('Publishing to IPFS...');
+            const publisher = createPublisher();
+            const result = await publisher.publishPattern(cfp, {
+                name,
+                displayName: name.replace(/-/g, ' ').replace(/\b\w/g, c => c.toUpperCase()),
+                description,
+                categories: ctx.flags.categories.split(',').map(s => s.trim()),
+                tags: ctx.flags.tags.split(',').map(s => s.trim()),
+                license: ctx.flags.license || 'MIT',
+                anonymize: ctx.flags.anonymize || 'strict',
+                language: ctx.flags.language,
+                framework: ctx.flags.framework,
+            });
+            if (!result.success) {
+                spinner.fail('Publish failed');
+                output.printError(result.message);
+                return { success: false, exitCode: 1 };
+            }
+            spinner.succeed('Pattern published!');
+            output.writeln();
+            output.printBox([
+                `Pattern ID: ${result.patternId}`,
+                `CID: ${result.cid}`,
+                `Gateway URL: ${result.gatewayUrl}`,
+                ``,
+                `Your pattern has been uploaded to IPFS.`,
+                `Submit a contribution request to add it to the official registry.`,
+            ].join('\n'), 'Publish Complete');
+            return { success: true, data: result };
+        }
+        catch (error) {
+            spinner.fail('Publish failed');
+            output.printError(String(error));
+            return { success: false, exitCode: 1 };
+        }
+    },
+};
+// Store info subcommand
+export const storeInfoCommand = {
+    name: 'info',
+    description: 'Show detailed information about a pattern',
+    options: [
+        { name: 'name', short: 'n', type: 'string', description: 'Pattern name or ID', required: true },
+    ],
+    examples: [
+        { command: 'monomind hooks transfer store info -n seraphine-genesis', description: 'Show pattern info' },
+    ],
+    action: async (ctx) => {
+        const patternName = (ctx.args[0] || ctx.flags.name);
+        if (!patternName) {
+            output.printError('Pattern name is required. Use --name or -n flag.');
+            return { success: false, exitCode: 1 };
+        }
+        const spinner = output.createSpinner({ text: 'Fetching pattern info...', spinner: 'dots' });
+        spinner.start();
+        try {
+            const discovery = createDiscoveryService();
+            const result = await discovery.discoverRegistry();
+            if (!result.success || !result.registry) {
+                spinner.fail('Failed to discover registry');
+                return { success: false, exitCode: 1 };
+            }
+            const pattern = result.registry.patterns.find(p => p.name === patternName || p.id === patternName || p.displayName === patternName);
+            if (!pattern) {
+                spinner.fail(`Pattern not found: ${patternName}`);
+                return { success: false, exitCode: 1 };
+            }
+            spinner.succeed('Pattern found');
+            output.writeln();
+            output.printBox([
+                `Name: ${pattern.displayName}`,
+                `ID: ${pattern.id}`,
+                `Version: ${pattern.version}`,
+                ``,
+                `Description:`,
+                `  ${pattern.description}`,
+                ``,
+                `Author: ${pattern.author.displayName || pattern.author.id}`,
+                `License: ${pattern.license}`,
+                ``,
+                `Categories: ${pattern.categories.join(', ')}`,
+                `Tags: ${pattern.tags.join(', ')}`,
+                ``,
+                `Stats:`,
+                `  Downloads: ${pattern.downloads.toLocaleString()}`,
+                `  Rating: ${pattern.rating.toFixed(1)}/5 (${pattern.ratingCount} reviews)`,
+                ``,
+                `IPFS:`,
+                `  CID: ${pattern.cid}`,
+                `  Size: ${pattern.size.toLocaleString()} bytes`,
+                `  Checksum: ${pattern.checksum.slice(0, 16)}...`,
+                ``,
+                `Trust: ${pattern.trustLevel}`,
+                `Verified: ${pattern.verified ? 'Yes' : 'No'}`,
+                `Min Version: ${pattern.minMonomindVersion}`,
+                ``,
+                `Created: ${pattern.createdAt}`,
+                `Updated: ${pattern.lastUpdated}`,
+            ].join('\n'), 'Pattern Details');
+            return { success: true, data: pattern };
+        }
+        catch (error) {
+            spinner.fail('Error fetching pattern info');
+            output.printError(String(error));
+            return { success: false, exitCode: 1 };
+        }
+    },
+};
+// Main store command
+export const storeCommand = {
+    name: 'store',
+    description: 'Pattern marketplace - list, search, download, publish',
+    subcommands: [
+        storeListCommand,
+        storeSearchCommand,
+        storeDownloadCommand,
+        storePublishCommand,
+        storeInfoCommand,
+    ],
+    examples: [
+        { command: 'monomind hooks transfer store list', description: 'List patterns' },
+        { command: 'monomind hooks transfer store search -q "routing"', description: 'Search patterns' },
+        { command: 'monomind hooks transfer store download -n seraphine-genesis', description: 'Download pattern' },
+        { command: 'monomind hooks transfer store publish -i patterns.cfp ...', description: 'Publish pattern' },
+    ],
+    action: async () => {
+        output.writeln();
+        output.writeln(output.bold('MonoMind Pattern Store'));
+        output.writeln(output.dim('Decentralized pattern marketplace via IPFS'));
+        output.writeln();
+        output.writeln('Subcommands:');
+        output.printList([
+            'list      - List patterns from registry',
+            'search    - Search patterns',
+            'download  - Download a pattern',
+            'publish   - Publish a pattern',
+            'info      - Show pattern details',
+        ]);
+        output.writeln();
+        output.writeln('Example:');
+        output.writeln(output.dim('  monomind hooks transfer store list --featured'));
+        output.writeln(output.dim('  monomind hooks transfer store search -q "routing"'));
+        output.writeln(output.dim('  monomind hooks transfer store download -n seraphine-genesis'));
+        return { success: true };
+    },
+};
+export default storeCommand;
+//# sourceMappingURL=transfer-store.js.map

package/packages/@monomind/cli/dist/src/commands/ui.js

@@ -0,0 +1,68 @@
+/**
+ * monomind ui — Live dashboard command
+ * Starts a local HTTP server serving the Neural Control Room dashboard.
+ */
+import * as path from 'path';
+import * as os from 'os';
+
+export const uiCommand = {
+  name: 'ui',
+  description: 'Start the live Monomind dashboard (Neural Control Room)',
+  category: 'core',
+  async action(ctx) {
+    return this.execute(ctx.args || [], ctx.flags || {});
+  },
+  async execute(args = [], options = {}) {
+    const port = parseInt(options.port || options.p || '4242', 10);
+    const noOpen = options['no-open'] || options['no-browser'] || false;
+    const projectDir = options.dir || process.env.CLAUDE_PROJECT_DIR || process.cwd();
+
+    console.log('\x1b[36m◆ Monomind Neural Control Room\x1b[0m');
+    console.log('\x1b[2mStarting dashboard server...\x1b[0m\n');
+
+    try {
+      const { fileURLToPath } = await import('url');
+      const { dirname } = await import('path');
+      const { createRequire } = await import('module');
+      const serverPath = new URL('../ui/server.mjs', import.meta.url);
+      const { startServer } = await import(serverPath.href);
+
+      const result = await startServer({
+        port,
+        projectDir,
+        openBrowser: !noOpen,
+      });
+
+      console.log(`\x1b[32m✓ Dashboard running at \x1b[1m${result.url}\x1b[0m`);
+      console.log(`\x1b[2m  Project: ${projectDir}\x1b[0m`);
+      console.log(`\x1b[2m  Press Ctrl+C to stop\x1b[0m\n`);
+
+      // Keep alive
+      await new Promise((resolve) => {
+        process.on('SIGINT', resolve);
+        process.on('SIGTERM', resolve);
+      });
+    } catch (err) {
+      console.error(`\x1b[31m✗ Failed to start dashboard: ${err.message}\x1b[0m`);
+      if (process.env.DEBUG) console.error(err.stack);
+      process.exit(1);
+    }
+  },
+  help() {
+    return `
+\x1b[1mUsage:\x1b[0m  monomind ui [options]
+
+\x1b[1mOptions:\x1b[0m
+  --port, -p <number>   Port to listen on (default: 4242)
+  --no-open             Don't open browser automatically
+  --dir <path>          Project directory to monitor (default: cwd)
+
+\x1b[1mExamples:\x1b[0m
+  monomind ui
+  monomind ui --port 8080
+  monomind ui --no-open --dir /path/to/project
+    `.trim();
+  },
+};
+
+export default uiCommand;

package/packages/@monomind/cli/dist/src/commands/update.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI Update Command
+ * Auto-update system for @monoes packages (ADR-025)
+ */
+import type { Command } from '../types.js';
+declare const updateCommand: Command;
+export default updateCommand;
+//# sourceMappingURL=update.d.ts.map