ramulus 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,17 @@
-# Temporary Holding Version
+# Ramulus
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Every branch of your repository, in one graph. Ramulus starts a small local server on top of the `git` you already have and opens the UI in your browser.
+
+```sh
+npx ramulus            # in a repository
+npx ramulus ~/code/app # or point it at one
+```
+
+Options: `--port N` to pick a port, `--no-open` to only print the URL.
+
+- Needs Node 20 or newer and `git` on your PATH. Works on macOS, Windows and Linux.
+- Everything runs through your installed git, so SSH keys, credential helpers, hooks and LFS behave exactly as on the command line.
+- The server listens on 127.0.0.1 only and every request carries a per-run token, so other pages and other machines cannot reach your repository.
+- Commit graph with lanes, branches, tags, stashes, staging with diffs, commit and amend, merge, rebase, cherry-pick, revert, reset, fetch, pull, push, and a banner with Continue and Abort when a merge or rebase stops on conflicts.
+
+Source and the native desktop app: https://github.com/a-ahandani/ramulus

package/bin/ramulus.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+import { randomBytes } from 'node:crypto'
+import { spawn } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { toplevel } from '../lib/git.js'
+import { createServer } from '../lib/server.js'
+
+const args = process.argv.slice(2)
+if (args.includes('-h') || args.includes('--help')) {
+  console.log('Usage: ramulus [path] [--port N] [--no-open]\n\nServes the Ramulus UI for the repository at path (default: current directory).')
+  process.exit(0)
+}
+const portArg = args.indexOf('--port')
+const port = portArg >= 0 ? Number(args[portArg + 1]) : 0
+const noOpen = args.includes('--no-open')
+const pathArg = args.find((a, i) => !a.startsWith('-') && args[i - 1] !== '--port') ?? '.'
+
+let dir
+try {
+  dir = await toplevel(resolve(pathArg))
+} catch (e) {
+  console.error(`Not a git repository: ${resolve(pathArg)}\n${e.message}`)
+  process.exit(1)
+}
+
+const uiDir = join(dirname(fileURLToPath(import.meta.url)), '..', 'ui')
+if (!existsSync(join(uiDir, 'index.html'))) {
+  console.error('The UI build is missing. Run `npm run build` in the cli folder first.')
+  process.exit(1)
+}
+
+const token = randomBytes(16).toString('hex')
+const server = createServer({ dir, uiDir, token })
+server.listen(port, '127.0.0.1', () => {
+  const url = `http://127.0.0.1:${server.address().port}/#${token}`
+  console.log(`Ramulus is serving ${dir}\n${url}\nPress Ctrl+C to stop.`)
+  if (!noOpen) {
+    const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'cmd' : 'xdg-open'
+    const cmdArgs = process.platform === 'win32' ? ['/c', 'start', '', url] : [url]
+    spawn(cmd, cmdArgs, { stdio: 'ignore', detached: true }).on('error', () => {}).unref()
+  }
+})

package/lib/git.js

