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

11.5 KB
Raw Blame
/**
 * The cyberpunk boot log (ADR-432): a star is lit only on evidence, pulses run only on lit lines, READY claims no more than was
 * verified, the scramble and easter egg are deterministic, and a small pane falls back to the plain log. Run with
 *   npx vitest run plugins/ruflo-console/tests/boot-cyber.spec.ts
 */
import { describe, expect, it } from 'vitest'

import { bootFacts } from '../hooks/boot-facts'
import { bootPicture, BOOT_MODULES, BOOT_ROWS } from '../hooks/gfx/boot'
import { NEON_ROWS } from '../hooks/gfx/neon'
import { eggText, scramble, EGG_FROM_MS, SCAN_NAMES, SCAN_NAME_CELLS } from '../hooks/gfx/boot-cyber'
import { newState, type State } from '../hooks/state'

const textOf = (grid: ReturnType<typeof bootPicture>): string => {
  const lines: string[] = []

  for (let y = 0; y < grid.rows; y++) {
    let s = ''

    for (let x = 0; x < grid.columns; x++) s += String.fromCodePoint(grid.glyph(x, y))
    lines.push(s.trimEnd())
  }

  return lines.join('\n')
}
const withPlugins = (names: string[]): State => {
  const state = newState({})

  state.snapshot = { plugins: { installed: names.map(name => ({ id: `${name}@ruflo`, name, marketplace: 'ruflo', version: '1.0.0', scope: 'user' })) }, agents: [{}, {}], claims: [], tasks: [], neural: null, sona: null, missions: null, isRufloProject: false } as never

  return state
}
const allOk = BOOT_MODULES.map(entry => ({ area: entry.name, ok: true, problems: [] as string[] }))
const rowsFor = BOOT_ROWS + 20

describe('boot facts', () => {
  it('lights a star only on evidence, and says why a dark one is dark', () => {
    const facts = bootFacts(withPlugins(['ruflo-ruvector', 'rulake-stack']), '0.26.0', 'abc123')
    const star = (id: string) => facts.stars.find(entry => entry.id === id)

    expect(star('ruvector')).toMatchObject({ alive: true })
    expect(star('rulake')).toMatchObject({ alive: true, detail: '1 plugin' })
    expect(star('rvf')).toMatchObject({ alive: false, detail: 'ruflo-rvf is not installed' })
    expect(star('ruflo')?.alive).toBe(false)
  })

  it('lists only the numbers there is data for', () => {
    const facts = bootFacts(withPlugins(['a']), '1', '')

    expect(facts.stats.map(entry => entry.label)).toEqual(['agents', 'plugins'])
  })
})

describe('the cyberpunk log', () => {
  it('draws the title, the constellation, the scan grid and a READY that matches the evidence', () => {
    const facts = bootFacts(withPlugins(['ruflo-ruvector']), '0.26.0', 'abc123')
    const text = textOf(bootPicture('p', 90, 6000, 10, 10, rowsFor, allOk, facts))

    expect(text).toContain('RUV.NET // RUVECTOR CONSTELLATION')
    expect(text).toContain('rUv Β· ruflo v0.26.0 Β· abc123')
    expect(text).toContain('ruvector')
    expect(text).toMatch(/\[WARN\] READY Β· 33 of 33 areas verified Β· \d+ stars? dark/)
    expect(text).not.toContain('ALL STARS ALIGNED')
  })

  it('says ALL STARS ALIGNED only when every star is lit and every area verified, and reports a failed area', () => {
    const lit = withPlugins(['ruflo-ruvector', 'ruflo-rvf', 'ruflo-ruvllm', 'rulake-stack', 'ruqu-mcp', 'rvdna-mcp', 'ruflo-agentdb'])

    lit.snapshot = { ...(lit.snapshot as object), isRufloProject: true, sona: { patterns: 3 } } as never

    const aligned = textOf(bootPicture('p', 90, 6000, 10, 10, rowsFor, allOk, bootFacts(lit, '1', '')))

    expect(aligned).toContain('ALL STARS ALIGNED')

    const failing = allOk.map((entry, i) => (i === 3 ? { ...entry, ok: false, problems: ['x'] } : entry))
    const failed = textOf(bootPicture('p', 90, 6000, 10, 10, rowsFor, failing, bootFacts(lit, '1', '')))

    expect(failed).not.toContain('ALL STARS ALIGNED')
    expect(failed).toMatch(/\[FAIL\] READY Β· 32 of 33 areas verified Β· 1 failed/)
  })

  it('shows the easter egg only in its window, and it decodes to rUv', () => {
    const facts = bootFacts(withPlugins([]), '1', '')

    expect(textOf(bootPicture('p', 90, EGG_FROM_MS + 1400, 10, 10, rowsFor, allOk, facts))).toContain('01110010 01010101 01110110  =  rUv')
    expect(textOf(bootPicture('p', 90, 5000, 10, 10, rowsFor, allOk, facts))).not.toContain('01110010')
    expect(eggText(EGG_FROM_MS + 1400)).toBe(eggText(EGG_FROM_MS + 1400))
  })

  it('is deterministic and scrambles into place', () => {
    expect(scramble('ruflo', 1000, 1000, 500)).toHaveLength(5)
    expect(scramble('ruflo', 1600, 1000, 500)).toBe('ruflo')
    expect(scramble('ruflo', 900, 1000, 500)).toBe('')
    expect(textOf(bootPicture('p', 90, 3000, 10, 10, rowsFor, allOk, bootFacts(withPlugins([]), '1', '')))).toBe(textOf(bootPicture('p', 90, 3000, 10, 10, rowsFor, allOk, bootFacts(withPlugins([]), '1', ''))))
  })

  it('falls back to the plain log in a narrow or short pane', () => {
    const facts = bootFacts(withPlugins([]), '1', '')

    expect(textOf(bootPicture('p', 44, 6000, 10, 10, rowsFor, allOk, facts))).toContain('[ OK ] READY 33 of 33 areas verified')
    expect(textOf(bootPicture('p', 90, 6000, 10, 10, BOOT_ROWS + 6, allOk, facts))).not.toContain('RUV.NET')
  })
})

