🌊 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
fix(console): retain animated Ruflo branding across Orbital pages and resize
rUv454d3a8bcb55
diff --git a/plugins/ruflo-console/README.md b/plugins/ruflo-console/README.mdindex 2f7d1bd5f4..c34398026b 100644--- a/plugins/ruflo-console/README.md+++ b/plugins/ruflo-console/README.md@@ -96,9 +96,9 @@ printf '%s\n' '{"look":"orbital"}' | claude plugin configure ruflo-console@rufloReload plugins after changing the option. Select `bbs` or `plain` to restore those looks. A dark terminal background gives the closest match; terminal graphics and host controls keep their existing renderer. Narrow panes retain the existing responsive layout.-Orbital includes a four-row animated ASCII telemetry header with a red scan line, green decorative pulse and orbit marker. The optional boot intro uses a rotating ASCII Earth (one turn per 12 seconds), with actual self-check counts below it. It runs for 1.5 seconds when data is ready, at most 6 seconds while data is pending. Set `fps` to `0` for still headers and no boot intro. Existing frame scheduling stops motion in hidden panes. The pulse and globe are decoration, not measured activity or a progress percentage.+Orbital keeps the original Ruflo block mark visible after boot on every page, above navigation. Wide headers use an eight-row composition with a shaded block extrusion, moving highlight, rotating ASCII Earth and travelling scan. Smaller panes retain the original two-row block mark inside a compact header. The optional boot intro uses the same Earth rotation (one turn per 12 seconds), with actual self-check counts below it. It runs for 1.5 seconds when data is ready, at most 6 seconds while data is pending. Set `fps` to `0` for still headers and no boot intro. Existing frame scheduling stops motion in hidden or unfocused panes. The sweep and globe are decoration, not measured activity or a progress percentage.-Orbital adapts to the pane allocation. Below 48 drawing columns or 30 available rows, boot uses a compact check summary of at most nine rows. Failure totals remain near the top, with the first failing area shown when a third row fits. The swarm header uses its full graph at 56 drawing columns and 16 available header rows; smaller allocations use a compact animated strip. Header width reserves the existing toolbar icon space and is capped at 120 columns. Extremely small allocations clip text to the available cells. The existing live topology remains in the page body.+Orbital adapts to the pane allocation. Below 48 drawing columns or 30 available rows, boot uses a compact check summary of at most nine rows. Failure totals remain near the top, with the first failing area shown when a third row fits. The persistent header uses its expanded layout from 78 drawing columns with eight available header rows. Short panes keep two rows; the native host's text-only mode below 44 pane columns retains a text Ruflo identity. Header width reserves the existing toolbar icon space and is capped at 120 columns. Resize dimensions are recorded before the header is mounted so the animation loop continues at the new size. The existing live topology remains in the Swarm page body; Theme Studio provides the decorative orchestration preview.### Theme Studiodiff --git a/plugins/ruflo-console/hooks/gfx/orbital.ts b/plugins/ruflo-console/hooks/gfx/orbital.tsindex a1fa66f58a..4328a8a619 100644--- a/plugins/ruflo-console/hooks/gfx/orbital.ts+++ b/plugins/ruflo-console/hooks/gfx/orbital.ts@@ -228,6 +228,59 @@ function orbitalBrandColor(color: number, theme = ORBITAL_THEME): number {return (ch(16) << 16) | (ch(8) << 8) | ch(0)}+/** Persistent console identity, using the original half-block logo and its entry/sweep animation. */+export function orbitalMasthead(label: string, columns: number, timeMs: number, maxRows = 8, theme = ORBITAL_THEME, age = Infinity): Grid {+ const { RED, GREEN, INK, BLACK, DIM } = colors(theme)+ const wide = columns >= 78 && maxRows >= 8+ const grid = blank(columns, Math.max(1, Math.min(wide ? 8 : 4, maxRows)), theme)+ const ms = Number.isFinite(timeMs) ? Math.max(0, timeMs) : 0+ const logo = bannerPicture('', 19, ms, age)+ if (wide) {+ // Scale the original four pixel rows to eight, keeping terminal half-block resolution.+ // A fixed extrusion sits behind the face; only the highlight moves, so the mark stays legible.+ const face: { x: number; y: number; glyph: number; color: number }[] = []+ for (let y = 0; y < logo.rows; y++) for (let x = 0; x < logo.columns; x++) {+ const i = (y * logo.columns + x) * 3+ const ch = String.fromCodePoint(logo.cells[i]!)+ if (ch === ' ') continue+ const color = orbitalBrandColor(logo.cells[i + 1]!, theme)+ const halves = ch === '▀' ? [true, false] : ch === '▄' ? [false, true] : [true, true]+ for (let half = 0; half < 2; half++) if (halves[half]) for (let dx = 0; dx < 2; dx++) face.push({ x: x * 2 + dx, y: 1 + y * 2 + half, glyph: 0x2588, color })+ }+ for (const cell of face) grid.set(cell.x + 2, cell.y + 1, '▓', mix(BLACK, RED, 0.33), BLACK)+ for (const cell of face) grid.set(cell.x, cell.y, cell.glyph, cell.color, BLACK)+ grid.text(0, 0, 'RUVNET / AGENT SWARM CONSOLE', DIM)+ grid.text(0, 6, label.toUpperCase().slice(0, 40), INK)+ if (theme.motion.globe) {+ const globe = orbitalGlobe(Math.min(40, grid.columns - 43), 7, ms, theme)+ const left = grid.columns - globe.columns+ for (let y = 0; y < globe.rows; y++) for (let x = 0; x < globe.columns; x++) {+ const i = (y * globe.columns + x) * 3+ grid.set(left + x, y, globe.cells[i]!, globe.cells[i + 1]!, BLACK)+ }+ }+ } else if (grid.columns >= 19 && grid.rows >= 2) {+ for (let y = 0; y < logo.rows; y++) for (let x = 0; x < logo.columns; x++) {+ const i = (y * logo.columns + x) * 3+ grid.set(x, y, logo.cells[i]!, orbitalBrandColor(logo.cells[i + 1]!, theme), BLACK)+ }+ if (grid.columns >= 34) grid.text(22, 0, label.toUpperCase().slice(0, grid.columns - 22), INK)+ if (grid.rows >= 3) grid.text(0, 2, `RUFLO / ${label.toUpperCase()}`.slice(0, grid.columns), DIM)+ } else grid.text(0, 0, 'RUFLO'.slice(0, grid.columns), RED)++ // This raster is mounted and blitted by the shared frame loop on every page.+ if (grid.rows >= 4) {+ const y = grid.rows - 1+ const tick = Math.floor(ms / 80)+ for (let x = 0; x < grid.columns; x++) grid.set(x, y, '·', mix(BLACK, GREEN, 0.3), BLACK)+ for (let tail = 0; tail < 7; tail++) {+ const x = ((tick - tail) % grid.columns + grid.columns) % grid.columns+ grid.set(x, y, tail === 0 ? '▸' : '▪', tail === 0 ? INK : mix(BLACK, GREEN, 1 - tail / 8), BLACK)+ }+ }+ return grid+}+/** Checks are actual self-check results; the globe and sweep are explicitly decorative. */export function orbitalBoot(project: string, columns: number, timeMs: number, checks?: readonly BootCheck[], maxRows = 30, theme = ORBITAL_THEME): Grid {const { RED, GREEN, INK, BLACK, DIM, BAD } = colors(theme)diff --git a/plugins/ruflo-console/hooks/register.ts b/plugins/ruflo-console/hooks/register.tsindex 446324e59a..296c89d4ee 100644--- a/plugins/ruflo-console/hooks/register.ts+++ b/plugins/ruflo-console/hooks/register.ts@@ -321,6 +321,8 @@ export const register: Register = (on, raw: PluginOptions) => {state.pane.isFocused = e.props.isFocused === truestate.pane.columns = columnsstate.pane.placement = e.props.placement+ // Height-dependent art must use this render's allocation before its Raster size is recorded.+ state.pane.rows = Math.max(0, Math.floor(Number(e.props.scroll?.bodyRows) || 0))// A reload while the pane stayed up: timers are gone, so resume them from here.if (!state.timers.has('watch')) control.resume()@@ -329,8 +331,6 @@ export const register: Register = (on, raw: PluginOptions) => {state.mounted = new Map([...pictures].map(([key, grid]) => [key, { columns: grid.columns, rows: grid.rows }]))control.animate()- state.pane.rows = Math.max(0, Math.floor(Number(e.props.scroll?.bodyRows) || 0))-const tree = paneView({ kit: withClearing(kit, state, control.actions.clearField, { columns, repaint: () => host?.invalidate() }), state, nowMs: Date.now(), columns, pictures, act: control.actions })state.stats.renders.push(Date.now() - started)diff --git a/plugins/ruflo-console/hooks/views/frames.ts b/plugins/ruflo-console/hooks/views/frames.tsindex d45b1a58ef..fb2656de36 100644--- a/plugins/ruflo-console/hooks/views/frames.ts+++ b/plugins/ruflo-console/hooks/views/frames.ts@@ -8,7 +8,7 @@ import type { AuditTrend, HarnessScore, Intelligence } from '../data/cli'import { recentByAgent } from '../data/events'import { agentLabels } from '../data/parse'import { presentAgents, swarmStatusOf } from '../data/swarm-status'-import { orbitalBoot, orbitalHeader, orbitalGlobe } from '../gfx/orbital'+import { orbitalBoot, orbitalHeader, orbitalGlobe, orbitalMasthead } from '../gfx/orbital'import { getBootChecks } from '../boot-checks'import { bootFacts } from '../boot-facts'import { getBuild } from '../build'@@ -219,7 +219,9 @@ export function picturesOf(state: State, columns: number, nowMs: number, t: numbif (state.options.look === 'orbital') {const page = state.isHelp ? 'help' : state.palette.isOpen ? 'commands' : (VIEWS.find(view => view.id === state.view)?.label ?? state.view)- pictures.set(state.view === 'menu' ? 'header' : 'title', orbitalHeader(page, Math.max(1, Math.min(120, columns - iconCells(false) - ICON_SLACK)), motionTime, state.pane.rows > 0 ? Math.max(1, state.pane.rows - 12) : 16, theme))+ const room = Math.max(1, Math.min(120, columns < 40 ? columns : columns - iconCells(false) - ICON_SLACK))+ const rows = state.pane.rows > 0 ? Math.max(1, Math.min(state.pane.rows < 24 ? 2 : 8, state.pane.rows - 12)) : 8+ pictures.set(state.view === 'menu' ? 'header' : 'title', orbitalMasthead(page, room, motionTime, rows, theme, headerAge))}if (state.view === 'themes') {diff --git a/plugins/ruflo-console/hooks/views/pane.ts b/plugins/ruflo-console/hooks/views/pane.tsindex 0d9b86fb5c..980582b7f3 100644--- a/plugins/ruflo-console/hooks/views/pane.ts+++ b/plugins/ruflo-console/hooks/views/pane.ts@@ -422,11 +422,12 @@ export function paneView(base: Ctx): RenderElement {const hasInlineConfirm = attention.keys.get(body)?.has('confirm') === trueconst header = ctx.pictures.get('header')const isCompact = isCompactPane(ctx.state)+ const fallbackBrand = isOrbital() && ctx.kit.Raster === undefined ? [text(ctx, 'RUFLO / AGENT SWARM CONSOLE', { bold: true, color: THEME.head, wrap: 'truncate-end' })] : []// The logo banner leads the main menu in every layout, compact too (the other pages lead with their own title art there).- const title = (!isCompact || ctx.state.view === 'menu') && header !== undefined && ctx.kit.Raster !== undefined ? [ctx.kit.Raster(header.toRaster('header'))] : []+ const title = (!isCompact || ctx.state.view === 'menu') && header !== undefined && ctx.kit.Raster !== undefined ? [ctx.kit.Raster(header.toRaster('header'))] : ctx.state.view === 'menu' ? fallbackBrand : []const about = blurb(ctx)const orbitalArt = ctx.pictures.get('title')- const bbs = isBbs() ? wildcat(ctx) : { strip: [], art: isOrbital() && orbitalArt !== undefined && ctx.kit.Raster !== undefined ? [ctx.kit.Raster(orbitalArt.toRaster('title'))] : [] }+ const bbs = isBbs() ? wildcat(ctx) : { strip: [], art: isOrbital() && orbitalArt !== undefined && ctx.kit.Raster !== undefined ? [ctx.kit.Raster(orbitalArt.toRaster('title'))] : ctx.state.view !== 'menu' ? fallbackBrand : [] }// The status row (keys, sync, Palette, Actions) sits above the body, so a tall view cannot push it off the screen; only the main menu keeps it below its prompt, as a BBS does.const isMenu = ctx.state.view === 'menu'// The terminal's own Enter-again confirm stays under its field, where the field is.@@ -436,7 +437,7 @@ export function paneView(base: Ctx): RenderElement {// Compact keeps every page's title and its line of purpose; only the banner and the spacing go. The title leads, then the tabs, as in the wide layout.const parts = isCompact? [...(ctx.state.view === 'menu' && title.length > 0 ? title : bbs.art), ...(about !== null ? [about] : []), tabs(ctx), ...(confirm !== null && !hasInlineConfirm ? [confirm] : []), footer(ctx, attention.placed), body]- : !isMenu && isBbs()+ : !isMenu && (isBbs() || isOrbital())? // 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] : []), ...(cardsOn ? [] : [...gap, ...bbs.strip, ...gap]), tabs(ctx), ...(cardsOn ? [] : gap), footer(ctx, attention.placed), ...(confirm !== null && !isTerminal && !hasInlineConfirm ? [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, attention.placed)]), ...(confirm !== null && !isTerminal && !hasInlineConfirm ? [confirm] : []), body, ...(confirm !== null && isTerminal ? [confirm] : []), ...gap, ...(isMenu ? [footer(ctx, attention.placed)] : [])]@@ -444,7 +445,7 @@ export function paneView(base: Ctx): RenderElement {// The leading rows that sit beside the icons: the header art (one picture) and the line that says what the page is for; on the menu, the banner and the blank row under it.const lead = isCompact? (ctx.state.view === 'menu' && title.length > 0 ? title.length : bbs.art.length) + (about !== null ? 1 : 0)- : !isMenu && isBbs()+ : !isMenu && (isBbs() || isOrbital())? bbs.art.length + (about !== null ? 1 : 0): title.length + (isMenu && isBbs() ? 1 : 0)diff --git a/plugins/ruflo-console/tests/orbital.spec.ts b/plugins/ruflo-console/tests/orbital.spec.tsindex 9741a6531c..92dcd8de48 100644--- a/plugins/ruflo-console/tests/orbital.spec.ts+++ b/plugins/ruflo-console/tests/orbital.spec.ts@@ -32,7 +32,7 @@ describe('orbital theme', () => {})})-import { orbitalGlobe, orbitalHeader, orbitalBoot } from '../hooks/gfx/orbital'+import { orbitalGlobe, orbitalHeader, orbitalBoot, orbitalMasthead } from '../hooks/gfx/orbital'import { isBooting, VIEWS } from '../hooks/state'import { picturesOf } from '../hooks/views/frames'import type { Grid } from '../hooks/gfx/raster'@@ -89,15 +89,15 @@ describe('orbital motion', () => {const state = newState({})state.options.look = 'orbital'state.options.boot = false- for (const view of VIEWS) {+ for (const view of VIEWS) for (const width of [60, 116, 200]) {state.view = view.idconst key = view.id === 'menu' ? 'header' : 'title'state.options.fps = 12- expect(picturesOf(state, 60, 1000, 1000).get(key)?.cells).not.toEqual(picturesOf(state, 60, 2000, 2000).get(key)?.cells)+ expect(picturesOf(state, width, 1000, 1000).get(key)?.cells).not.toEqual(picturesOf(state, width, 2000, 2000).get(key)?.cells)state.options.fps = 0- const still = picturesOf(state, 60, 1000, 1000).get(key)+ const still = picturesOf(state, width, 1000, 1000).get(key)expect(still).toBeDefined()- expect(still!.cells).toEqual(picturesOf(state, 60, 2000, 2000).get(key)!.cells)+ expect(still!.cells).toEqual(picturesOf(state, width, 2000, 2000).get(key)!.cells)}})})@@ -162,7 +162,28 @@ it('reserves icon room and switches layouts as the pane is resized', () => {for (const [columns, rows] of [[160, 50], [44, 24], [72, 20], [200, 60], [20, 10]]) {state.pane.rows = rows!const header = picturesOf(state, columns!, 1000, 1000).get('title')!- expect(header.columns).toBeLessThanOrEqual(Math.max(1, columns! - 16))+ expect(header.columns).toBeLessThanOrEqual(Math.max(1, columns! < 40 ? columns! : columns! - 16))expect(header.rows).toBeLessThanOrEqual(Math.max(1, rows! - 12))}})++it('keeps the original block brand after boot with bounded moving art and optional globe', async () => {+ const { ORBITAL_THEME } = await import('../hooks/themes')+ for (const columns of [1, 8, 19, 28, 44, 72, 78, 100, 120, 200]) {+ for (const rows of [1, 2, 4, 8]) {+ const first = orbitalMasthead('Main Menu', columns, 0, rows)+ const next = orbitalMasthead('Main Menu', columns, 1400, rows)+ expect(first.columns).toBeLessThanOrEqual(columns)+ expect(first.rows).toBeLessThanOrEqual(rows)+ expect([next.columns, next.rows]).toEqual([first.columns, first.rows])+ if (columns >= 19 && rows >= 2) expect(gridText(first)).toMatch(/[█▀▄]/)+ if (columns >= 19 && rows >= 4) expect(first.cells).not.toEqual(next.cells)+ }+ }+ const off = { ...ORBITAL_THEME, motion: { ...ORBITAL_THEME.motion, globe: false, topology: false } }+ const grid = orbitalMasthead('Theme Studio', 100, 0, 8, off)+ expect(gridText(grid)).toContain('THEME STUDIO')+ expect(gridText(grid)).toContain('█')+ expect(gridText(grid)).not.toContain('#')+ expect(grid.cells).not.toEqual(orbitalMasthead('Theme Studio', 100, 0).cells)+})diff --git a/plugins/ruflo-console/tests/pane-order.spec.ts b/plugins/ruflo-console/tests/pane-order.spec.tsindex 7010176fd6..4a7b011923 100644--- a/plugins/ruflo-console/tests/pane-order.spec.ts+++ b/plugins/ruflo-console/tests/pane-order.spec.ts@@ -52,6 +52,29 @@ function order(view: ViewId, columns: number, rows: number): { title: number; taafterEach(() => setLook('plain'))describe('the pane\'s order', () => {+ it('keeps animated Orbital branding ahead of navigation on every main path', async () => {+ const { picturesOf } = await import('../hooks/views/frames')+ for (const view of ['menu', 'themes', 'swarm'] as const) {+ for (const placement of ['dock', 'inline'] as const) {+ for (const [columns, rows] of [[60, 18], [116, 60], [200, 80]]) {+ const state = newState({ look: 'orbital', boot: false })+ state.view = view+ Object.assign(state.pane, { placement, columns, rows })+ const pictures = picturesOf(state, columns!, 1000, 1000)+ const name = view === 'menu' ? 'header' : 'title'+ const grid = pictures.get(name)!+ expect(Array.from(grid.cells).some((cell, i) => i % 3 === 0 && [0x2588, 0x2580, 0x2584].includes(cell))).toBe(true)+ const nodes = flat(paneView({ kit, state, nowMs: 1000, columns, pictures, act } as unknown as Ctx))+ const brand = nodes.findIndex(node => node.kind === 'Raster' && node.props.key === name)+ const tabs = nodes.findIndex(node => node.props.key === 'tabs')+ expect(brand).toBeGreaterThanOrEqual(0)+ expect(brand).toBeLessThan(tabs)+ for (const key of ['pane-icons', 'footer']) expect(nodes.some(node => node.props.key === key)).toBe(true)+ }+ }+ }+ })+it('leads with the title and then the tabs in the compact layout', () => {const { title, tabs } = order('swarm', 100, 8)