@positronic/cli 0.0.51 → 0.0.52

package/dist/src/cli.js

@@ -421,7 +421,10 @@ export function buildCli(options) {
         render(element);
     });
     // --- Run Brain Command ---
-    cli = cli.command('run <brain>', 'Run a brain and optionally watch its execution\n', function(yargsRun) {
+    cli = cli.command([
+        'run <brain>',
+        'r <brain>'
+    ], 'Run a brain and optionally watch its execution\n', function(yargsRun) {
         return yargsRun.positional('brain', {
             describe: 'Brain identifier (title, filename, or search term)',
             type: 'string',
@@ -443,41 +446,25 @@ export function buildCli(options) {
         render(element);
     });
     // --- Watch Brain Run Command ---
-    cli = cli.command('watch [brain]', 'Watch a brain run: latest by brain name (default) or specific by ID\n', function(yargsWatch) {
-        return yargsWatch.positional('brain', {
-            describe: 'Brain identifier to watch (watches the most recent active run)',
-            type: 'string'
-        }).option('run-id', {
-            describe: 'ID of the specific brain run to watch',
+    cli = cli.command('watch <identifier>', 'Watch a brain run by brain name or run ID\n', function(yargsWatch) {
+        return yargsWatch.positional('identifier', {
+            describe: 'Brain name or run ID to watch',
             type: 'string',
-            alias: 'id'
-        }).conflicts('brain', 'run-id').check(function(argv) {
-            if (!argv.brain && !argv.runId) {
-                throw new Error('You must provide either a brain identifier or a --run-id.');
-            }
-            return true;
-        }).example('$0 watch my-brain', "Watch the latest run of the brain named 'my-brain'").example('$0 watch --run-id abc123def', 'Watch a specific brain run by its ID');
+            demandOption: true
+        }).example('$0 watch my-brain', "Watch the latest run of the brain named 'my-brain'").example('$0 watch abc123def', 'Watch a specific brain run by its ID');
     }, function(argv) {
-        return _async_to_generator(function() {
-            var element;
-            return _ts_generator(this, function(_state) {
-                switch(_state.label){
-                    case 0:
-                        return [
-                            4,
-                            brainCommand.watch(argv)
-                        ];
-                    case 1:
-                        element = _state.sent();
-                        if (element) {
-                            render(element);
-                        }
-                        return [
-                            2
-                        ];
-                }
-            });
-        })();
+        var element = brainCommand.watch(argv);
+        render(element);
+    });
+    // --- Top Command (view running brains) ---
+    cli = cli.command('top [brain]', 'View live status of all running brains\n', function(yargsTop) {
+        return yargsTop.positional('brain', {
+            describe: 'Filter to brains matching this name',
+            type: 'string'
+        }).example('$0 top', 'View all running brains').example('$0 top my-brain', 'View running brains matching "my-brain"');
+    }, function(argv) {
+        var element = brainCommand.top(argv);
+        render(element);
     });
     // --- Brain Commands ---
     cli = cli.command('brain', 'Manage your brains\n', function(yargsBrain) {
@@ -556,41 +543,15 @@ export function buildCli(options) {
         }, function(argv) {
             var element = brainCommand.run(argv);
             render(element);
-        }).command('watch [brain]', 'Watch a brain run: latest by brain name (default) or specific by ID\n', function(yargsWatch) {
-            return yargsWatch.positional('brain', {
-                describe: 'Brain identifier to watch (watches the most recent active run)',
-                type: 'string'
-            }).option('run-id', {
-                describe: 'ID of the specific brain run to watch',
+        }).command('watch <identifier>', 'Watch a brain run by brain name or run ID\n', function(yargsWatch) {
+            return yargsWatch.positional('identifier', {
+                describe: 'Brain name or run ID to watch',
                 type: 'string',
-                alias: 'id'
-            }).conflicts('brain', 'run-id').check(function(argv) {
-                if (!argv.brain && !argv.runId) {
-                    throw new Error('You must provide either a brain identifier or a --run-id.');
-                }
-                return true;
-            }).example('$0 brain watch my-brain', "Watch the latest run of the brain named 'my-brain'").example('$0 brain watch --run-id abc123def', 'Watch a specific brain run by its ID');
+                demandOption: true
+            }).example('$0 brain watch my-brain', "Watch the latest run of the brain named 'my-brain'").example('$0 brain watch abc123def', 'Watch a specific brain run by its ID');
         }, function(argv) {
-            return _async_to_generator(function() {
-                var element;
-                return _ts_generator(this, function(_state) {
-                    switch(_state.label){
-                        case 0:
-                            return [
-                                4,
-                                brainCommand.watch(argv)
-                            ];
-                        case 1:
-                            element = _state.sent();
-                            if (element) {
-                                render(element);
-                            }
-                            return [
-                                2
-                            ];
-                    }
-                });
-            })();
+            var element = brainCommand.watch(argv);
+            render(element);
         }).command('kill <run-id>', 'Kill a running brain\n', function(yargsKill) {
             return yargsKill.positional('run-id', {
                 describe: 'ID of the brain run to kill',
@@ -605,7 +566,15 @@ export function buildCli(options) {
         }, function(argv) {
             var element = brainCommand.kill(argv);
             render(element);
-        }).demandCommand(1, 'You need to specify a brain command (list, history, show, rerun, run, watch, kill).');
+        }).command('top [brain]', 'View live status of all running brains\n', function(yargsTop) {
+            return yargsTop.positional('brain', {
+                describe: 'Filter to brains matching this name',
+                type: 'string'
+            }).example('$0 brain top', 'View all running brains').example('$0 brain top my-brain', 'View running brains matching "my-brain"');
+        }, function(argv) {
+            var element = brainCommand.top(argv);
+            render(element);
+        }).demandCommand(1, 'You need to specify a brain command (list, history, show, rerun, run, watch, kill, top).');
         return yargsBrain;
     });
     // --- Resource Management Commands ---

package/dist/src/commands/brain.js

@@ -18,7 +18,6 @@ function _create_class(Constructor, protoProps, staticProps) {
     return Constructor;
 }
 import React from 'react';
-import { Watch } from '../components/watch.js';
 import { BrainList } from '../components/brain-list.js';
 import { BrainHistory } from '../components/brain-history.js';
 import { RunShow } from '../components/run-show.js';
@@ -27,7 +26,8 @@ import { BrainRerun } from '../components/brain-rerun.js';
 import { BrainKill } from '../components/brain-kill.js';
 import { BrainRun } from '../components/brain-run.js';
 import { BrainResolver } from '../components/brain-resolver.js';
-import { BrainWatchWithResolver } from '../components/brain-watch.js';
+import { WatchResolver } from '../components/watch-resolver.js';
+import { TopNavigator } from '../components/top-navigator.js';
 import { ErrorComponent } from '../components/error.js';
 export var BrainCommand = /*#__PURE__*/ function() {
     "use strict";
@@ -114,27 +114,9 @@ export var BrainCommand = /*#__PURE__*/ function() {
         {
             key: "watch",
             value: function watch(param) {
-                var runId = param.runId, brain = param.brain;
-                // If a specific run ID is provided, return the Watch component
-                if (runId) {
-                    return React.createElement(Watch, {
-                        runId: runId
-                    });
-                }
-                // If watching by brain identifier is requested, use BrainWatchWithResolver
-                // which handles fuzzy search, disambiguation, and active run lookup
-                if (brain) {
-                    return React.createElement(BrainWatchWithResolver, {
-                        identifier: brain
-                    });
-                }
-                // Neither runId nor brainName provided – return an error element.
-                return React.createElement(ErrorComponent, {
-                    error: {
-                        title: 'Missing Argument',
-                        message: 'You must provide either a brain run ID or a brain identifier.',
-                        details: 'Use --run-id to watch a specific run, or --brain to watch the active run of a brain.'
-                    }
+                var identifier = param.identifier;
+                return React.createElement(WatchResolver, {
+                    identifier: identifier
                 });
             }
         },
@@ -147,6 +129,15 @@ export var BrainCommand = /*#__PURE__*/ function() {
                     force: force
                 });
             }
+        },
+        {
+            key: "top",
+            value: function top(param) {
+                var brain = param.brain;
+                return React.createElement(TopNavigator, {
+                    brainFilter: brain
+                });
+            }
         }
     ]);
     return BrainCommand;

package/dist/src/commands/server.js

@@ -279,6 +279,12 @@ export var ServerCommand = /*#__PURE__*/ function() {
                                 serverHandle = null;
                                 watcher = null;
                                 logStream = null;
+                                // Restore terminal state on ANY exit - this is synchronous and guaranteed to run
+                                process.on('exit', function() {
+                                    if (process.stdin.isTTY && process.stdin.setRawMode) {
+                                        process.stdin.setRawMode(false);
+                                    }
+                                });
                                 // Always create a log file (use default if not specified)
                                 logFilePath = argv.logFile ? path.resolve(argv.logFile) : path.join(this.server.projectRootDir, '.positronic-server.log');
                                 // Ensure directory exists
@@ -314,47 +320,25 @@ export var ServerCommand = /*#__PURE__*/ function() {
                                     return logBoth('WARN', message);
                                 });
                                 cleanup = function() {
-                                    return _async_to_generator(function() {
-                                        return _ts_generator(this, function(_state) {
-                                            switch(_state.label){
-                                                case 0:
-                                                    if (!watcher) return [
-                                                        3,
-                                                        2
-                                                    ];
-                                                    return [
-                                                        4,
-                                                        watcher.close()
-                                                    ];
-                                                case 1:
-                                                    _state.sent();
-                                                    watcher = null;
-                                                    _state.label = 2;
-                                                case 2:
-                                                    if (serverHandle && !serverHandle.killed) {
-                                                        serverHandle.kill();
-                                                        serverHandle = null;
-                                                    }
-                                                    // Close log stream
-                                                    if (logStream) {
-                                                        logStream.end();
-                                                        logStream = null;
-                                                    }
-                                                    // Remove PID file
-                                                    if (fs.existsSync(pidFile)) {
-                                                        fs.unlinkSync(pidFile);
-                                                    }
-                                                    // Restore terminal from raw mode (dev server may have set it)
-                                                    if (process.stdin.isTTY && process.stdin.setRawMode) {
-                                                        process.stdin.setRawMode(false);
-                                                    }
-                                                    process.exit(0);
-                                                    return [
-                                                        2
-                                                    ];
-                                            }
-                                        });
-                                    })();
+                                    if (watcher) {
+                                        watcher.close();
+                                        watcher = null;
+                                    }
+                                    if (serverHandle && !serverHandle.killed) {
+                                        serverHandle.kill();
+                                        serverHandle = null;
+                                    }
+                                    // Close log stream
+                                    if (logStream) {
+                                        logStream.end();
+                                        logStream = null;
+                                    }
+                                    // Remove PID file
+                                    if (fs.existsSync(pidFile)) {
+                                        fs.unlinkSync(pidFile);
+                                    }
+                                    // Terminal is restored by process.on('exit') handler
+                                    process.exit(0);
                                 };
                                 process.on('SIGINT', cleanup); // Catches Ctrl+C
                                 process.on('SIGTERM', cleanup); // Catches kill commands
@@ -385,6 +369,7 @@ export var ServerCommand = /*#__PURE__*/ function() {
                                         watcher.close();
                                         watcher = null;
                                     }
+                                    // Terminal is restored by process.on('exit') handler
                                     process.exit(code !== null && code !== void 0 ? code : 1); // Exit with server's code or 1 if null
                                 });
                                 serverHandle.onError(function(err) {
@@ -393,6 +378,7 @@ export var ServerCommand = /*#__PURE__*/ function() {
                                         watcher.close();
                                         watcher = null;
                                     }
+                                    // Terminal is restored by process.on('exit') handler
                                     process.exit(1);
                                 });
                                 return [
@@ -407,6 +393,7 @@ export var ServerCommand = /*#__PURE__*/ function() {
                                     if (serverHandle && !serverHandle.killed) {
                                         serverHandle.kill();
                                     }
+                                    // Terminal is restored by process.on('exit') handler
                                     process.exit(1);
                                 }
                                 _state.label = 5;

package/dist/src/components/brain-rerun.js

@@ -300,7 +300,7 @@ export var BrainRerun = function(param) {
         marginTop: 1
     }, /*#__PURE__*/ React.createElement(Text, {
         dimColor: true
-    }, "Watch the run with: positronic watch --run-id ", newRunId))) : /*#__PURE__*/ React.createElement(Text, {
+    }, "Watch the run with: positronic watch ", newRunId))) : /*#__PURE__*/ React.createElement(Text, {
         color: "red"
     }, "❌ Unexpected error occurred"));
 };

