Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

feat(ruflo-console): separate the nav's menu, groups, search and pages with a bar (0.25.1) (#3664)

rUv4401c87d6d32
diff --git a/plugins/ruflo-console/.claude-plugin/plugin.json b/plugins/ruflo-console/.claude-plugin/plugin.json
index 9037789387..08b0649147 100644
--- a/plugins/ruflo-console/.claude-plugin/plugin.json
+++ b/plugins/ruflo-console/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "ruflo-console",
"description": "ruflo's cockpit inside Claude Code and the one /ruflo command for every ruflo mod (function hooks, early access). Views: overview with health alerts, swarm topology graph, claims flow with TTL rings, federation map, plugin health matrix, learning curve and pipeline, MetaHarness radar and audit trend, memory, cost gauge, agent timeline, approvals queue, event stream, a main menu, an x.ruv.io federation board, an AI terminal (codex, claude or both in remembered sessions, streamed), Skills (npx skills), a Hive-Mind view, a MetaHarness lab, agent drill-down; a command palette for confirm-gated actions through the ruflo CLI; a band above the prompt. Reads ruflo's files and the CLI's local JSON; anything not measured reads n/a. The one network call it makes by itself is a daily read of the published plugin.json at github.com/ruvnet/ruflo to offer an update (Settings β†’ Updates: ask, auto, or off); it installs only through Claude Code's own claude plugin update, and never a new major version without asking.",
- "version": "0.44.5",
+ "version": "0.44.6",
"author": {
"name": "ruvnet",
"url": "https://github.com/ruvnet"
diff --git a/plugins/ruflo-console/CHANGELOG.md b/plugins/ruflo-console/CHANGELOG.md
index f460dfc4e7..af6b013e1b 100644
--- a/plugins/ruflo-console/CHANGELOG.md
+++ b/plugins/ruflo-console/CHANGELOG.md
@@ -2,6 +2,9 @@
Newest first. One `## <version> β€” <date>` heading per version, then `feat:`, `fix:`, `breaking:` and `chore:` bullets (ADR-478). Built from git history; older versions: `git log -- plugins/ruflo-console`.
+## 0.44.6 β€” 2026-10-20
+- feat: the compact nav's menu, groups, search and page tabs are now separated by a dim `β”‚` bar instead of just a gap, so a row of chips and tabs reads as distinct items rather than running together (#3664).
+
## 0.44.5 β€” 2026-10-20
- fix: the standalone terminal console (`npx ruflo tui`) now shows a one-line notice on the first frame when mouse support is off (it's opt-in by design) and how to turn it on with `--mouse`, instead of clicking silently doing nothing (#4305).
- fix: the footer's `0 menu` key hint no longer disappears below 80 columns (a common tmux/editor-pane width) β€” a new footer tier keeps it visible down to 62 columns (#4305).
diff --git a/plugins/ruflo-console/hooks/version.ts b/plugins/ruflo-console/hooks/version.ts
index b5ec56aadb..69282d0b15 100644
--- a/plugins/ruflo-console/hooks/version.ts
+++ b/plugins/ruflo-console/hooks/version.ts
@@ -2,4 +2,4 @@
* The console's version, shown on the header so a person can tell which build is running. Kept equal to the plugin's manifest
* (`.claude-plugin/plugin.json`); tests/version.spec.ts fails if the two drift.
*/
-export const CONSOLE_VERSION = '0.44.5'
+export const CONSOLE_VERSION = '0.44.6'
diff --git a/plugins/ruflo-console/hooks/views/nav.ts b/plugins/ruflo-console/hooks/views/nav.ts
index ad7724a576..414f8ecfab 100644
--- a/plugins/ruflo-console/hooks/views/nav.ts
+++ b/plugins/ruflo-console/hooks/views/nav.ts
@@ -44,7 +44,8 @@ export function groupedTabs(ctx: Ctx, hasHotkey: (view: View) => boolean): Rende
const nameOf = (view: View) => (view.id === 'menu' && inner < 72 ? 'Menu' : view.label)
const openName = (view: View) => (isBbs() ? `[${view.key === '' ? '' : `${view.key}: `}${view.icon} ${nameOf(view).toUpperCase()}]` : `${view.key === '' ? '' : `${view.key}: `}${view.icon} ${nameOf(view)}`)
const cells = (view: View, form: string) => (view.id === open ? openName(view).length + 1 : (hasHotkey(view) && view.key !== '' ? 3 : 0) + spell(view, form).length + badgeText(view).length + 3)
- const widest = (form: string) => Math.max(0, ...pages.map(ids => ids.reduce((sum, id) => sum + (find(id) === undefined ? 0 : cells(find(id) as View, form)), 0)))
+ // A row's width: its pages, plus the gap and bar between each two (2 columns).
+ const widest = (form: string) => Math.max(0, ...pages.map(ids => ids.reduce((sum, id) => sum + (find(id) === undefined ? 0 : cells(find(id) as View, form)), 0) + 2 * Math.max(0, ids.length - 1)))
// auto: the richest form whose widest row fits the page; the others are the person's choice (Settings).
const form = state.nav === 'auto' ? (['full', 'brief'].find(candidate => widest(candidate) <= inner) ?? 'icons') : state.nav
@@ -54,7 +55,7 @@ export function groupedTabs(ctx: Ctx, hasHotkey: (view: View) => boolean): Rende
? pages
: pages.flat().reduce<ViewId[][]>((rows, id) => {
const last = rows.at(-1)
- const width = (ids: readonly ViewId[]) => ids.reduce((sum, each) => sum + (find(each) === undefined ? 0 : cells(find(each) as View, form)), 0)
+ const width = (ids: readonly ViewId[]) => ids.reduce((sum, each) => sum + (find(each) === undefined ? 0 : cells(find(each) as View, form)), 0) + 2 * Math.max(0, ids.length - 1)
if (last !== undefined && width([...last, id]) <= inner) last.push(id)
else rows.push([id])
@@ -77,7 +78,8 @@ export function groupedTabs(ctx: Ctx, hasHotkey: (view: View) => boolean): Rende
const menu = find('menu')
// The group chips spell their icon only where the row has room; the search field shares their row only where it fits, else it has its own.
const icons = inner >= 130
- const chipCells = NAV_GROUPS.reduce((sum, group) => sum + group.title.length + (icons ? 5 : 3), 12)
+ // Each group takes its label, its gap and the bar that follows it (2 columns).
+ const chipCells = NAV_GROUPS.reduce((sum, group) => sum + group.title.length + (icons ? 5 : 3) + 2, 12)
const isSearchInline = inner - chipCells >= 28
const chips = NAV_GROUPS.map(group =>
group.title === shown && found === null && !isMenuIdle
@@ -89,18 +91,23 @@ export function groupedTabs(ctx: Ctx, hasHotkey: (view: View) => boolean): Rende
const Input = ctx.kit.Input
const search = Input === undefined ? [] : [Input({ key: 'nav-find', label: 'πŸ”Ž', placeholder: 'find a page', submitLabel: 'go', onSubmit: (value: string) => ctx.act.navigator.find(value) })]
const clear = query === '' ? [] : [ctx.kit.Button({ key: 'nav-find-clear', label: ' βœ• ', plain: true, dimColor: true, onPress: () => ctx.act.navigator.clear() })]
+ // A dim bar between the things on a row: the menu, each group and the search. The bar is one column with the row's gap either side.
+ const bar = (key: string) => ctx.kit.Text({ key, dimColor: true, color: THEME.info, children: 'β”‚' })
+ const menuCell = menu === undefined ? ctx.kit.Text({ children: '' }) : open === 'menu' ? tab(menu) : ctx.kit.Button({ key: 'tab-menu', label: ' πŸ“Ÿ MAIN ', plain: true, hotkey: '0', onPress: () => ctx.act.view('menu') })
+ const groupCells = chips.flatMap((chip, i) => [bar(`nav-bar-${i}`), chip])
+ const searchCells = isSearchInline ? [bar('nav-bar-find'), ...closePick, ...search, ...clear] : []
const head = ctx.kit.Box({
flexDirection: 'row',
gap: 1,
key: 'tabs-groups',
- children: [menu === undefined ? ctx.kit.Text({ children: '' }) : open === 'menu' ? tab(menu) : ctx.kit.Button({ key: 'tab-menu', label: ' πŸ“Ÿ MAIN ', plain: true, hotkey: '0', onPress: () => ctx.act.view('menu') }), ...chips, ...(isSearchInline ? closePick : []), ...(isSearchInline ? [...search, ...clear] : [])],
+ children: [menuCell, ...groupCells, ...searchCells],
})
const findRow = isSearchInline ? [] : [ctx.kit.Box({ flexDirection: 'row', gap: 1, key: 'tabs-find', children: [...search, ...clear, ...closePick] })]
const lines =
found !== null && found.length === 0
? [ctx.kit.Text({ dimColor: true, children: ` no page matches β€œ${query}” β€” try a name, a group or what it does` })]
: laid.map((ids, i) =>
- ctx.kit.Box({ flexDirection: 'row', gap: 1, key: `tabs-row-${i}`, children: ids.flatMap(id => (find(id) === undefined ? [] : [tab(find(id) as View)])) }),
+ ctx.kit.Box({ flexDirection: 'row', gap: 1, key: `tabs-row-${i}`, children: ids.flatMap((id, j) => (find(id) === undefined ? [] : [...(j > 0 ? [bar(`nav-page-bar-${i}-${j}`)] : []), tab(find(id) as View)])) }),
)
const note = found === null ? [] : [ctx.kit.Text({ dimColor: true, children: ` ${found.length} found for β€œ${query}”${found.length === 1 ? '' : ' β€” Enter again on one name opens it'}` })]
diff --git a/plugins/ruflo-console/scripts/smoke.sh b/plugins/ruflo-console/scripts/smoke.sh
index 2be2aecb3a..bedff6355c 100755
--- a/plugins/ruflo-console/scripts/smoke.sh
+++ b/plugins/ruflo-console/scripts/smoke.sh
@@ -11,9 +11,9 @@ step() { printf "β†’ %s ... " "$1"; }
ok() { printf "PASS\n"; PASS=$((PASS+1)); }
bad() { printf "FAIL: %s\n" "$1"; FAIL=$((FAIL+1)); }
-step "1. plugin.json declares ruflo-console 0.44.5"
+step "1. plugin.json declares ruflo-console 0.44.6"
grep -q '"name": "ruflo-console"' "$ROOT/.claude-plugin/plugin.json" \
- && grep -q '"version": "0.44.5"' "$ROOT/.claude-plugin/plugin.json" && ok || bad "name/version"
+ && grep -q '"version": "0.44.6"' "$ROOT/.claude-plugin/plugin.json" && ok || bad "name/version"
step "2. hooks.json names exactly one module and no classic hook commands"
grep -q '"modules": \["./register.ts"\]' "$HOOKS/hooks.json" && ! grep -q '"command"' "$HOOKS/hooks.json" \
diff --git a/plugins/ruflo-console/tests/nav.test.ts b/plugins/ruflo-console/tests/nav.test.ts
index 4d43e5ff52..13ced0d53a 100644
--- a/plugins/ruflo-console/tests/nav.test.ts
+++ b/plugins/ruflo-console/tests/nav.test.ts
@@ -33,6 +33,9 @@ describe('the compact nav', () => {
expect(keys(first)).toEqual(expect.arrayContaining(['nav-group-MIND', 'nav-group-SAFETY', 'nav-group-NETWORK', 'nav-group-TOOLS', 'tab-menu']))
// The open group's pages are in the card; another group's pages are there too but hidden, so their hotkeys still work.
expect(textOf(first)).toContain('[SWARM β–Ύ]')
+ // A bar sits between the menu and each group, and between pages on a row: the groups read as separate, not run together.
+ expect(keys(first)).toEqual(expect.arrayContaining(['nav-bar-0', 'nav-bar-1']))
+ expect(textOf(first)).toContain('β”‚')
expect(keys(first)).toEqual(expect.arrayContaining(['tab-missions', 'tab-hive', 'tab-learning', 'tab-memory']))
await pane.press({ key: 'nav-group-MIND' })
diff --git a/v3/docs/adr/ADR-424-console-compact-nav-with-search.md b/v3/docs/adr/ADR-424-console-compact-nav-with-search.md
index 2635b2e05d..723e9caf8d 100644
--- a/v3/docs/adr/ADR-424-console-compact-nav-with-search.md
+++ b/v3/docs/adr/ADR-424-console-compact-nav-with-search.md
@@ -1,9 +1,11 @@
# ADR 424: A compact nav: groups, one group's pages, and a search
-Status: Accepted (ships in ruflo-console 0.25.0)
+Status: Accepted (ships in ruflo-console 0.25.0; separators amended in 0.25.1)
Date: 2026 10 03
+Amendment (0.25.1): the nav's pieces are separated by a dim `β”‚`: between the menu, each group and the search on row 1, and between the pages on rows 2 and 3. Each bar sits in the row's gap, so the row's width now counts one column per bar. The separators are presentation only; the groups, the pages, the hotkeys and the search are unchanged.
+
Decision owner: Ruflo maintainers
Scope: `plugins/ruflo-console`: `hooks/nav-state.ts`, `hooks/views/nav.ts`, `hooks/state.ts` (`navPick`, `navQuery`), `hooks/bindings.ts`, `tests/nav-state.spec.ts`, `tests/nav.test.ts`.