describe('restart (the footer Refresh and r)', () => {
  it('replays the intro: a pane that finished booting boots again from the new start, in the BBS look only', async () => {
    const { isBooting, BOOT_MIN_MS } = await import('../hooks/state')
    const state = newState({})

    state.options.look = 'bbs'
    state.options.boot = true
    state.snapshot = {} as never
    state.pane.bootAtMs = 1_000

    expect(isBooting(state, 1_000 + BOOT_MIN_MS + 1)).toBe(false)

    state.pane.bootAtMs = 100_000

    expect(isBooting(state, 100_500)).toBe(true)
    expect(isBooting(state, 100_000 + BOOT_MIN_MS + 1)).toBe(false)

    state.options.look = 'plain'

    expect(isBooting(state, 100_500)).toBe(false)
  })
})

describe('the constellation animation', () => {
  const dots = (age: number): number => [...textOf(bootPicture('p', 90, age, 10, 10, rowsFor, allOk, bootFacts(withPlugins(['ruflo-ruvector', 'ruflo-rvf']), '1', '')))].filter(ch => ch === 'Β·').length

  it('flashes a lit star on as it locks, and never lights a dark one', () => {
    const facts = bootFacts(withPlugins([]), '1', '')
    const lock = textOf(bootPicture('p', 90, 1500 + 100, 10, 10, rowsFor, allOk, facts))
    const later = textOf(bootPicture('p', 90, 6000, 10, 10, rowsFor, allOk, facts))

    expect(facts.stars.every(star => !star.alive)).toBe(true)
    expect(later).not.toMatch(/[β˜…βœ¦βœΊ]/)
    expect(lock).not.toContain('✺')

    const lit = bootFacts(withPlugins(['ruflo-ruvector']), '1', '')

    lit.stars.find(star => star.id === 'ruflo')!.alive = true
    expect(textOf(bootPicture('p', 90, 1500 + 100, 10, 10, rowsFor, allOk, lit))).toContain('✺')
  })

  it('draws its lines out over time rather than all at once', () => {
    expect(dots(1500 + 1000 + 100)).toBeLessThan(dots(1500 + 1000 + 1000))
  })
})

