Skip to content

armgit / mso

Public Imported from GitHub
0

Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.

3.8 KB
Raw Blame
import { describe, it } from 'node:test'
import assert from 'node:assert/strict'
import { parseArgs, main } from './cli.mjs'
import { assertConfiguredAdvertisedEndpoint, assertPersistentPort } from './supervision.mjs'

const argv = (...rest) => ['node', 'cli.mjs', ...rest]

describe('strict CLI argument parsing', () => {
  it('parses every supported flag and defaults to help', () => {
    const res = parseArgs(argv(
      'smoke', '--managed-root', '/srv/orca', '--port', '6769', '--bind', '127.0.0.1',
      '--advertised-endpoint', 'wss://orca.example.test', '--deb', '/tmp/orca.deb',
      '--allow-download'
    ))
    assert.equal(res.command, 'smoke')
    assert.equal(res.managedRoot, '/srv/orca')
    assert.equal(res.port, 6769)
    assert.equal(res.bind, '127.0.0.1')
    assert.equal(res.advertisedEndpoint, 'wss://orca.example.test')
    assert.equal(res.deb, '/tmp/orca.deb')
    assert.equal(res.allowDownload, true)
    assert.equal(parseArgs(['node', 'cli.mjs']).command, 'help')
  })

  it('rejects unknown, duplicate, positional, and valueless flags', () => {
    assert.throws(() => parseArgs(argv('smoke', '--managed-root', '/srv', '--nope')), /unknown flag/i)
    assert.throws(() => parseArgs(argv('smoke', '--managed-root', '/srv', '--port', '1', '--port', '2')), /duplicate flag/i)
    assert.throws(() => parseArgs(argv('smoke', '--managed-root', '/srv', 'stray')), /unexpected argument/i)
    assert.throws(() => parseArgs(argv('smoke', '--managed-root')), /missing value/i)
    assert.throws(() => parseArgs(argv('smoke', '--managed-root', '--port', '6769')), /missing value/i)
    assert.throws(() => parseArgs(argv('smoke', '--managed-root', '/srv', '--port', '6769x')), /port must be an integer/i)
    assert.throws(() => parseArgs(argv('launch')), /unknown command/i)
    assert.throws(() => parseArgs(['node', 'cli.mjs', '--managed-root', '/srv']), /missing command/i)
  })

  it('has no unchecked template/web acquisition bypass', () => {
    for (const flag of ['--template', '--web']) {
      assert.throws(
        () => parseArgs(argv('materialize', '--managed-root', '/srv', flag, '/tmp/upstream')),
        /unknown flag/i
      )
    }
  })

  it('requires --managed-root before running a command', async () => {
    await assert.rejects(() => main(argv('materialize')), /requires --managed-root/i)
  })

  it('prints usage without preparing a release', async () => {
    const lines = []
    const result = await main(argv('help'), { log: { log: (line) => lines.push(line) } })
    assert.equal(result.command, 'help')
    assert.match(lines.join('\n'), /Usage: node scripts\/orca\/cli.mjs/)
  })
})

describe('persistent run configuration', () => {
  it('accepts only a non-loopback wss advertised endpoint', () => {
    assert.equal(assertConfiguredAdvertisedEndpoint('wss://orca.example.test'), 'wss://orca.example.test')
    assert.equal(
      assertConfiguredAdvertisedEndpoint('wss://orca.example.test/runtime/'),
      'wss://orca.example.test/runtime'
    )
    assert.throws(() => assertConfiguredAdvertisedEndpoint('ws://orca.example.test'), /wss/i)
    assert.throws(() => assertConfiguredAdvertisedEndpoint('wss://127.0.0.1:6769'), /loopback/i)
    assert.throws(() => assertConfiguredAdvertisedEndpoint('wss://localhost:6769'), /loopback/i)
    assert.throws(() => assertConfiguredAdvertisedEndpoint('wss://orca.example.test/?token=x'), /credentials|query/i)
    assert.throws(() => assertConfiguredAdvertisedEndpoint('not a url'), /valid URL/i)
    assert.throws(() => assertConfiguredAdvertisedEndpoint(''), /requires/i)
  })

  it('rejects dynamic and out-of-range persistent ports', () => {
    assert.equal(assertPersistentPort(6769), 6769)
    assert.throws(() => assertPersistentPort(0), /fixed port/i)
    assert.throws(() => assertPersistentPort(65536), /fixed port/i)
    assert.throws(() => assertPersistentPort('6769x'), /fixed port/i)
  })
})