π 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
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
feat(ruflo-console): 0.9.1 β pages lead with RUFLO | PAGE (animated RUFLO), menu-only banner
ruvff5221aea69c
diff --git a/plugins/ruflo-console/.claude-plugin/plugin.json b/plugins/ruflo-console/.claude-plugin/plugin.jsonindex cd195e3a5e..082ed2faf2 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; no network by default.",- "version": "0.9.0",+ "version": "0.9.1","author": {"name": "ruvnet","url": "https://github.com/ruvnet"diff --git a/plugins/ruflo-console/hooks/gfx/font.ts b/plugins/ruflo-console/hooks/gfx/font.tsindex 88643e81cd..78053f3a3c 100644--- a/plugins/ruflo-console/hooks/gfx/font.ts+++ b/plugins/ruflo-console/hooks/gfx/font.ts@@ -5,7 +5,7 @@ export const FONT: Record<string, readonly [string, string]> = {K: ['β β', 'βββ'], L: ['β ', 'βββ'], M: ['βββββ', 'β β'], N: ['ββ β', 'β ββ'], O: ['βββ', 'βββ'],P: ['βββ', 'βββ'], Q: ['βββ', 'βββ'], R: ['βββ', 'βββ'], S: ['βββ', 'βββ'], T: ['βββ', ' β '],U: ['β β', 'βββ'], V: ['β β', 'βββ'], W: ['β β', 'βββββ'], X: ['βββ', 'βββ'], Y: ['βββ', ' β '],- Z: ['βββ', 'βββ'], '.': [' ', 'β'], '-': ['ββ', ' '], ' ': [' ', ' '],+ Z: ['βββ', 'βββ'], '|': ['βββββ', 'βββββ'], '.': [' ', 'β'], '-': ['ββ', ' '], ' ': [' ', ' '],}export function bigText(text: string): [string, string] {diff --git a/plugins/ruflo-console/hooks/gfx/pictures.ts b/plugins/ruflo-console/hooks/gfx/pictures.tsindex 0c8bb54826..b9b4bf4499 100644--- a/plugins/ruflo-console/hooks/gfx/pictures.ts+++ b/plugins/ruflo-console/hooks/gfx/pictures.ts@@ -285,20 +285,32 @@ export function titlePicture(name: string, columns: number, t: number): Grid {const x0 = edge.length + 1const width = Math.max(top.length, bottom.length)const shimmer = ((t / 40) % (width + 30)) - 15+ // `RUFLO | PAGE`: the RUFLO letters move like the banner on the menu (a white glow sweeping a magenta to cyan ramp); the page's name keeps its slower coral shimmer.+ const logo = name.toLowerCase().startsWith('ruflo |') ? bigText('ruflo')[0].length : 0+ const sweep = ((t / 28) % (logo + 40)) - 20for (let y = 0; y < 2; y++) {;[...edge].forEach((ch, i) => grid.set(i, y, ch, mix(0x3a0f2e, NEON_MAGENTA, (i + 1) / edge.length)));[...(y === 0 ? top : bottom)].forEach((ch, i) => {if (ch === ' ' || x0 + i >= columns) return+ if (i < logo) {+ const lit = Math.max(0, 1 - Math.abs(i - sweep) / 4)++ grid.set(x0 + i, y, ch, mix(mix(NEON_MAGENTA, NEON_CYAN, i / Math.max(1, logo - 1)), 0xffffff, lit * 0.7))++ return+ }+const glow = Math.max(0, 1 - Math.abs(i - shimmer) / 3)grid.set(x0 + i, y, ch, mix(mix(NEON_MAGENTA, NEON_CORAL, i / Math.max(1, width - 1)), 0xffffff, glow * 0.6))})- ;[...'βββ'].forEach((ch, i) => {+ // The line closes on the ramp the other way round, βββ, mirroring how the dark βββ edge opened it.+ ;[...'βββ'].forEach((ch, i) => {const x = x0 + width + 1 + i- if (x < columns) grid.set(x, y, ch, mix(NEON_MAGENTA, 0x3a0f2e, (i + 1) / edge.length))+ if (x < columns) grid.set(x, y, ch, mix(0x3a0f2e, NEON_MAGENTA, (i + 1) / edge.length))})}diff --git a/plugins/ruflo-console/hooks/views/frames.ts b/plugins/ruflo-console/hooks/views/frames.tsindex fb1e925c2c..b702054c93 100644--- a/plugins/ruflo-console/hooks/views/frames.ts+++ b/plugins/ruflo-console/hooks/views/frames.ts@@ -127,7 +127,7 @@ export function picturesOf(state: State, columns: number, nowMs: number, t: numbreturn pictures}- if (!isCompactPane(state)) {+ if (!isCompactPane(state) && state.view === 'menu') {const project = state.cwd.split('/').filter(Boolean).at(-1) ?? ''pictures.set('header', state.options.look === 'bbs' ? bannerPicture(project, Math.min(width, 72), t) : headerPicture(`β ruflo Β· ${project}`, Math.min(width, 40), t))@@ -135,9 +135,11 @@ export function picturesOf(state: State, columns: number, nowMs: number, t: numb// BBS: every view's name as ANSI-style block art under the tabs, compact or not (the neon sign is the boot's alone).if (state.options.look === 'bbs') {- const name = state.isHelp ? 'help' : state.palette.isOpen ? 'palette' : state.view === 'agent' ? 'agent' : state.view === 'menu' ? 'ruflo bbs' : (VIEWS.find(view => view.id === state.view)?.label ?? state.view)+ const page = state.isHelp ? 'help' : state.palette.isOpen ? 'palette' : state.view === 'agent' ? 'agent' : (VIEWS.find(view => view.id === state.view)?.label ?? state.view)+ // The menu is the RUFLO board itself; every other page reads `RUFLO | PAGE`, the logo's style left of the page's name.+ const name = state.view === 'menu' && !state.isHelp && !state.palette.isOpen ? 'ruflo bbs' : `ruflo | ${page}`- pictures.set('title', titlePicture(name, Math.min(width, 80), t))+ pictures.set('title', titlePicture(name, Math.min(width, 120), t))}switch (state.view) {diff --git a/plugins/ruflo-console/hooks/views/menu.ts b/plugins/ruflo-console/hooks/views/menu.tsindex b540f99d64..0a334fcc06 100644--- a/plugins/ruflo-console/hooks/views/menu.ts+++ b/plugins/ruflo-console/hooks/views/menu.ts@@ -74,20 +74,6 @@ export function menuView(ctx: Ctx): RenderElement {const width = Math.max(24, Math.floor((ctx.columns - 1) / perRow) - 1)const rows: RenderElement[] = []- rows.push(- ctx.kit.Box({- flexDirection: 'row',- justifyContent: 'center',- key: 'menu-host',- children: [- ctx.kit.Text({ color: THEME.info, children: 'x.ruv.io' }),- ctx.kit.Text({ color: THEME.head, children: ' β ' }),- ctx.kit.Text({ bold: true, children: 'Main Menu' }),- ctx.kit.Text({ color: THEME.head, children: ' β ' }),- ctx.kit.Text({ color: THEME.info, children: clip('github.com/ruvnet/ruflo', Math.max(4, ctx.columns - 32)) }),- ],- }),- )rows.push(text(ctx, ' '))// Each group a bordered box: βββ TITLE βββ on top, then its sub-sections, each a dim ββ name ββ rule and its items.diff --git a/plugins/ruflo-console/hooks/views/pane.ts b/plugins/ruflo-console/hooks/views/pane.tsindex 90e5c9dcc1..0673070f6e 100644--- a/plugins/ruflo-console/hooks/views/pane.ts+++ b/plugins/ruflo-console/hooks/views/pane.ts@@ -262,7 +262,10 @@ export function paneView(ctx: Ctx): RenderElement {// Compact keeps every page's title and its line of purpose; only the banner and the spacing go.const parts = isCompact? [tabs(ctx), ...bbs.art, ...(about !== null ? [about] : []), ...(confirm !== null ? [confirm] : []), footer(ctx), body]- : [...title, ...bbs.strip, ...gap, tabs(ctx), ...gap, ...bbs.art, ...(about !== null ? [about] : []), ...gap, ...(isMenu ? [] : [footer(ctx)]), ...(confirm !== null && !isTerminal ? [confirm] : []), body, ...(confirm !== null && isTerminal ? [confirm] : []), ...gap, ...(isMenu ? [footer(ctx)] : [])]+ : !isMenu && isBbs()+ ? // Every page but the main menu leads with its own title and purpose line; the welcome line and network links follow, with a blank row between the blocks.+ [...bbs.art, ...(about !== null ? [about] : []), ...gap, ...bbs.strip, ...gap, tabs(ctx), ...gap, footer(ctx), ...(confirm !== null && !isTerminal ? [confirm] : []), body, ...(confirm !== null && isTerminal ? [confirm] : [])]+ : [...title, ...(isMenu && isBbs() ? [text(ctx, ' ')] : []), ...bbs.strip, ...(isMenu && isBbs() ? [text(ctx, ' ')] : []), ...gap, tabs(ctx), ...gap, ...(isMenu && isBbs() ? [] : [...bbs.art, ...(about !== null ? [about] : [])]), ...gap, ...(isMenu ? [] : [footer(ctx)]), ...(confirm !== null && !isTerminal ? [confirm] : []), body, ...(confirm !== null && isTerminal ? [confirm] : []), ...gap, ...(isMenu ? [footer(ctx)] : [])]return ctx.kit.Box({ flexDirection: 'column', children: parts })}diff --git a/plugins/ruflo-console/scripts/smoke.sh b/plugins/ruflo-console/scripts/smoke.shindex f0aff1d71b..f5498194e2 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.9.0"+step "1. plugin.json declares ruflo-console 0.9.1"grep -q '"name": "ruflo-console"' "$ROOT/.claude-plugin/plugin.json" \- && grep -q '"version": "0.9.0"' "$ROOT/.claude-plugin/plugin.json" && ok || bad "name/version"+ && grep -q '"version": "0.9.1"' "$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/behaviour.test.ts b/plugins/ruflo-console/tests/behaviour.test.tsindex d9cda6c107..34fb5dbd09 100644--- a/plugins/ruflo-console/tests/behaviour.test.ts+++ b/plugins/ruflo-console/tests/behaviour.test.ts@@ -324,7 +324,7 @@ describe('behaviour', () => {const pane = await $.ui.mount({ ...paneAt(98, 12), plugin: PLUGIN })- expect(elementsOf(await pane.drawn(), 'Raster').map(keyOf).slice(0, 2)).toEqual(['header', 'title'])+ expect(elementsOf(await pane.drawn(), 'Raster').map(keyOf).slice(0, 1)).toEqual(['title'])await pane.unmount()})})diff --git a/plugins/ruflo-console/tests/evolve.test.ts b/plugins/ruflo-console/tests/evolve.test.tsindex f40516b8af..820a7ff0ee 100644--- a/plugins/ruflo-console/tests/evolve.test.ts+++ b/plugins/ruflo-console/tests/evolve.test.ts@@ -47,7 +47,7 @@ describe('self-evolution', () => {const { text, tree, rasters } = await drawn($, 'evolve')const buttons = elementsOf(tree, 'Button').map(keyOf)- expect(rasters).toEqual(['header', 'title', 'evolve-loop'])+ expect(rasters).toEqual(['title', 'evolve-loop'])for (const section of ['LOOP', 'LEDGER & RECEIPTS', 'LINEAGE', 'POLICIES', 'WITNESS', 'WHAT RUNS WHERE', 'PROMOTE']) expect(text).toContain(`βββ ${section} βββ`)expect(text).toContain('dddddddd champion')expect(text).toContain('β 33333333 \nrejected \n UNSIGNED Β· evaluated Β· cccccccc β eeeeeeee')diff --git a/plugins/ruflo-console/tests/pure.spec.ts b/plugins/ruflo-console/tests/pure.spec.tsindex 05411f9e8e..77d640f55f 100644--- a/plugins/ruflo-console/tests/pure.spec.ts+++ b/plugins/ruflo-console/tests/pure.spec.ts@@ -146,8 +146,11 @@ describe('graphics', () => {const state = newState({})state.view = 'learning'- expect([...picturesOf(state, 90, 0, 5).keys()]).toEqual(['header', 'title', 'curve', 'pipeline', 'patterns'])+ expect([...picturesOf(state, 90, 0, 5).keys()]).toEqual(['title', 'curve', 'pipeline', 'patterns'])state.view = 'memory'+ expect([...picturesOf(state, 90, 0, 5).keys()]).toEqual(['title'])+ // The RUFLO banner is the main menu's alone; every other page leads with `RUFLO | PAGE`.+ state.view = 'menu'expect([...picturesOf(state, 90, 0, 5).keys()]).toEqual(['header', 'title'])})diff --git a/plugins/ruflo-console/tests/views.test.ts b/plugins/ruflo-console/tests/views.test.tsindex 276ed32daf..2f3b178492 100644--- a/plugins/ruflo-console/tests/views.test.ts+++ b/plugins/ruflo-console/tests/views.test.ts@@ -35,7 +35,7 @@ describe('views', () => {const { text, rasters } = await drawn($, 'overview')- expect(rasters).toEqual(['header', 'title', 'activity'])+ expect(rasters).toEqual(['title', 'activity'])expect(text).toContain('v3.50.0 (npx-offline)')expect(text).toContain('running per daemon-state.json')expect(text).toContain('1 ruflo server connected (plugin_ruflo-core_ruflo) Β· 2 tools callable now')@@ -53,7 +53,7 @@ describe('views', () => {const { text, rasters, tree } = await drawn($, 'swarm')- expect(rasters).toEqual(['header', 'title', 'topology'])+ expect(rasters).toEqual(['title', 'topology'])expect(text).toContain('hierarchical Β· specialized Β· running Β· max 6')// One label per agent (no repeated type), then status; a short id instead of the full one.expect(text).toMatch(/βΈβ \ncoder\s+idle\s+tasks/)@@ -77,7 +77,7 @@ describe('views', () => {const { text, rasters, tree } = await drawn($, 'hive')// The comb, a chamber per open proposal, and the strip (shield, terms, pheromones); nothing asked, nothing run.- expect(rasters).toEqual(['header', 'title', 'hive', 'hive-chambers', 'hive-strip'])+ expect(rasters).toEqual(['title', 'hive', 'hive-chambers', 'hive-strip'])expect(text).toContain('3 in the comb Β· 1 byzantine')expect(text).toMatch(/voting chambers/i)expect(world.runs.filter(argv => argv.includes('hive-mind') || argv.some(arg => arg.startsWith('hive-mind_')))).toEqual([])@@ -105,7 +105,7 @@ describe('views', () => {const { text, rasters, tree } = await drawn($, 'hive')- expect(rasters).toEqual(['header', 'title', 'hive-egg', 'hive-egg-base'])+ expect(rasters).toEqual(['title', 'hive-egg', 'hive-egg-base'])expect(text).toContain('the comb is empty Β· the egg is where the queen will sit')expect(elementsOf(tree, 'Button').map(keyOf)).toEqual(expect.arrayContaining(['start-hive', 'start-hive-workers']))@@ -142,7 +142,7 @@ describe('views', () => {const { text, rasters, tree } = await drawn($, 'claims')- expect(rasters).toEqual(['header', 'title', 'flow'])+ expect(rasters).toEqual(['title', 'flow'])expect(text).toContain('1 active Β· 1 stealable Β· 0 handoff')expect(text).toContain('no claims tool sets a TTL today')expect(text).toMatch(/console-demo-2.*stealable/)@@ -156,7 +156,7 @@ describe('views', () => {const { text, rasters } = await drawn($, 'federation')- expect(rasters).toEqual(['header', 'title', 'fedmap'])+ expect(rasters).toEqual(['title', 'fedmap'])expect(text).toContain('agentbbs agentbbs-not-found')expect(text).toContain('Off: the roster is on the public relay')expect(world.runs.some(argv => argv.join(' ').includes('x_federation_roster'))).toBe(false)@@ -169,7 +169,7 @@ describe('views', () => {const { text, rasters } = await drawn($, 'plugins')- expect(rasters).toEqual(['header', 'title', 'health'])+ expect(rasters).toEqual(['title', 'health'])expect(text).toContain('STALE: the clone does not list ruflo-mods')expect(text).toContain('2 ruflo Β· 1 enabled Β· 2 total')})@@ -182,7 +182,7 @@ describe('views', () => {const { text, rasters } = await drawn($, 'learning')- expect(rasters).toEqual(['header', 'title', 'curve', 'pipeline', 'patterns'])+ expect(rasters).toEqual(['title', 'curve', 'pipeline', 'patterns'])expect(text).toContain('tester 60% Β· keyword match')expect(text).toMatch(/\d+\/9 succeeded \(\d+% success rate, N=9\)/)expect(text).toContain('consolidate: EWC consolidations')@@ -195,7 +195,7 @@ describe('views', () => {const { text, rasters } = await drawn($, 'metaharness')- expect(rasters).toEqual(['header', 'title', 'radar', 'trend'])+ expect(rasters).toEqual(['title', 'radar', 'trend'])expect(text).toContain('$0.024')expect(text).toContain('valid Β· 0 commits Β· 0 receipts')})@@ -233,7 +233,7 @@ describe('views', () => {const cost = await drawn($, 'cost')- expect(cost.rasters).toEqual(['header', 'title', 'gauge', 'burn'])+ expect(cost.rasters).toEqual(['title', 'gauge', 'burn'])expect(cost.text).toContain('$0.421')expect(cost.text).toContain('WARNING Β· $3.90 of $5.00 (78%)')expect(cost.text).toContain('WHERE IT GOES')@@ -251,7 +251,7 @@ describe('views', () => {mock.clock(on)await $.session.start(SESSION)- expect((await drawn($, 'timeline')).rasters).toEqual(['header', 'title', 'gantt'])+ expect((await drawn($, 'timeline')).rasters).toEqual(['title', 'gantt'])const approvals = await drawn($, 'approvals')@@ -307,7 +307,7 @@ describe('views', () => {const { text, rasters } = await drawn($, 'xruv')- expect(rasters).toEqual(['header', 'title'])+ expect(rasters).toEqual(['title'])expect(text).toContain(' JOIN ....')expect(text).toContain('WORK CLAIMS')expect(text).toContain('Turn on federationNetwork in /config')@@ -338,7 +338,7 @@ describe('views', () => {const pane = await $.ui.mount({ ...paneAt(110), surface: 'terminal' as const, plugin: PLUGIN })const menu = await pane.drawn()- expect(elementsOf(menu, 'Raster').map(keyOf)).toEqual(['header', 'title'])+ expect(elementsOf(menu, 'Raster').map(keyOf)).toEqual(['header'])expect(textOf(menu)).toContain('βββ SWARM βββ')expect(textOf(menu)).toContain('ββ live')expect(textOf(menu)).toContain('Swarm Topology')@@ -364,7 +364,7 @@ describe('views', () => {const { text, rasters } = await drawn($, 'automate')- expect(rasters).toEqual(['header', 'title'])+ expect(rasters).toEqual(['title'])expect(text).toContain('β MAP')expect(text).toContain('137 runs Β· 0 failed')expect(text).toContain('β OPTIMIZE')@@ -409,7 +409,7 @@ describe('views', () => {const { text, rasters } = await drawn($, 'neural')- expect(rasters).toEqual(['header', 'title'])+ expect(rasters).toEqual(['title'])expect(text).toMatch(/trajectories\s+30\.8k/)expect(text).toMatch(/TRAINING[\s\S]*ROUTER/)expect(mine()).toEqual([])