@@ -0,0 +1,388 @@
+import { execFile } from 'node:child_process'
+import { existsSync, statSync } from 'node:fs'
+import { join } from 'node:path'
+
+const NUL = '\0'
+const RS = '\x1e'
+
+export function run(dir, args, { input, allowFail = false } = {}) {
+  return new Promise((resolve, reject) => {
+    const child = execFile(
+      'git',
+      args,
+      { cwd: dir, maxBuffer: 256 * 1024 * 1024, env: { ...process.env, GIT_TERMINAL_PROMPT: '0', GIT_OPTIONAL_LOCKS: '0', LC_ALL: 'C' } },
+      (err, stdout, stderr) => {
+        if (err && !allowFail) {
+          const msg = (stderr || stdout || err.message).toString().trim()
+          reject(new Error(msg || `git ${args[0]} failed`))
+        } else {
+          resolve({ ok: !err, stdout: stdout.toString(), stderr: stderr.toString() })
+        }
+      },
+    )
+    if (input !== undefined) child.stdin.end(input)
+    else child.stdin.end()
+  })
+}
+
+function safeName(name) {
+  if (typeof name !== 'string' || name.length === 0 || name.startsWith('-')) throw new Error(`Invalid name: ${JSON.stringify(name)}`)
+  return name
+}
+
+function safePaths(paths) {
+  if (!Array.isArray(paths) || paths.length === 0) throw new Error('No files given')
+  return paths.map((p) => {
+    if (typeof p !== 'string' || p.length === 0) throw new Error('Invalid path')
+    return p
+  })
+}
+
+export async function toplevel(dir) {
+  return (await run(dir, ['rev-parse', '--show-toplevel'])).stdout.trim()
+}
+
+async function stateOf(dir) {
+  const gitDir = (await run(dir, ['rev-parse', '--git-dir'])).stdout.trim()
+  const at = (p) => existsSync(join(dir, gitDir, p))
+  if (at('MERGE_HEAD')) return 'merge'
+  if (at('rebase-merge') || at('rebase-apply')) return 'rebase'
+  if (at('CHERRY_PICK_HEAD')) return 'cherry-pick'
+  if (at('REVERT_HEAD')) return 'revert'
+  return null
+}
+
+export function parseStatus(porcelainZ) {
+  const out = { staged: [], unstaged: [] }
+  const items = porcelainZ.split(NUL)
+  for (let i = 0; i < items.length; i++) {
+    const item = items[i]
+    if (item.length < 4) continue
+    const x = item[0]
+    const y = item[1]
+    let path = item.slice(3)
+    if (x === 'R' || x === 'C') {
+      i++
+    }
+    if (x === '?') {
+      out.unstaged.push({ path, kind: '?' })
+      continue
+    }
+    if (x === 'U' || y === 'U' || (x === 'A' && y === 'A') || (x === 'D' && y === 'D')) {
+      out.unstaged.push({ path, kind: 'M', conflict: true })
+      continue
+    }
+    if (x !== ' ') out.staged.push({ path, kind: x === 'A' ? 'A' : x === 'D' ? 'D' : 'M' })
+    if (y !== ' ') out.unstaged.push({ path, kind: y === 'D' ? 'D' : 'M' })
+  }
+  return out
+}
+
+export async function status(dir) {
+  const { stdout } = await run(dir, ['status', '--porcelain=v1', '-z', '--untracked-files=all'])
+  return { ...parseStatus(stdout), state: await stateOf(dir) }
+}
+
+export function parseLog(text, stashInfo) {
+  const commits = []
+  for (const rec of text.split(RS)) {
+    const t = rec.replace(/^\n/, '')
+    if (!t.trim()) continue
+    const [id, parents, author, email, time, summary, body = ''] = t.split(NUL)
+    if (!id) continue
+    if (stashInfo.internals.has(id)) continue
+    const stash = stashInfo.messages.get(id)
+    const ps = parents ? parents.split(' ') : []
+    commits.push({
+      id,
+      parents: stash !== undefined ? ps.slice(0, 1) : ps,
+      author,
+      email,
+      time: Number(time),
+      summary: stash ?? summary,
+      body: body.trim(),
+      kind: stash !== undefined ? 'stash' : ps.length > 1 ? 'merge' : 'commit',
+    })
+  }
+  return commits
+}
+
+export async function load(dir, limit = 2000) {
+  const headBranch = (await run(dir, ['symbolic-ref', '-q', '--short', 'HEAD'], { allowFail: true })).stdout.trim() || undefined
+  const headOid = (await run(dir, ['rev-parse', '-q', '--verify', 'HEAD'], { allowFail: true })).stdout.trim() || undefined
+  const refsByOid = {}
+  const addRef = (oid, label) => (refsByOid[oid] ??= []).push(label)
+  const local = []
+  const remote = []
+  const tags = []
+  const refs = await run(dir, ['for-each-ref', '--format=%(refname)%00%(objectname)%00%(*objectname)%00%(symref)', 'refs/heads', 'refs/remotes', 'refs/tags'])
+  for (const line of refs.stdout.split('\n')) {
+    if (!line) continue
+    const [refname, objectname, peeled, symref] = line.split(NUL)
+    if (symref) continue
+    const oid = peeled || objectname
+    if (refname.startsWith('refs/heads/')) {
+      const name = refname.slice(11)
+      local.push({ name, oid, isHead: name === headBranch })
+      addRef(oid, { name, kind: 'head', current: name === headBranch })
+    } else if (refname.startsWith('refs/remotes/')) {
+      const name = refname.slice(13)
+      remote.push({ name, oid, isHead: false })
+      addRef(oid, { name, kind: 'remote' })
+    } else if (refname.startsWith('refs/tags/')) {
+      const name = refname.slice(10)
+      tags.push({ name, oid })
+      addRef(oid, { name, kind: 'tag' })
+    }
+  }
+  const stashes = []
+  const stashList = await run(dir, ['stash', 'list', '--format=%H%x00%s'], { allowFail: true })
+  for (const line of stashList.stdout.split('\n')) {
+    if (!line) continue
+    const [oid, message] = line.split(NUL)
+    stashes.push({ index: stashes.length, message, oid })
+  }
+  const internals = new Set()
+  if (stashes.length > 0) {
+    const parents = await run(dir, ['rev-list', '--no-walk', '--parents', ...stashes.map((s) => s.oid)])
+    for (const line of parents.stdout.split('\n')) {
+      const [, ...ps] = line.trim().split(' ')
+      ps.slice(1).forEach((p) => internals.add(p))
+    }
+  }
+  const log = await run(dir, [
+    'log',
+    '--date-order',
+    `--max-count=${limit + 1 + internals.size}`,
+    '--format=%H%x00%P%x00%an%x00%ae%x00%ct%x00%s%x00%b%x1e',
+    '--all',
+  ], { allowFail: true })
+  const commits = parseLog(log.stdout, { internals, messages: new Map(stashes.map((s) => [s.oid, s.message])) })
+  const hasMore = commits.length > limit
+  return {
+    name: dir.split(/[\\/]/).filter(Boolean).pop(),
+    headBranch,
+    headOid,
+    commits: commits.slice(0, limit),
+    refsByOid,
+    local,
+    remote,
+    tags,
+    stashes,
+    status: await status(dir),
+    hasMore,
+    native: true,
+  }
+}
+
+async function parentOf(dir, oid) {
+  return (await run(dir, ['rev-parse', '-q', '--verify', `${oid}^`], { allowFail: true })).stdout.trim() || undefined
+}
+
+export async function commitFiles(dir, oid) {
+  const parent = await parentOf(dir, oid)
+  const args = parent ? ['diff-tree', '-r', '-z', '-M', '--name-status', parent, oid] : ['diff-tree', '--root', '-r', '-z', '-M', '--name-status', oid]
+  const { stdout } = await run(dir, args)
+  const parts = stdout.split(NUL)
+  const out = []
+  for (let i = 0; i < parts.length - 1; i += 2) {
+    const code = parts[i][0]
+    let path = parts[i + 1]
+    if (code === 'R' || code === 'C') {
+      path = parts[i + 2]
+      i++
+    }
+    if (!path) continue
+    out.push({ path, kind: code === 'A' ? 'A' : code === 'D' ? 'D' : 'M' })
+  }
+  return out
+}
+
+export function parseDiff(text) {
+  const lines = []
+  let inHunk = false
+  for (const raw of text.split('\n')) {
+    if (raw.startsWith('@@')) {
+      inHunk = true
+      lines.push({ type: 'hunk', text: raw })
+    } else if (raw.startsWith('Binary files')) {
+      lines.push({ type: 'note', text: 'Binary file' })
+    } else if (!inHunk) {
+      continue
+    } else if (raw.startsWith('+')) lines.push({ type: 'add', text: raw.slice(1) })
+    else if (raw.startsWith('-')) lines.push({ type: 'del', text: raw.slice(1) })
+    else if (raw.startsWith(' ')) lines.push({ type: 'ctx', text: raw.slice(1) })
+    else if (raw.startsWith('\\')) lines.push({ type: 'note', text: raw })
+  }
+  return lines
+}
+
+export async function diff(dir, area, path) {
+  safePaths([path])
+  let args
+  if (area.kind === 'commit') {
+    const parent = await parentOf(dir, area.oid)
+    args = parent ? ['diff', '--no-color', '-M', parent, area.oid, '--', path] : ['show', '--format=', '--no-color', area.oid, '--', path]
+  } else if (area.kind === 'staged') {
+    args = ['diff', '--no-color', '--cached', '--', path]
+  } else {
+    const tracked = (await run(dir, ['ls-files', '--error-unmatch', '--', path], { allowFail: true })).ok
+    args = tracked ? ['diff', '--no-color', '--', path] : ['diff', '--no-color', '--no-index', '--', '/dev/null', path]
+  }
+  const { stdout } = await run(dir, args, { allowFail: true })
+  return parseDiff(stdout)
+}
+
+export async function stage(dir, paths) {
+  await run(dir, ['add', '-A', '--', ...safePaths(paths)])
+}
+
+export async function unstage(dir, paths) {
+  await run(dir, ['reset', '-q', '--', ...safePaths(paths)])
+}
+
+export async function discard(dir, files) {
+  const tracked = files.filter((f) => f.kind !== '?').map((f) => f.path)
+  const untracked = files.filter((f) => f.kind === '?').map((f) => f.path)
+  if (tracked.length) await run(dir, ['checkout', '-q', '--', ...safePaths(tracked)])
+  if (untracked.length) await run(dir, ['clean', '-f', '-q', '--', ...safePaths(untracked)])
+}
+
+export async function commit(dir, message, amend) {
+  if (!message || !message.trim()) throw new Error('A commit message is required')
+  await run(dir, ['commit', '-q', '-F', '-', ...(amend ? ['--amend'] : [])], { input: message })
+}
+
+export async function checkoutBranch(dir, name) {
+  await run(dir, ['switch', '-q', safeName(name)])
+}
+
+export async function checkoutRemote(dir, name) {
+  safeName(name)
+  const i = name.indexOf('/')
+  const local = name.slice(i + 1)
+  const exists = (await run(dir, ['rev-parse', '-q', '--verify', `refs/heads/${local}`], { allowFail: true })).ok
+  await run(dir, exists ? ['switch', '-q', local] : ['switch', '-q', '-c', local, '--track', name])
+}
+
+export async function checkoutCommit(dir, oid) {
+  await run(dir, ['switch', '-q', '--detach', safeName(oid)])
+}
+
+export async function createBranch(dir, name, at, checkout) {
+  await run(dir, ['branch', '--', safeName(name), safeName(at)])
+  if (checkout) await run(dir, ['switch', '-q', name])
+}
+
+export async function deleteBranch(dir, name) {
+  await run(dir, ['branch', '-D', '--', safeName(name)])
+}
+
+export async function renameBranch(dir, oldName, newName) {
+  await run(dir, ['branch', '-m', '--', safeName(oldName), safeName(newName)])
+}
+
+export async function createTag(dir, name, at, message) {
+  if (message && message.trim()) await run(dir, ['tag', '-a', '-F', '-', '--', safeName(name), safeName(at)], { input: message })
+  else await run(dir, ['tag', '--', safeName(name), safeName(at)])
+}
+
+export async function deleteTag(dir, name) {
+  await run(dir, ['tag', '-d', '--', safeName(name)])
+}
+
+export async function stashSave(dir, message) {
+  await run(dir, ['stash', 'push', '-u', '-q', ...(message && message.trim() ? ['-m', message] : [])])
+}
+
+export async function stashApply(dir, index, pop) {
+  await run(dir, ['stash', pop ? 'pop' : 'apply', '-q', `stash@{${Number(index)}}`])
+}
+
+export async function stashDrop(dir, index) {
+  await run(dir, ['stash', 'drop', '-q', `stash@{${Number(index)}}`])
+}
+
+export async function merge(dir, branch) {
+  const r = await run(dir, ['merge', '--no-edit', safeName(branch)], { allowFail: true })
+  if (!r.ok) {
+    if ((await stateOf(dir)) === 'merge') return 'conflicts'
+    throw new Error((r.stderr || r.stdout).trim())
+  }
+  return /Already up to date/i.test(r.stdout) ? 'up-to-date' : /Fast-forward/.test(r.stdout) ? 'fast-forward' : 'merged'
+}
+
+export async function rebase(dir, onto) {
+  const r = await run(dir, ['-c', 'core.editor=true', 'rebase', '--', safeName(onto)], { allowFail: true })
+  if (!r.ok) {
+    if ((await stateOf(dir)) === 'rebase') return 'conflicts'
+    throw new Error((r.stderr || r.stdout).trim())
+  }
+  return 'done'
+}
+
+export async function cherryPick(dir, oid) {
+  const r = await run(dir, ['cherry-pick', safeName(oid)], { allowFail: true })
+  if (!r.ok) {
+    if ((await stateOf(dir)) === 'cherry-pick') return 'conflicts'
+    throw new Error((r.stderr || r.stdout).trim())
+  }
+  return 'done'
+}
+
+export async function revert(dir, oid) {
+  const r = await run(dir, ['revert', '--no-edit', safeName(oid)], { allowFail: true })
+  if (!r.ok) {
+    if ((await stateOf(dir)) === 'revert') return 'conflicts'
+    throw new Error((r.stderr || r.stdout).trim())
+  }
+  return 'done'
+}
+
+export async function reset(dir, oid, mode) {
+  if (!['soft', 'mixed', 'hard'].includes(mode)) throw new Error('Invalid reset mode')
+  await run(dir, ['reset', '-q', `--${mode}`, safeName(oid)])
+}
+
+export async function abort(dir) {
+  const state = await stateOf(dir)
+  if (!state) return
+  await run(dir, [state, '--abort'])
+}
+
+export async function continueOp(dir) {
+  const state = await stateOf(dir)
+  if (!state) return
+  if (state === 'merge') await run(dir, ['-c', 'core.editor=true', 'commit', '-q', '--no-edit'])
+  else await run(dir, ['-c', 'core.editor=true', state, '--continue'])
+}
+
+export async function fetchAll(dir) {
+  await run(dir, ['fetch', '--all', '--prune'])
+}
+
+export async function pull(dir, mode) {
+  const flag = mode === 'rebase' ? '--rebase' : mode === 'ff-only' ? '--ff-only' : '--no-rebase'
+  await run(dir, ['pull', flag])
+}
+
+export async function push(dir) {
+  const upstream = (await run(dir, ['rev-parse', '-q', '--abbrev-ref', '@{u}'], { allowFail: true })).ok
+  if (upstream) {
+    await run(dir, ['push'])
+    return
+  }
+  const branch = (await run(dir, ['symbolic-ref', '-q', '--short', 'HEAD'])).stdout.trim()
+  const remotes = (await run(dir, ['remote'])).stdout.trim().split('\n').filter(Boolean)
+  const remote = remotes.includes('origin') ? 'origin' : remotes[0]
+  if (!remote) throw new Error('This repository has no remote to push to')
+  await run(dir, ['push', '-u', '--', remote, branch])
+}
+
+export function isRepo(dir) {
+  try {
+    return statSync(dir).isDirectory()
+  } catch {
+    return false
+  }
+}