describe('the border round the boot animation', () => {
  const at = (grid: ReturnType<typeof bootPicture>, x: number, y: number): string => String.fromCodePoint(grid.glyph(x, y))
  const frame = (age: number, columns = 90) => bootPicture('p', columns, age, 10, 10, BOOT_ROWS + 20, allOk, undefined)
  const row = (grid: ReturnType<typeof bootPicture>, y: number): string => Array.from({ length: grid.columns }, (_, x) => at(grid, x, y)).join('')

  it('encloses the whole area, wall included: corners at the edges of the picture, a row above and a row below the sign', () => {
    for (const columns of [90, 60, 44]) {
      const grid = frame(4_000, columns)

      expect(at(grid, 0, 0), `${columns} columns`).toBe('β•”')
      expect(at(grid, columns - 1, 0)).toBe('β•—')
      expect(at(grid, 0, NEON_ROWS + 1)).toBe('β•š')
      expect(at(grid, columns - 1, NEON_ROWS + 1)).toBe('╝')
      expect(row(grid, 0)).toMatch(/^╔═+β•—$/)
      expect(row(grid, 3)[0]).toBe('β•‘')
      expect(row(grid, 3).at(-1)).toBe('β•‘')
    }
  })

  const colours = (age: number): Set<number> => {
    const grid = frame(age)
    const found = new Set<number>()

    for (let i = 0; i < grid.columns * (NEON_ROWS + 2); i++) if ('β•”β•β•—β•‘β•šβ•'.includes(String.fromCodePoint(grid.cells[i * 3] as number))) found.add(grid.cells[i * 3 + 1] as number)

    return found
  }

  it('is dim before the sign switches on', () => {
    expect([...colours(100)]).toEqual([0x6b7280])
  })

  it('is one single colour (pink) once the animation is complete, and stays so', () => {
    expect([...colours(4_000)]).toEqual([0xff2a6d])
    expect([...colours(9_000)]).toEqual([0xff2a6d])
  })

  it('goes white, then blue, then pink while it strikes, with the dim yet to come', () => {
    const mid = colours(400 + 450)

    expect(mid.has(0xffffff)).toBe(true)
    expect(mid.has(0x3a7bff)).toBe(true)
    expect(mid.has(0xff2a6d)).toBe(true)
    expect(mid.has(0x6b7280)).toBe(true)
  })

  it('strikes round the edge over time: more of it is lit later', () => {
    const lit = (age: number): number => {
      const grid = frame(age)
      let n = 0

      for (let i = 0; i < grid.columns * (NEON_ROWS + 2); i++) if ([0xff2a6d, 0x05d9e8, 0xffffff].includes(grid.cells[i * 3 + 1] as number) && 'β•”β•β•—β•‘β•šβ•'.includes(String.fromCodePoint(grid.cells[i * 3] as number))) n++

      return n
    }

    expect(lit(300)).toBe(0)
    expect(lit(400 + 450)).toBeGreaterThan(0)
    expect(lit(400 + 450)).toBeLessThan(lit(4_000))
  })
})

describe('the boot scan grid\'s names', () => {
  it('all fit their cell whole: none is clipped mid-word', () => {
    for (const entry of BOOT_MODULES) {
      const shown = SCAN_NAMES[entry.name] ?? entry.name

      expect(shown.length, entry.name).toBeLessThanOrEqual(SCAN_NAME_CELLS)
    }
  })
})

describe('the uplink in a narrow or short pane', () => {
  const lines = (columns: number, rows: number, age = 6000, facts = bootFacts(withPlugins(['ruflo-ruvector']), '0.26.0', 'abc123')): string[] => textOf(bootPicture('p', columns, age, 10, 10, rows, allOk, facts)).split('\n')

  it.each([48, 60, 72])('draws the whole uplink at %i columns: title, constellation, scan, READY, none cut mid-word', columns => {
    const text = lines(columns, BOOT_ROWS + 30).join('\n')

    expect(text).toContain('RUV.NET')
    expect(text).toMatch(/rUv/)
    expect(text).toMatch(/[β˜…β˜†]/)
    expect(text).toContain('[ OK ]')
    expect(text).toMatch(/READY/)
    expect(text).not.toMatch(/areas verifi\b|areas veri\b/)
    for (const line of lines(columns, BOOT_ROWS + 30)) expect(line.length, line).toBeLessThanOrEqual(columns)
  })

  it('draws a compact constellation (five rows) when the pane is shorter, and none when it is shorter still', () => {
    const scanRows = Math.ceil(BOOT_MODULES.length / 4)
    const compact = lines(72, BOOT_ROWS + 1 + 1 + 5 + 1 + scanRows + 1).join('\n')
    const none = lines(72, BOOT_ROWS + 1 + 1 + 1 + scanRows + 1).join('\n')

    expect(compact).toMatch(/[β˜…β˜†]/)
    expect(compact).toMatch(/READY/)
    expect(none).not.toMatch(/[β˜…β˜†]/)
    expect(none).toMatch(/READY/)
  })

  it('says ALL STARS ALIGNED whole at 60 columns when everything is lit, and keeps the easter egg short enough to fit', () => {
    const lit = withPlugins(['ruflo-ruvector', 'ruflo-rvf', 'ruflo-ruvllm', 'rulake-stack', 'ruqu-mcp', 'rvdna-mcp', 'ruflo-agentdb'])

    lit.snapshot = { ...(lit.snapshot as object), isRufloProject: true, sona: { patterns: 3 } } as never

    expect(lines(60, BOOT_ROWS + 20, 6000, bootFacts(lit, '0.26.0', 'abc123')).join('\n')).toContain('ALL STARS ALIGNED')
    expect(eggText(EGG_FROM_MS + 1400, false)).toContain('=  rUv')
    expect(eggText(EGG_FROM_MS + 1400, false)).not.toContain('the stars')
  })

  it('still falls back to the plain log under 48 columns', () => {
    expect(lines(44, BOOT_ROWS + 20).join('\n')).not.toContain('RUV.NET')
  })
})