package/dist/src/components/brain-resolver.js

@@ -217,8 +217,9 @@ function _ts_generator(thisArg, body) {
     }
 }
 import React, { useState, useEffect, useCallback } from 'react';
-import { Box, Text, useInput, useApp } from 'ink';
+import { Box, Text } from 'ink';
 import { ErrorComponent } from './error.js';
+import { SelectList } from './select-list.js';
 import { apiClient, isApiLocalDevMode } from '../commands/helpers.js';
 /**
  * BrainResolver - A reusable component that resolves a brain identifier to a title.
@@ -231,10 +232,8 @@ import { apiClient, isApiLocalDevMode } from '../commands/helpers.js';
     var identifier = param.identifier, children = param.children;
     var _useState = _sliced_to_array(useState('searching'), 2), phase = _useState[0], setPhase = _useState[1];
     var _useState1 = _sliced_to_array(useState([]), 2), brains = _useState1[0], setBrains = _useState1[1];
-    var _useState2 = _sliced_to_array(useState(0), 2), selectedIndex = _useState2[0], setSelectedIndex = _useState2[1];
-    var _useState3 = _sliced_to_array(useState(null), 2), resolvedTitle = _useState3[0], setResolvedTitle = _useState3[1];
-    var _useState4 = _sliced_to_array(useState(null), 2), error = _useState4[0], setError = _useState4[1];
-    var exit = useApp().exit;
+    var _useState2 = _sliced_to_array(useState(null), 2), resolvedTitle = _useState2[0], setResolvedTitle = _useState2[1];
+    var _useState3 = _sliced_to_array(useState(null), 2), error = _useState3[0], setError = _useState3[1];
     var getConnectionError = useCallback(function() {
         if (isApiLocalDevMode()) {
             return {
@@ -343,25 +342,6 @@ import { apiClient, isApiLocalDevMode } from '../commands/helpers.js';
         identifier,
         getConnectionError
     ]);
-    // Handle keyboard input for disambiguation
-    useInput(function(input, key) {
-        if (phase !== 'disambiguating') return;
-        if (key.upArrow) {
-            setSelectedIndex(function(prev) {
-                return (prev - 1 + brains.length) % brains.length;
-            });
-        } else if (key.downArrow) {
-            setSelectedIndex(function(prev) {
-                return (prev + 1) % brains.length;
-            });
-        } else if (key.return) {
-            var selectedBrain = brains[selectedIndex];
-            setResolvedTitle(selectedBrain.title);
-            setPhase('resolved');
-        } else if (input === 'q' || key.escape) {
-            exit();
-        }
-    });
     // Render based on phase
     if (phase === 'searching') {
         return /*#__PURE__*/ React.createElement(Box, null, /*#__PURE__*/ React.createElement(Text, null, "Searching for brain '", identifier, "'..."));