package/lib/server.js

@@ -0,0 +1,125 @@
+import { createReadStream, existsSync, statSync, watch } from 'node:fs'
+import http from 'node:http'
+import { extname, join, normalize } from 'node:path'
+import * as git from './git.js'
+
+const TYPES = { '.html': 'text/html; charset=utf-8', '.js': 'text/javascript', '.css': 'text/css', '.svg': 'image/svg+xml', '.png': 'image/png', '.json': 'application/json' }
+
+const OPS = {
+  load: (dir, b) => git.load(dir, b.limit),
+  status: (dir) => git.status(dir),
+  commitFiles: (dir, b) => git.commitFiles(dir, b.oid),
+  diff: (dir, b) => git.diff(dir, b.area, b.path),
+  stage: (dir, b) => git.stage(dir, b.paths),
+  unstage: (dir, b) => git.unstage(dir, b.paths),
+  discard: (dir, b) => git.discard(dir, b.files),
+  commit: (dir, b) => git.commit(dir, b.message, b.amend),
+  checkoutBranch: (dir, b) => git.checkoutBranch(dir, b.name),
+  checkoutRemote: (dir, b) => git.checkoutRemote(dir, b.name),
+  checkoutCommit: (dir, b) => git.checkoutCommit(dir, b.oid),
+  createBranch: (dir, b) => git.createBranch(dir, b.name, b.at, b.checkout),
+  deleteBranch: (dir, b) => git.deleteBranch(dir, b.name),
+  renameBranch: (dir, b) => git.renameBranch(dir, b.oldName, b.newName),
+  createTag: (dir, b) => git.createTag(dir, b.name, b.at, b.message),
+  deleteTag: (dir, b) => git.deleteTag(dir, b.name),
+  stashSave: (dir, b) => git.stashSave(dir, b.message),
+  stashApply: (dir, b) => git.stashApply(dir, b.index, b.pop),
+  stashDrop: (dir, b) => git.stashDrop(dir, b.index),
+  merge: (dir, b) => git.merge(dir, b.branch),
+  rebase: (dir, b) => git.rebase(dir, b.onto),
+  cherryPick: (dir, b) => git.cherryPick(dir, b.oid),
+  revert: (dir, b) => git.revert(dir, b.oid),
+  reset: (dir, b) => git.reset(dir, b.oid, b.mode),
+  abort: (dir) => git.abort(dir),
+  continue: (dir) => git.continueOp(dir),
+  fetchAll: (dir) => git.fetchAll(dir),
+  pull: (dir, b) => git.pull(dir, b.mode),
+  push: (dir) => git.push(dir),
+}
+
+function readBody(req) {
+  return new Promise((resolve, reject) => {
+    const chunks = []
+    req.on('data', (c) => chunks.push(c))
+    req.on('end', () => {
+      try {
+        resolve(chunks.length ? JSON.parse(Buffer.concat(chunks).toString()) : {})
+      } catch (e) {
+        reject(e)
+      }
+    })
+    req.on('error', reject)
+  })
+}
+
+function sendJson(res, status, data) {
+  res.writeHead(status, { 'content-type': 'application/json', 'cache-control': 'no-store' })
+  res.end(JSON.stringify(data ?? null))
+}
+
+export function createServer({ dir, uiDir, token }) {
+  const clients = new Set()
+  let timer
+  const notify = () => {
+    clearTimeout(timer)
+    timer = setTimeout(() => {
+      for (const res of clients) res.write('data: changed\n\n')
+    }, 400)
+  }
+  try {
+    watch(dir, { recursive: true }, (_, file) => {
+      const f = (file ?? '').toString().replaceAll('\\', '/')
+      if (f.includes('.git/objects') || f.endsWith('.lock') || f.includes('node_modules')) return
+      notify()
+    })
+  } catch {
+    /* recursive watching is unavailable on this platform; the UI still has a refresh button */
+  }
+
+  const server = http.createServer(async (req, res) => {
+    const host = req.headers.host ?? ''
+    if (!/^(127\.0\.0\.1|localhost|\[::1\])(:\d+)?$/.test(host)) {
+      res.writeHead(403).end('forbidden host')
+      return
+    }
+    const url = new URL(req.url, 'http://localhost')
+    if (url.pathname === '/api/events') {
+      if (url.searchParams.get('token') !== token) {
+        res.writeHead(401).end()
+        return
+      }
+      res.writeHead(200, { 'content-type': 'text/event-stream', 'cache-control': 'no-store', connection: 'keep-alive' })
+      res.write(': connected\n\n')
+      clients.add(res)
+      req.on('close', () => clients.delete(res))
+      return
+    }
+    if (url.pathname.startsWith('/api/')) {
+      if (req.headers['x-ramulus-token'] !== token) {
+        sendJson(res, 401, { error: 'bad token' })
+        return
+      }
+      const op = OPS[url.pathname.slice(5)]
+      if (!op || req.method !== 'POST') {
+        sendJson(res, 404, { error: 'unknown operation' })
+        return
+      }
+      try {
+        const body = await readBody(req)
+        sendJson(res, 200, { result: (await op(dir, body)) ?? null })
+      } catch (e) {
+        sendJson(res, 400, { error: e instanceof Error ? e.message : String(e) })
+      }
+      return
+    }
+    const rel = url.pathname === '/' ? '/index.html' : url.pathname
+    const file = join(uiDir, normalize(rel).replace(/^(\.\.[/\\])+/, ''))
+    if (!file.startsWith(uiDir) || !existsSync(file) || !statSync(file).isFile()) {
+      res.writeHead(404).end('not found')
+      return
+    }
+    res.writeHead(200, { 'content-type': TYPES[extname(file)] ?? 'application/octet-stream', 'cache-control': 'no-cache' })
+    createReadStream(file).pipe(res)
+  })
+  return server
+}

