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): 0.22.0 β€” the boot screen brings every area online, ADR-421

ruv05cde94326c4
diff --git a/plugins/ruflo-console/.claude-plugin/plugin.json b/plugins/ruflo-console/.claude-plugin/plugin.json
index d45b5f94d3..2cb6cffc0d 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.21.0",
+ "version": "0.22.0",
"author": {
"name": "ruvnet",
"url": "https://github.com/ruvnet"
@@ -89,7 +89,7 @@
"boot": {
"type": "boolean",
"title": "Boot screen",
- "description": "With the bbs look, play a short dial-up boot screen (modem connect, the RUFLO logo drawing in, a loading bar for the first ruflo reads) when the cockpit opens. At least 3.2 s, at most 6 s.",
+ "description": "With the bbs look, play a dial-up boot screen (modem connect, the RUFLO logo drawing in, every area of the console coming online in a log, a loading bar for the first ruflo reads) when the cockpit opens. At least 5.4 s, at most 8 s.",
"default": true
}
}
diff --git a/plugins/ruflo-console/hooks/gfx/boot.ts b/plugins/ruflo-console/hooks/gfx/boot.ts
index c945f0c28e..444ab0c371 100644
--- a/plugins/ruflo-console/hooks/gfx/boot.ts
+++ b/plugins/ruflo-console/hooks/gfx/boot.ts
@@ -1,7 +1,9 @@
/**
* The BBS boot screen, played for the first seconds after the pane opens: a modem dials and connects, then the RuFlo
* neon sign strikes up tube by tube on its brick wall (gfx/neon.ts), then a handshake line and a bar that fills with
- * the first ruflo reads. The boot is the one animation in the console that is decoration; it ends by itself.
+ * the first ruflo reads, and under them a boot log that brings every area of the console online, one line at a time,
+ * for as many rows as the pane has (it scrolls when the pane is short). The boot is the one animation in the console
+ * that is decoration; it ends by itself.
*/
import { neonPicture, NEON_ROWS } from './neon'
import { Grid } from './raster'
@@ -11,16 +13,52 @@ export const BOOT_ROWS = SIGN_TOP + NEON_ROWS + 3
const GREEN = 0x39ff14
const CYAN = 0x05d9e8
+const PINK = 0xff2a6d
const DIM = 0x6b7280
/** The sign is switched on once the line connects. */
const SIGN_ON_MS = 900
+/** The boot log starts once the handshake is typed, and brings one area online every LOG_MS_PER. */
+const LOG_FROM_MS = 1500
+const LOG_MS_PER = 150
+
+/** Every area of the console, in menu order: what the boot log brings online. */
+export const BOOT_MODULES: readonly { name: string; note: string }[] = [
+ { name: 'Missions', note: 'goal β†’ SPARC plan β†’ tasks' },
+ { name: 'Overview', note: 'subsystems, health, Optimizer' },
+ { name: 'Swarm', note: 'topology, agents, tasks' },
+ { name: 'Hive-Mind', note: 'queen, workers, votes, quorum' },
+ { name: 'Claims', note: 'one owner per resource' },
+ { name: 'Approvals', note: 'votes and asks in one place' },
+ { name: 'Automation', note: 'workflows, workers, autopilot' },
+ { name: 'Learning', note: 'SONA, MoE, EWC++ pulse' },
+ { name: 'Neural', note: 'pretrain, patterns, routing' },
+ { name: 'Vector Lab', note: 'HNSW, RaBitQ, RVF' },
+ { name: 'Memory Lab', note: 'AgentDB, embeddings' },
+ { name: 'MetaHarness', note: 'readiness, flywheel, lab' },
+ { name: 'Self-Evolution', note: 'governed receipts, lineage' },
+ { name: 'Security', note: 'scans, AIDefence, doctor' },
+ { name: 'Federation', note: 'peers, trust, relay' },
+ { name: 'x.ruv.io', note: 'swarm board, AgentBBS rooms' },
+ { name: 'Plugins & Mods', note: 'every ruflo plugin mapped' },
+ { name: 'Skills', note: 'find, add, manage' },
+ { name: 'Dev Tools', note: 'ADRs, SPARC, tests, git, docs' },
+ { name: 'Cost & Budget', note: 'spend, burn, limits' },
+ { name: 'Timeline', note: 'who was busy, and when' },
+ { name: 'Events', note: 'what changed, live' },
+ { name: 'Performance', note: 'metrics and bottlenecks' },
+ { name: 'AI Terminal', note: 'ruflo, codex, claude' },
+ { name: 'Settings', note: 'every option a button' },
+]
+const NAME_WIDTH = 15
/**
* `age` is ms since the pane opened; the bar mixes elapsed time with the reads that have answered (`done` of
- * `total`), so it moves before any read returns and reads 100% before the boot ends at BOOT_MIN_MS.
+ * `total`), so it moves before any read returns and reads 100% before the boot ends at BOOT_MIN_MS. `rows` is the
+ * pane's body height when it is known: the boot log fills what is left under the sign (0: the sign alone).
*/
-export function bootPicture(project: string, columns: number, age: number, done: number, total: number): Grid {
- const grid = new Grid(columns, BOOT_ROWS)
+export function bootPicture(project: string, columns: number, age: number, done: number, total: number, rows = 0): Grid {
+ const height = Math.max(BOOT_ROWS, rows)
+ const grid = new Grid(columns, height)
const type = (y: number, from: number, text: string, color: number, msPerChar = 22) => {
if (age < from) return
@@ -35,11 +73,37 @@ export function bootPicture(project: string, columns: number, age: number, done:
grid.cells.set(sign.cells, SIGN_TOP * columns * 3)
- type(BOOT_ROWS - 2, 2300, `> handshake ok Β· node ${project}`, CYAN, 14)
+ type(BOOT_ROWS - 2, 1300, `> handshake ok Β· node ${project}`, CYAN, 14)
+
+ // The boot log: one area comes online every LOG_MS_PER, [ .. ] while it starts and [ OK ] once the next one has begun; the
+ // newest lines stay in view when the pane is shorter than the list, and READY closes it.
+ const entries = [...BOOT_MODULES.map(entry => ({ ...entry, ready: false })), { name: 'READY', note: `${BOOT_MODULES.length} areas online Β· press a key or click`, ready: true }]
+ const room = height - BOOT_ROWS - 1
+ const started = age < LOG_FROM_MS ? 0 : Math.min(entries.length, Math.floor((age - LOG_FROM_MS) / LOG_MS_PER) + 1)
+ const logProgress = started / entries.length
+
+ if (room > 0 && started > 0) {
+ const first = Math.max(0, started - room)
+
+ for (let i = first; i < started; i++) {
+ const entry = entries[i] as (typeof entries)[number]
+ const y = BOOT_ROWS + 1 + (i - first)
+ const isOn = i < started - 1 || started === entries.length
+
+ if (entry.ready) {
+ grid.text(0, y, `[ OK ] ${entry.name}`, GREEN)
+ grid.text(7 + 'READY '.length, y, entry.note.slice(0, Math.max(0, columns - 13)), PINK)
+ } else {
+ grid.text(0, y, isOn ? '[ OK ]' : '[ .. ]', isOn ? GREEN : CYAN)
+ grid.text(7, y, entry.name.padEnd(NAME_WIDTH).slice(0, NAME_WIDTH), 0xe6e6e6)
+ grid.text(7 + NAME_WIDTH + 1, y, entry.note.slice(0, Math.max(0, columns - 7 - NAME_WIDTH - 1)), DIM)
+ }
+ }
+ }
// LOADING [β–“β–“β–“β–“β–‘β–‘β–‘β–‘] 58% reads 6/10, with a blinking cursor while it runs.
- if (age >= 2300) {
- const pct = Math.min(1, 0.55 * Math.min(1, (age - 2300) / 700) + 0.45 * (total > 0 ? done / total : 1))
+ if (age >= 1300) {
+ const pct = Math.min(1, 0.4 * Math.min(1, (age - 1300) / 3300) + 0.3 * logProgress + 0.3 * (total > 0 ? done / total : 1))
const barWidth = Math.max(6, Math.min(24, columns - 30))
const filled = Math.round(pct * barWidth)
const line = `LOADING [${'β–“'.repeat(filled)}${'β–‘'.repeat(barWidth - filled)}] ${String(Math.round(pct * 100)).padStart(3)}% reads ${done}/${total}`
diff --git a/plugins/ruflo-console/hooks/state.ts b/plugins/ruflo-console/hooks/state.ts
index 2ec05489ae..b041469037 100644
--- a/plugins/ruflo-console/hooks/state.ts
+++ b/plugins/ruflo-console/hooks/state.ts
@@ -375,8 +375,8 @@ export function restoreSessions(state: State, value: unknown): void {
export const isSessionId = (id: string): boolean => SESSION_ID.test(id)
/** The BBS boot screen's span: at least BOOT_MIN_MS, longer while the first read is still out, never past BOOT_MAX_MS. */
-export const BOOT_MIN_MS = 3_200
-export const BOOT_MAX_MS = 6_000
+export const BOOT_MIN_MS = 5_400
+export const BOOT_MAX_MS = 8_000
export function isBooting(state: State, nowMs: number): boolean {
if (state.options.look !== 'bbs' || !state.options.boot || state.pane.bootAtMs === 0) return false
diff --git a/plugins/ruflo-console/hooks/views/frames.ts b/plugins/ruflo-console/hooks/views/frames.ts
index c25d9ff46f..fd7c9b5b4b 100644
--- a/plugins/ruflo-console/hooks/views/frames.ts
+++ b/plugins/ruflo-console/hooks/views/frames.ts
@@ -122,7 +122,7 @@ export function picturesOf(state: State, columns: number, nowMs: number, t: numb
// The BBS boot screen owns the pane for its first seconds; nothing else is drawn under it.
if (isBooting(state, nowMs)) {
- pictures.set('boot', bootPicture(state.cwd.split('/').filter(Boolean).at(-1) ?? '', Math.min(width, 72), nowMs - state.pane.bootAtMs, state.probes.size, PROBES.length))
+ pictures.set('boot', bootPicture(state.cwd.split('/').filter(Boolean).at(-1) ?? '', Math.min(width, 90), nowMs - state.pane.bootAtMs, state.probes.size, PROBES.length, state.pane.rows))
return pictures
}
diff --git a/plugins/ruflo-console/scripts/smoke.sh b/plugins/ruflo-console/scripts/smoke.sh
index 93d09f0d72..67134155d0 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.21.0"
+step "1. plugin.json declares ruflo-console 0.22.0"
grep -q '"name": "ruflo-console"' "$ROOT/.claude-plugin/plugin.json" \
- && grep -q '"version": "0.21.0"' "$ROOT/.claude-plugin/plugin.json" && ok || bad "name/version"
+ && grep -q '"version": "0.22.0"' "$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/diagrams.spec.ts b/plugins/ruflo-console/tests/diagrams.spec.ts
index 8cadca463c..47ae685c63 100644
--- a/plugins/ruflo-console/tests/diagrams.spec.ts
+++ b/plugins/ruflo-console/tests/diagrams.spec.ts
@@ -7,6 +7,7 @@ import { describe, expect, it } from 'vitest'
import { gaugePicture, pipelinePicture, radarPicture, samplesPicture, trendPicture } from '../hooks/gfx/charts'
import { flowModelOf, flowPicture, flowRows, ringOf } from '../hooks/gfx/flow'
import { federationPicture, ganttPicture, heatmapPicture } from '../hooks/gfx/maps'
+import { BOOT_MODULES, BOOT_ROWS } from '../hooks/gfx/boot'
import { activityPicture, bannerPicture, bootPicture, curvePicture, edges, headerPicture, layout, markPicture, topologyPicture, type TopoModel } from '../hooks/gfx/pictures'
import { isBooting, newState, optionsOf } from '../hooks/state'
import type { Grid } from '../hooks/gfx/raster'
@@ -152,7 +153,7 @@ describe('BBS boot screen', () => {
expect(text(bootPicture('demo', 60, 100, 0, 10), 60)).toContain('ATDT')
expect(text(bootPicture('demo', 60, 100, 0, 10), 60)).not.toContain('CONNECT')
- const done = text(bootPicture('demo', 60, 3_800, 10, 10), 60)
+ const done = text(bootPicture('demo', 60, 5_400, 10, 10), 60)
expect(done).toContain('CONNECT 115200 / ARQ / V.42bis')
expect(done).toContain('β”‚ ~~~~~ β”‚')
@@ -164,17 +165,43 @@ describe('BBS boot screen', () => {
expect(done).toContain('100% reads 10/10')
})
- it('plays at least 3.2 s, longer while the first read is out, never past 6 s; only with the bbs look and boot on', () => {
+ it('brings every area online in a log under the sign, as many lines as the pane has rows, newest in view, READY last', () => {
+ const rows = BOOT_ROWS + 1 + BOOT_MODULES.length + 1
+
+ // Nothing is logged before the handshake; one line per 150 ms after it.
+ expect(text(bootPicture('demo', 80, 1_000, 0, 10, rows), 80)).not.toContain('[ OK ]')
+ expect(text(bootPicture('demo', 80, 1_550, 0, 10, rows), 80)).toContain('[ .. ] Missions')
+ expect(text(bootPicture('demo', 80, 1_700, 0, 10, rows), 80)).toContain('[ OK ] Missions')
+ expect(text(bootPicture('demo', 80, 1_700, 0, 10, rows), 80)).not.toContain('Hive-Mind')
+
+ // Every area, in menu order, then READY.
+ const full = text(bootPicture('demo', 80, 5_400, 10, 10, rows), 80)
+
+ for (const entry of BOOT_MODULES) expect(full).toContain(entry.name)
+ expect(full.indexOf('Missions')).toBeLessThan(full.indexOf('Settings'))
+ expect(full).toContain(`[ OK ] READY`)
+ expect(full).toContain(`${BOOT_MODULES.length} areas online`)
+ expect(full).toContain('100% reads 10/10')
+
+ // A short pane shows the newest lines, not the oldest; no rows given: the sign alone, as before.
+ const short = text(bootPicture('demo', 80, 5_400, 10, 10, BOOT_ROWS + 1 + 5), 80)
+
+ expect(short).toContain('READY')
+ expect(short).not.toContain('Missions')
+ expect(bootPicture('demo', 80, 5_400, 10, 10).rows).toBe(BOOT_ROWS)
+ })
+
+ it('plays at least 5.4 s, longer while the first read is out, never past 8 s; only with the bbs look and boot on', () => {
const state = newState({})
state.pane.bootAtMs = 1_000
expect(isBooting(state, 1_100)).toBe(true)
- expect(isBooting(state, 5_000)).toBe(true) // past the 3.2 s minimum, but no snapshot yet
+ expect(isBooting(state, 7_000)).toBe(true) // past the 5.4 s minimum, but no snapshot yet
state.snapshot = {} as never
- expect(isBooting(state, 5_000)).toBe(false)
+ expect(isBooting(state, 7_000)).toBe(false)
expect(isBooting(state, 2_000)).toBe(true)
state.snapshot = null
- expect(isBooting(state, 7_500)).toBe(false)
+ expect(isBooting(state, 9_500)).toBe(false)
expect(isBooting({ ...state, options: { ...state.options, boot: false } }, 1_100)).toBe(false)
expect(isBooting({ ...state, options: { ...state.options, look: 'plain' } }, 1_100)).toBe(false)
})
diff --git a/v3/docs/adr/ADR-421-console-boot-screen-v2.md b/v3/docs/adr/ADR-421-console-boot-screen-v2.md
new file mode 100644
index 0000000000..e7c97d93be
--- /dev/null
+++ b/v3/docs/adr/ADR-421-console-boot-screen-v2.md
@@ -0,0 +1,39 @@
+# ADR 421: The boot screen brings every area online
+
+Status: Accepted (ships in ruflo-console 0.22.0)
+
+Date: 2026 10 03
+
+Decision owner: Ruflo maintainers
+
+Scope: `plugins/ruflo-console`: `hooks/gfx/boot.ts`, `hooks/views/frames.ts`, `hooks/state.ts` (`BOOT_MIN_MS`, `BOOT_MAX_MS`), `tests/diagrams.spec.ts`.
+
+Extends: ADR 407 (the BBS look and boot). Companion to ADR 420 (the tour GIF).
+
+## 1. Context
+
+The boot screen was a modem dial-up (`ATDT`, `CONNECT`), the neon sign striking up, a handshake line and a loading bar, drawn into a Raster about 19 rows tall. In a tall pane (a docked cockpit is the full terminal height, 50 rows or more) the other two thirds stayed empty for the 3.2 seconds it played, and it said nothing about what the console is. Someone opening it for the first time saw a logo, then a menu.
+
+## 2. Decision
+
+Keep the dial-up and the sign, and add a **boot log** under them that brings every area of the console online:
+
+- 25 areas, in menu order (Missions, Overview, Swarm, Hive-Mind, Claims, Approvals, Automation, Learning, Neural, Vector Lab, Memory Lab, MetaHarness, Self-Evolution, Security, Federation, x.ruv.io, Plugins & Mods, Skills, Dev Tools, Cost & Budget, Timeline, Events, Performance, AI Terminal, Settings), each with a few words on what it is, then a `READY` line.
+- One area starts every 150 ms: `[ .. ]` while it starts, `[ OK ]` once the next has begun. The log starts at 1.5 s, after the handshake line is typed.
+- The log fills the pane: `bootPicture` takes the pane's body rows (`state.pane.rows`) and the log uses every row under the sign. In a short pane it scrolls, the newest lines in view and the oldest gone; with no rows known it is the sign alone, as before.
+- The loading bar now also follows the log, so it moves steadily and reads 100% as `READY` appears, not only when the first reads land.
+- The boot plays for at least 5.4 s (was 3.2) and at most 8 s (was 6): long enough for the whole log, still ending by itself, still only with the bbs look and the boot option on. The boot picture is up to 90 columns wide (was 72).
+
+## 3. Alternatives considered
+
+- **A longer sign animation.** Rejected: more time on the same picture; the log says what the console is.
+- **Drawing the log as text rows beside the Raster.** Rejected: the boot owns the pane, and one Raster keeps the dial-up, sign and log on one clock.
+- **Reading the area list from the view table.** Deferred: the list carries a few words per area that the view table does not hold, so it is its own short table (`BOOT_MODULES`); a test checks every entry appears in order.
+
+## 4. Consequences
+
+A first open now shows what is in the cockpit while it loads. A recording gets a boot that fills a full-height dock. The boot is five seconds longer in the worst case; the boot option still turns it off.
+
+## 5. Tests
+
+`tests/diagrams.spec.ts`: nothing logged before the handshake; `[ .. ]` then `[ OK ]` at the right times; every area present in order with `READY`; a short pane shows the newest lines; no rows given gives the sign alone; the span is 5.4 to 8 s.