@@ -372,31 +352,20 @@ import { apiClient, isApiLocalDevMode } from '../commands/helpers.js';
         });
     }
     if (phase === 'disambiguating') {
-        return /*#__PURE__*/ React.createElement(Box, {
-            flexDirection: "column"
-        }, /*#__PURE__*/ React.createElement(Text, {
-            bold: true
-        }, "Multiple brains match '", identifier, "':"), /*#__PURE__*/ React.createElement(Box, {
-            marginTop: 1,
-            flexDirection: "column"
-        }, brains.map(function(brain, index) {
-            var isSelected = index === selectedIndex;
-            return /*#__PURE__*/ React.createElement(Box, {
-                key: brain.title,
-                flexDirection: "column",
-                marginBottom: 1
-            }, /*#__PURE__*/ React.createElement(Text, {
-                color: isSelected ? 'cyan' : undefined
-            }, isSelected ? '▶ ' : '  ', /*#__PURE__*/ React.createElement(Text, {
-                bold: true
-            }, brain.title)), /*#__PURE__*/ React.createElement(Text, {
-                dimColor: true
-            }, '    ', brain.description));
-        })), /*#__PURE__*/ React.createElement(Box, {
-            marginTop: 1
-        }, /*#__PURE__*/ React.createElement(Text, {
-            dimColor: true
-        }, "Use arrow keys to navigate, Enter to select, q to quit")));
+        return /*#__PURE__*/ React.createElement(SelectList, {
+            items: brains.map(function(b) {
+                return {
+                    id: b.title,
+                    label: b.title,
+                    description: b.description
+                };
+            }),
+            header: "Multiple brains match '".concat(identifier, "':"),
+            onSelect: function(item) {
+                setResolvedTitle(item.label);
+                setPhase('resolved');
+            }
+        });
     }
     if (phase === 'resolved' && resolvedTitle) {
         return /*#__PURE__*/ React.createElement(React.Fragment, null, children(resolvedTitle));

package/dist/src/components/brain-run.js

@@ -217,17 +217,17 @@ function _ts_generator(thisArg, body) {
     }
 }
 import React, { useState, useEffect, useCallback } from 'react';