package/package.json

@@ -1,6 +1,27 @@
 {
   "name": "ramulus",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Every branch of your repository in one graph. Runs a local server on top of your installed git and opens the UI in your browser.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/a-ahandani/ramulus.git"
+  },
+  "type": "module",
+  "bin": {
+    "ramulus": "bin/ramulus.js"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "ui"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "cd ../web && npm run build && rm -rf ../cli/ui && cp -R dist ../cli/ui",
+    "prepack": "npm run build",
+    "test": "node --test test/*.test.js"
+  }
+}

package/ui/assets/index-ArxayBFH.css

@@ -0,0 +1 @@
+:root{--app-bg:#15171c;--toolbar-bg:#23262e;--panel0:#1d2026;--panel1:#272b33;--panel2:#333841;--border:#ffffff14;--text-bright:#f4f5f7;--text:#f4f5f7cc;--text-2:#f4f5f794;--text-3:#f4f5f761;--blue:#5b9cf6;--green:#3fb950;--red:#e5534b;--orange:#f08a24;--yellow:#e3b341;--lane-0:#5b9cf6;--lane-1:#3fb950;--lane-2:#f08a24;--lane-3:#e05fb8;--lane-4:#9a7cf5;--lane-5:#2cb5a8;--lane-6:#e5534b;--lane-7:#e3b341;--lane-8:#4ac8e8;--lane-9:#b4c93e;--row-h:26px;--font:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;--mono:ui-monospace, SFMono-Regular, Menlo, Consolas, monospace}*{box-sizing:border-box}html,body,#app{background:var(--app-bg);height:100%;color:var(--text);font:13px/1.4 var(--font);margin:0;overflow:hidden}button,input,textarea,select{font:inherit;color:inherit}button{background:var(--panel1);cursor:pointer;border:1px solid #0000;border-radius:4px;padding:4px 10px}button:hover:not(:disabled){background:var(--panel2)}button:disabled{color:var(--text-3);cursor:default}button.primary{background:#5b9cf659}button.success{color:var(--text-bright);background:#3fb95059}button.danger{background:#e5534b59}button.ghost{background:0 0}button.on{background:#5b9cf666}input,textarea{border:1px solid var(--border);background:#0003;border-radius:4px;width:100%;padding:5px 8px}input:focus,textarea:focus{outline:1px solid var(--blue)}.app{grid-template-rows:48px 1fr;height:100%;display:grid}.toolbar{background:var(--toolbar-bg);align-items:center;gap:6px;padding:0 10px;display:flex}.toolbar .repo{color:var(--text-bright);margin-right:4px;font-size:14px;font-weight:600}.toolbar .branch{color:var(--text);margin-right:10px}.toolbar .spacer{flex:1}.toolbar input{width:220px}.toolbar .busy{color:var(--text-2)}.body{grid-template-columns:240px 1fr 440px;min-height:0;display:grid}.body.no-left{grid-template-columns:0 1fr 440px}.body.no-right{grid-template-columns:240px 1fr 0}.body.no-left.no-right{grid-template-columns:0 1fr 0}.left,.right{background:var(--panel0);min-height:0;overflow:auto}.left{border-right:1px solid var(--border)}.right{border-left:1px solid var(--border);flex-direction:column;display:flex}.section{height:26px;color:var(--text-2);cursor:pointer;-webkit-user-select:none;user-select:none;align-items:center;padding:0 10px;font-size:11px;display:flex}.section:hover{background:#ffffff08}.section .count{color:var(--text-3);margin-left:auto}.section .arrow{width:14px}.item{cursor:default;white-space:nowrap;align-items:center;gap:8px;height:24px;padding:0 8px 0 14px;display:flex;overflow:hidden}.item:hover{background:#5b9cf61f}.item.selected{background:#5b9cf638}.item .dot{border-radius:50%;flex:none;width:6px;height:6px}.item .name{text-overflow:ellipsis;overflow:hidden}.item.strong .name{color:var(--text-bright)}.item .meta{color:var(--text-2);margin-left:auto;font-size:11px}.item.indent{padding-left:26px}.remote-name{color:var(--text-2);padding:2px 20px;font-size:12px}.empty{color:var(--text-3);padding:4px 20px;font-size:12px}.graph{background:var(--app-bg);flex-direction:column;min-height:0;display:flex}.graph-header,.row{grid-template-columns:var(--cols);align-items:center;display:grid}.graph-header{background:var(--panel0);border-bottom:1px solid var(--border);height:24px;color:var(--text-2);font-size:11px}.graph-header>div,.row>div{white-space:nowrap;text-overflow:ellipsis;padding-left:8px;overflow:hidden}.rows{flex:1;position:relative;overflow:auto}.row{height:var(--row-h);position:absolute;left:0;right:0}.row:hover{background:#5b9cf61f}.row.selected{background:#5b9cf638}.row.selected .msg{color:var(--text-bright)}.row .refs{gap:4px;padding-left:6px;display:flex}.pill{height:18px;color:var(--text);white-space:nowrap;text-overflow:ellipsis;cursor:default;border-radius:3px;flex:none;align-items:center;gap:5px;max-width:100%;padding:0 6px;font-size:12px;display:inline-flex;overflow:hidden}.pill.current{color:var(--text-bright);font-weight:600}.pill .ic{border-radius:50%;flex:none;width:7px;height:7px}.pill .ic.remote{border:1.5px solid;background:0 0!important}.pill .ic.tag{border-radius:1px;width:6px;height:6px;transform:rotate(45deg)}.row .lanes{height:100%;padding:0}.row .lanes svg{display:block}.row .msg.wip,.row .msg.stash{color:var(--text-2)}.row .date,.row .sha{color:var(--text-3);font-size:12px}.row .sha{font-family:var(--mono)}.avatar{color:#fff;border-radius:50%;flex:none;justify-content:center;align-items:center;width:20px;height:20px;font-size:9px;font-weight:600;display:inline-flex;overflow:hidden}.avatar img{object-fit:cover;width:100%;height:100%}.more{height:var(--row-h);color:var(--text-2);align-items:center;gap:8px;padding-left:180px;display:flex;position:absolute;left:0;right:0}.more a{color:var(--blue);cursor:pointer}.detail-head{padding:12px}.detail-head h2{color:var(--text-bright);white-space:pre-wrap;margin:0 0 8px;font-size:15px;font-weight:600}.detail-head .who{align-items:center;gap:8px;display:flex}.detail-head .who .avatar{width:26px;height:26px;font-size:11px}.detail-head .when{color:var(--text-2);font-size:11px}.detail-head .hashes{flex-wrap:wrap;gap:8px;margin-top:6px;display:flex}.detail-head .hashes button{font-family:var(--mono);padding:2px 6px;font-size:11px}.detail-head .body{white-space:pre-wrap;color:var(--text);max-height:120px;margin-top:8px;overflow:auto}.hr{border-top:1px solid var(--border)}.files{flex:none;max-height:40%;overflow:auto}.files.staging{max-height:45%}.fhead{height:24px;color:var(--text-2);align-items:center;padding:0 8px;font-size:12px;font-weight:600;display:flex}.fhead button{margin-left:auto;padding:1px 8px;font-size:11px}.file{cursor:default;align-items:center;gap:8px;height:24px;padding:0 6px 0 10px;display:flex}.file:hover{background:#5b9cf61f}.file.selected{background:#5b9cf638}.file .k{font-family:var(--mono);width:10px;font-size:12px}.file .n{white-space:nowrap;text-overflow:ellipsis;overflow:hidden}.file .d{color:var(--text-3);white-space:nowrap;text-overflow:ellipsis;font-size:11px;overflow:hidden}.file .acts{gap:4px;margin-left:auto;display:none}.file:hover .acts,.file.selected .acts{display:flex}.file .acts button{padding:1px 6px;font-size:11px}.gap{height:10px}.diff{font-family:var(--mono);flex:1;min-height:0;font-size:12px;overflow:auto}.diff .path{color:var(--text-2);padding:4px 8px;font-size:12px}.diff .line{white-space:pre;padding:0 8px 0 22px;line-height:18px;position:relative}.diff .line:before{position:absolute;left:8px}.diff .add{color:var(--text-bright);background:#3fb9502e}.diff .add:before{content:"+"}.diff .del{color:var(--text-bright);background:#e5534b2e}.diff .del:before{content:"-"}.diff .hunk{color:#4ac8e8e6;background:#5b9cf61f}.diff .note{color:var(--text-3);padding:8px}.placeholder{color:var(--text-3);flex:1;justify-content:center;align-items:center;display:flex}.commit-box{background:var(--panel1);flex-direction:column;gap:6px;padding:10px;display:flex}.commit-box .label{color:var(--text-2);font-size:12px;font-weight:600}.commit-box textarea{resize:vertical;min-height:60px}.commit-box .actions{align-items:center;gap:8px;display:flex}.commit-box .actions .right{background:0 0;border:0;margin-left:auto;display:block}.warn{color:var(--orange);font-size:12px}.menu{z-index:50;background:var(--panel1);border:1px solid var(--border);border-radius:4px;min-width:220px;padding:4px;position:fixed;box-shadow:0 8px 24px #0006}.menu button{text-align:left;background:0 0;border-radius:3px;width:100%;padding:4px 8px;display:block}.menu button:hover{background:#5b9cf633}.menu button.danger{color:var(--red)}.menu .sep{border-top:1px solid var(--border);margin:4px 0}.overlay{z-index:40;background:#00000080;justify-content:center;align-items:center;display:flex;position:fixed;inset:0}.dialog{background:var(--panel1);border:1px solid var(--border);border-radius:6px;flex-direction:column;gap:8px;width:420px;padding:16px;display:flex}.dialog h3{color:var(--text-bright);margin:0;font-size:14px}.dialog .buttons{justify-content:flex-end;gap:8px;margin-top:6px;display:flex}.dialog label{align-items:center;gap:6px;display:flex}.dialog label input[type=checkbox]{width:auto}.dialog .error{color:var(--red);font-size:12px}.dialog pre{white-space:pre-wrap;font-family:var(--mono);max-height:240px;margin:0;font-size:12px;overflow:auto}.toast{background:var(--panel2);color:var(--text-bright);z-index:60;border:1px solid #ffffff1a;border-radius:6px;padding:10px 14px;position:fixed;bottom:16px;right:16px}.welcome{flex-direction:column;justify-content:center;align-items:center;gap:12px;height:100%;display:flex}.welcome h1{color:var(--text-bright);margin:0;font-size:30px}.welcome p{color:var(--text-2);margin:0}.welcome .recent{flex-direction:column;align-items:center;gap:4px;margin-top:16px;display:flex}.welcome .recent a{color:var(--blue);cursor:pointer}.welcome .note{text-align:center;max-width:460px;color:var(--text-3);font-size:12px}.banner{color:var(--orange);background:#f08a2426;flex:none;align-items:center;gap:8px;padding:8px 10px;font-weight:600;display:flex}.banner span{flex:1}.toolbar select{background:var(--panel1);border:1px solid #0000;border-radius:4px}.welcome code{font-family:var(--mono);color:var(--text)}