-import { Box, Text, useInput, useApp } from 'ink';
+import { Box, Text, useApp } from 'ink';
 import { ErrorComponent } from './error.js';
+import { SelectList } from './select-list.js';
 import { Watch } from './watch.js';
 import { apiClient, isApiLocalDevMode } from '../commands/helpers.js';
 export var BrainRun = function(param) {
     var identifier = param.identifier, watch = param.watch, options = param.options;
     var _useState = _sliced_to_array(useState('searching'), 2), phase = _useState[0], setPhase = _useState[1];
     var _useState1 = _sliced_to_array(useState([]), 2), brains = _useState1[0], setBrains = _useState1[1];
-    var _useState2 = _sliced_to_array(useState(0), 2), selectedIndex = _useState2[0], setSelectedIndex = _useState2[1];
-    var _useState3 = _sliced_to_array(useState(null), 2), runId = _useState3[0], setRunId = _useState3[1];
-    var _useState4 = _sliced_to_array(useState(null), 2), error = _useState4[0], setError = _useState4[1];
+    var _useState2 = _sliced_to_array(useState(null), 2), runId = _useState2[0], setRunId = _useState2[1];
+    var _useState3 = _sliced_to_array(useState(null), 2), error = _useState3[0], setError = _useState3[1];
     var exit = useApp().exit;
     var getConnectionError = useCallback(function() {
         if (isApiLocalDevMode()) {
@@ -460,53 +460,36 @@ export var BrainRun = function(param) {
         runBrain,
         getConnectionError
     ]);
-    // Handle keyboard input for disambiguation
-    useInput(function(input, key) {
-        if (phase !== 'disambiguating') return;
-        if (key.upArrow) {
-            setSelectedIndex(function(prev) {
-                return (prev - 1 + brains.length) % brains.length;
-            });
-        } else if (key.downArrow) {
-            setSelectedIndex(function(prev) {
-                return (prev + 1) % brains.length;
-            });
-        } else if (key.return) {
-            var selectedBrain = brains[selectedIndex];
-            runBrain(selectedBrain.title);
-        } else if (input === 'q' || key.escape) {
+    // Exit the app when run completes without watch mode
+    useEffect(function() {
+        if (phase === 'complete' && runId && !watch) {
             exit();
         }
-    });
+    }, [
+        phase,
+        runId,
+        watch,
+        exit
+    ]);
     // Maintain consistent Box wrapper to help Ink properly calculate
     // terminal clearing between renders (prevents appending instead of overwriting)
     return /*#__PURE__*/ React.createElement(Box, {
         flexDirection: "column"
     }, phase === 'searching' ? /*#__PURE__*/ React.createElement(Text, null, "Searching for brain '", identifier, "'...") : phase === 'error' && error ? /*#__PURE__*/ React.createElement(ErrorComponent, {
         error: error
-    }) : phase === 'disambiguating' ? /*#__PURE__*/ React.createElement(React.Fragment, null, /*#__PURE__*/ React.createElement(Text, {
-        bold: true
-    }, "Multiple brains match '", identifier, "':"), /*#__PURE__*/ React.createElement(Box, {
-        marginTop: 1,
-        flexDirection: "column"
-    }, brains.map(function(brain, index) {
-        var isSelected = index === selectedIndex;
-        return /*#__PURE__*/ React.createElement(Box, {
-            key: brain.title,
-            flexDirection: "column",
-            marginBottom: 1
-        }, /*#__PURE__*/ React.createElement(Text, {
-            color: isSelected ? 'cyan' : undefined
-        }, isSelected ? '▶ ' : '  ', /*#__PURE__*/ React.createElement(Text, {
-            bold: true
-        }, brain.title)), /*#__PURE__*/ React.createElement(Text, {
-            dimColor: true
-        }, '    ', brain.description));
-    })), /*#__PURE__*/ React.createElement(Box, {
-        marginTop: 1
-    }, /*#__PURE__*/ React.createElement(Text, {
-        dimColor: true
-    }, "Use arrow keys to navigate, Enter to select, q to quit"))) : phase === 'running' ? /*#__PURE__*/ React.createElement(Text, null, "Starting brain run...") : phase === 'complete' && runId ? watch ? /*#__PURE__*/ React.createElement(Watch, {
+    }) : phase === 'disambiguating' ? /*#__PURE__*/ React.createElement(SelectList, {
+        items: brains.map(function(b) {
+            return {
+                id: b.title,
+                label: b.title,
+                description: b.description
+            };
+        }),
+        header: "Multiple brains match '".concat(identifier, "':"),
+        onSelect: function(item) {
+            runBrain(item.label);
+        }
+    }) : phase === 'running' ? /*#__PURE__*/ React.createElement(Text, null, "Starting brain run...") : phase === 'complete' && runId ? watch ? /*#__PURE__*/ React.createElement(Watch, {
         runId: runId
     }) : /*#__PURE__*/ React.createElement(Text, null, "Run ID: ", runId) : null);
 };