/* BARE_OS_BIN_API 1.0.0 — bump when staged /bin script semantics change (see developer guide). */
/** Shared helpers for drive-resident /bin scripts (prepended before each command). */
function bareStdin(ctx) {
  return typeof ctx.shellStdin === 'string' ? ctx.shellStdin : ''
}

/** @param {number} mode @param {'file' | 'directory' | 'symlink'} type */
function bareFormatModeString(mode, type) {
  const typeChar = type === 'directory' ? 'd' : type === 'symlink' ? 'l' : '-'
  const perm = mode & 0o777
  const r = (bit) => (perm & bit ? 'r' : '-')
  const w = (bit) => (perm & bit ? 'w' : '-')
  const x = (bit) => (perm & bit ? 'x' : '-')
  return (
    typeChar +
    r(0o400) +
    w(0o200) +
    x(0o100) +
    r(0o040) +
    w(0o020) +
    x(0o010) +
    r(0o004) +
    w(0o002) +
    x(0o001)
  )
}

/** @param {number} mtimeMs @param {number} [nowMs] */
function bareFormatLsMtime(mtimeMs, nowMs) {
  const now = nowMs != null ? nowMs : Date.now()
  const d = new Date(mtimeMs)
  const months = [
    'Jan',
    'Feb',
    'Mar',
    'Apr',
    'May',
    'Jun',
    'Jul',
    'Aug',
    'Sep',
    'Oct',
    'Nov',
    'Dec'
  ]
  const mon = months[d.getMonth()]
  const day = String(d.getDate()).padStart(2, ' ')
  const sixMo = 180 * 24 * 3600 * 1000
  if (Math.abs(now - mtimeMs) > sixMo) {
    const yr = String(d.getFullYear()).padStart(4, ' ')
    return mon + ' ' + day + '  ' + yr
  }
  const hh = String(d.getHours()).padStart(2, '0')
  const mm = String(d.getMinutes()).padStart(2, '0')
  return mon + ' ' + day + ' ' + hh + ':' + mm
}

/** @param {number} size */
function barePosixBlocks(size) {
  return Math.ceil(Number(size) / 512) || 0
}

/**
 * Raw stdout for NUL/binary when **`process.stdout.write`** is missing.
 * If **`ctx.bareOsBinWrite(Uint8Array|string)`** is set (tests / host), use it.
 * @param {Record<string, unknown>} ctx
 * @param {string | Uint8Array} chunk
 * @returns {boolean}
 */
function bareOsEmitRaw(ctx, chunk) {
  if (typeof ctx.bareOsBinWrite === 'function') {
    const b4 = ctx.b4a
    const u8 =
      typeof chunk === 'string'
        ? b4 && typeof b4.from === 'function'
          ? b4.from(chunk)
          : new TextEncoder().encode(chunk)
        : chunk
    ctx.bareOsBinWrite(u8 instanceof Uint8Array ? u8 : new Uint8Array(u8))
    return true
  }
  const w = globalThis.process?.stdout?.write
  if (typeof w === 'function') {
    w.call(globalThis.process.stdout, chunk)
    return true
  }
  return false
}

/** Session env map (`vfs.env`, then `ctx.env`). Never throws. */
function bareOsEnv(ctx) {
  const v = ctx && ctx.vfs && ctx.vfs.env
  if (v && typeof v === 'object') return v
  const e = ctx && ctx.env
  if (e && typeof e === 'object') return e
  return {}
}

/**
 * Strict POSIX-ish decimal integer (no octal, no exponent, no empty).
 * @param {unknown} s
 * @returns {number}
 */
function bareOsParseDecInt(s) {
  const t = String(s == null ? '' : s).trim()
  if (!/^[+-]?(?:0|[1-9][0-9]*)$/.test(t)) return NaN
  const n = Number.parseInt(t, 10)
  return Number.isSafeInteger(n) ? n : NaN
}

/** @param {unknown} s */
function bareOsParseNonNegInt(s) {
  const n = bareOsParseDecInt(s)
  return n >= 0 ? n : NaN
}

/**
 * @param {Record<string, unknown>} ctx
 * @param {string} name
 * @param {number} fallback
 * @param {number} [min]
 * @param {number} [max]
 */
function bareOsEnvInt(ctx, name, fallback, min, max) {
  const raw = bareOsEnv(ctx)[name]
  if (raw == null || raw === '') return fallback
  const n = Number.parseInt(String(raw), 10)
  if (!Number.isFinite(n)) return fallback
  let v = n
  if (min != null && v < min) v = min
  if (max != null && v > max) v = max
  return v
}

/**
 * @param {Record<string, unknown>} ctx
 * @param {string} msg
 * @param {number} [code]
 */
function bareOsFail(ctx, msg, code) {
  if (msg) ctx.console.error(msg)
  ctx.exitCode = code == null ? 1 : code
}

/** @param {unknown} e */
function bareOsIsNotFoundErr(e) {
  const code = e && typeof e === 'object' ? e.code : ''
  if (code === 'ENOENT') return true
  const msg = String((e && e.message) || e || '')
  return /ENOENT|No such file|not found/i.test(msg)
}

/**
 * @param {Record<string, unknown>} ctx
 * @param {unknown} buf
 * @returns {Uint8Array}
 */
function bareOsToU8(ctx, buf) {
  if (!buf) return new Uint8Array(0)
  if (buf instanceof Uint8Array) return buf
  if (ctx && ctx.b4a && typeof ctx.b4a.from === 'function') return ctx.b4a.from(buf)
  return new Uint8Array(buf)
}

/** @param {string} dir @param {string} name */
function bareOsJoinPath(dir, name) {
  const d = String(dir || '').replace(/\/+$/, '')
  const n = String(name || '').replace(/^\/+/, '')
  if (!d || d === '/') return '/' + n
  return d + '/' + n
}

/** @param {string} p */
function bareOsBaseName(p) {
  const t = String(p || '').replace(/\/+$/, '')
  if (!t || t === '/') return t === '/' ? '/' : ''
  const i = t.lastIndexOf('/')
  return i < 0 ? t : t.slice(i + 1) || t
}

/** @param {string} p */
function bareOsParentDir(p) {
  const t = String(p || '').replace(/\/+$/, '') || '/'
  if (t === '/') return '/'
  const i = t.lastIndexOf('/')
  return i <= 0 ? '/' : t.slice(0, i) || '/'
}

/** @param {string} p */
function bareOsNormPath(p) {
  return String(p || '').replace(/\/+$/, '') || '/'
}

/**
 * @param {Record<string, unknown>} ctx
 * @param {string} p
 */
function bareOsResolvePath(ctx, p) {
  if (ctx && ctx.vfs && typeof ctx.vfs.resolveLogical === 'function') {
    try {
      return String(ctx.vfs.resolveLogical(p) || p)
    } catch {
      /* fall through */
    }
  }
  return String(p || '')
}

/**
 * True when dest is src or lives under src (self-copy / self-move).
 * @param {Record<string, unknown>} ctx
 * @param {string} src
 * @param {string} dest
 */
function bareOsDestInsideSrc(ctx, src, dest) {
  const s = bareOsNormPath(bareOsResolvePath(ctx, src))
  const d = bareOsNormPath(bareOsResolvePath(ctx, dest))
  if (s === d) return true
  if (s === '/') return d !== '/'
  return d === s || d.startsWith(s + '/')
}

const BARE_OS_B64_ALPH =
  'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/'

/** @param {Uint8Array} u8 */
function bareOsB64Encode(u8) {
  let out = ''
  let i = 0
  for (; i + 2 < u8.length; i += 3) {
    const n = (u8[i] << 16) | (u8[i + 1] << 8) | u8[i + 2]
    out +=
      BARE_OS_B64_ALPH[(n >> 18) & 63] +
      BARE_OS_B64_ALPH[(n >> 12) & 63] +
      BARE_OS_B64_ALPH[(n >> 6) & 63] +
      BARE_OS_B64_ALPH[n & 63]
  }
  const rest = u8.length - i
  if (rest === 1) {
    const n = u8[i] << 16
    out += BARE_OS_B64_ALPH[(n >> 18) & 63] + BARE_OS_B64_ALPH[(n >> 12) & 63] + '=='
  } else if (rest === 2) {
    const n = (u8[i] << 16) | (u8[i + 1] << 8)
    out +=
      BARE_OS_B64_ALPH[(n >> 18) & 63] +
      BARE_OS_B64_ALPH[(n >> 12) & 63] +
      BARE_OS_B64_ALPH[(n >> 6) & 63] +
      '='
  }
  return out
}

/**
 * RFC 4648 Base64 decode (also accepts URL-safe alphabet). Rejects junk.
 * @param {string} s
 * @returns {Uint8Array}
 */
function bareOsB64Decode(s) {
  const t = String(s).replace(/\s+/g, '')
  if (!t) return new Uint8Array(0)
  if (t.length % 4 === 1) throw new Error('invalid base64 length')
  let pad = 0
  if (t.endsWith('==')) pad = 2
  else if (t.endsWith('=')) pad = 1
  const body = pad ? t.slice(0, t.length - pad) : t
  const bytes = []
  let buf = 0
  let bits = 0
  for (let i = 0; i < body.length; i++) {
    const c = body[i]
    let v = BARE_OS_B64_ALPH.indexOf(c)
    if (v < 0) {
      if (c === '-') v = 62
      else if (c === '_') v = 63
      else throw new Error('invalid base64 character')
    }
    buf = (buf << 6) | v
    bits += 6
    if (bits >= 8) {
      bits -= 8
      bytes.push((buf >> bits) & 255)
    }
  }
  if (pad) {
    const want = Math.floor((body.length * 6) / 8)
    if (bytes.length > want) bytes.length = want
  }
  return new Uint8Array(bytes)
}

/**
 * @param {string} s
 * @returns {Uint8Array}
 */
function bareOsHexDecode(s) {
  const t = String(s).replace(/\s+/g, '')
  if (t.length % 2 !== 0) throw new Error('odd hex length')
  const out = new Uint8Array(t.length / 2)
  for (let i = 0; i < out.length; i++) {
    const pair = t.slice(i * 2, i * 2 + 2)
    if (!/^[0-9a-fA-F]{2}$/.test(pair)) throw new Error('invalid hex')
    out[i] = Number.parseInt(pair, 16)
  }
  return out
}

/** @param {Uint8Array} u8 */
function bareOsHexEncode(u8) {
  let s = ''
  for (let i = 0; i < u8.length; i++) s += u8[i].toString(16).padStart(2, '0')
  return s
}

/** ANSI helpers for /bin/edit (preamble; no import in src). */

const EDIT_ANSI_RESET = '\x1b[0m'

/**
 * @param {Record<string, unknown>} [ctx]
 * @returns {import('stream').Writable | undefined}
 */
function bareEditResolveStdout(ctx) {
  if (!ctx || typeof ctx !== 'object') return globalThis.process?.stdout
  const c = /** @type {{ replStdout?: unknown, stdout?: unknown }} */ (ctx)
  const out = c.replStdout || c.stdout || globalThis.process?.stdout
  return /** @type {import('stream').Writable | undefined} */ (out)
}

/**
 * @param {Record<string, unknown>} [ctx]
 */
function bareEditUseColor(ctx) {
  const env =
    ctx && typeof ctx === 'object' && ctx.env && typeof ctx.env === 'object'
      ? /** @type {Record<string, string>} */ (ctx.env)
      : {}
  if (env.NO_COLOR != null && String(env.NO_COLOR) !== '') return false
  const out = bareEditResolveStdout(ctx)
  return Boolean(out && /** @type {{ isTTY?: boolean }} */ (out).isTTY)
}

/**
 * @param {'keyword'|'string'|'comment'|'number'|'status'|'inverse'|'dim'} cls
 * @param {boolean} on
 */
function bareEditSgr(cls, on) {
  if (!on) return ''
  switch (cls) {
    case 'keyword':
      return '\x1b[36m'
    case 'string':
      return '\x1b[32m'
    case 'comment':
      return '\x1b[90m'
    case 'number':
      return '\x1b[33m'
    case 'status':
      return '\x1b[44m\x1b[97m'
    case 'inverse':
      return '\x1b[7m'
    case 'dim':
      return '\x1b[2m'
    default:
      return ''
  }
}

/**
 * @param {string} fullLine
 * @param {Array<{ start: number, end: number, cls: string }>} spans offsets into fullLine
 * @param {number} visStart first column (0-based)
 * @param {number} maxLen max code units to show
 * @param {boolean} useColor
 */
function bareEditPaintLineWindow(fullLine, spans, visStart, maxLen, useColor) {
  const slice = fullLine.slice(visStart, visStart + maxLen)
  if (!useColor) return slice
  const n = slice.length
  const relSpans = spans
    .map((s) => ({
      start: Math.max(0, s.start - visStart),
      end: Math.min(n, s.end - visStart),
      cls: s.cls
    }))
    .filter((s) => s.end > 0 && s.start < n)
    .sort((a, b) => a.start - b.start)

  let out = ''
  let pos = 0
  for (const sp of relSpans) {
    if (sp.start > pos) out += slice.slice(pos, sp.start)
    out +=
      bareEditSgr(/** @type {'keyword'} */ (sp.cls), true) +
      slice.slice(sp.start, sp.end) +
      EDIT_ANSI_RESET
    pos = sp.end
  }
  if (pos < n) out += slice.slice(pos)
  return out
}

/**
 * Move cursor (1-based row/col, DEC origin). Clamp to sane bounds for escape parsing.
 * @param {number} row1
 * @param {number} col1
 */
function bareEditCup(row1, col1) {
  const r = Math.max(1, Math.min(Math.floor(row1), 9999))
  const c = Math.max(1, Math.min(Math.floor(col1), 9999))
  return '\x1b[' + r + ';' + c + 'H'
}

/**
 * @param {Record<string, unknown>} ctx
 * @param {import('stream').Writable} stdout
 * @param {string} s
 */
function bareEditWrite(ctx, stdout, s) {
  if (!stdout || typeof stdout.write !== 'function') return
  try {
    stdout.write(s)
  } catch {
    try {
      ctx.console?.error?.('edit: stdout write failed')
    } catch {
      /* ignore */
    }
  }
}

/** TTY key parsing for /bin/edit: consume one logical key from a mutable byte queue. */

/**
 * @param {number} b1
 */
function bareEditUtf8TrailCount(b1) {
  if (b1 >= 0xc0 && b1 < 0xe0) return 1
  if (b1 >= 0xe0 && b1 < 0xf0) return 2
  if (b1 >= 0xf0) return 3
  return 0
}

/**
 * @param {number[]} bytes
 */
function bareEditUtf8DecodeKey(bytes) {
  try {
    const u = new Uint8Array(bytes)
    if (typeof TextDecoder !== 'undefined') {
      return new TextDecoder('utf-8', { fatal: false }).decode(u)
    }
  } catch {
    /* fall through */
  }
  let s = ''
  for (const b of bytes) s += String.fromCharCode(b)
  return s
}

/**
 * @param {string} seq CSI payload after ESC [, including final byte (e.g. "A", "1;5A", "3~")
 */
function bareEditCsiToEvent(seq) {
  if (seq === '3~') return { type: 'ctrl', code: 'delete' }
  if (seq === '5~') return { type: 'nav', key: 'pageup' }
  if (seq === '6~') return { type: 'nav', key: 'pagedown' }
  const last = seq.charAt(seq.length - 1)
  if (last === '~') {
    if (seq === '1~' || seq === '7~') return { type: 'nav', key: 'home' }
    if (seq === '4~' || seq === '8~') return { type: 'nav', key: 'end' }
    const tildeNum = /^(\d+)~$/.exec(seq)
    if (tildeNum) {
      const n = parseInt(tildeNum[1], 10)
      const fnMap = {
        11: 1,
        12: 2,
        13: 3,
        14: 4,
        15: 5,
        17: 6,
        18: 7,
        19: 8,
        20: 9,
        21: 10,
        23: 11,
        24: 12
      }
      if (fnMap[n] != null) return { type: 'fn', n: fnMap[n] }
    }
    return { type: 'unknown' }
  }
  if (last === 'Z') return { type: 'nav', key: 'stab' }
  if (last === 'A' || last === 'B' || last === 'C' || last === 'D') {
    const map = { A: 'up', B: 'down', C: 'right', D: 'left' }
    return { type: 'nav', key: map[last] }
  }
  if (last === 'H') return { type: 'nav', key: 'home' }
  if (last === 'F') return { type: 'nav', key: 'end' }
  return { type: 'unknown' }
}

/**
 * @param {number} b3 byte after ESC O
 */
function bareEditSs3ToEvent(b3) {
  if (b3 === 72) return { type: 'nav', key: 'home' }
  if (b3 === 70) return { type: 'nav', key: 'end' }
  if (b3 === 65) return { type: 'nav', key: 'up' }
  if (b3 === 66) return { type: 'nav', key: 'down' }
  if (b3 === 67) return { type: 'nav', key: 'right' }
  if (b3 === 68) return { type: 'nav', key: 'left' }
  if (b3 === 80) return { type: 'fn', n: 1 }
  if (b3 === 81) return { type: 'fn', n: 2 }
  if (b3 === 82) return { type: 'fn', n: 3 }
  if (b3 === 83) return { type: 'fn', n: 4 }
  return { type: 'unknown' }
}

/** ESC [ 200 ~ */
const BARE_EDIT_BRACKET_PASTE_START = [27, 91, 50, 48, 48, 126]
/** ESC [ 201 ~ */
const BARE_EDIT_BRACKET_PASTE_END = [27, 91, 50, 48, 49, 126]

/**
 * @param {number[]} q
 * @param {number[]} prefix
 */
function bareEditStartsWithBytes(q, prefix) {
  if (q.length < prefix.length) return false
  for (let i = 0; i < prefix.length; i++) {
    if (q[i] !== prefix[i]) return false
  }
  return true
}

/**
 * True if q could still become BARE_EDIT_BRACKET_PASTE_START with more bytes.
 * @param {number[]} q
 */
function bareEditCouldBeBracketPastePrefix(q) {
  const pre = BARE_EDIT_BRACKET_PASTE_START
  const n = Math.min(q.length, pre.length)
  for (let i = 0; i < n; i++) {
    if (q[i] !== pre[i]) return false
  }
  return true
}

/**
 * @param {number[]} bytes
 */
function bareEditDecodePasteInner(bytes) {
  try {
    if (typeof TextDecoder !== 'undefined') {
      return new TextDecoder('utf-8', { fatal: false }).decode(
        new Uint8Array(bytes)
      )
    }
  } catch {
    /* fall through */
  }
  let s = ''
  for (const b of bytes) s += String.fromCharCode(b)
  return s
}

/**
 * If queue begins with ESC [ 200 ~ but no closing ESC [ 201 ~ (stdin closed), return inner bytes as text.
 * @param {number[]} q
 * @returns {string|undefined}
 */
function bareEditFinalizeBracketedPasteOnEof(q) {
  const SL = BARE_EDIT_BRACKET_PASTE_START.length
  if (q.length >= SL && bareEditStartsWithBytes(q, BARE_EDIT_BRACKET_PASTE_START)) {
    const inner = q.slice(SL)
    q.length = 0
    return bareEditDecodePasteInner(inner)
  }
  return undefined
}

/**
 * xterm bracketed paste: ESC [ 200 ~ … ESC [ 201 ~
 * @param {number[]} q mutable queue
 * @returns {string|null|undefined} string if consumed; null if incomplete; undefined if not bracketed paste at front
 */
function bareEditTryConsumeBracketedPaste(q) {
  const SL = BARE_EDIT_BRACKET_PASTE_START.length
  const EL = BARE_EDIT_BRACKET_PASTE_END.length
  if (!q.length) return undefined
  if (q.length < SL) {
    return bareEditCouldBeBracketPastePrefix(q) ? null : undefined
  }
  if (!bareEditStartsWithBytes(q, BARE_EDIT_BRACKET_PASTE_START)) {
    return undefined
  }
  for (let i = SL; i <= q.length - EL; i++) {
    let ok = true
    for (let j = 0; j < EL; j++) {
      if (q[i + j] !== BARE_EDIT_BRACKET_PASTE_END[j]) {
        ok = false
        break
      }
    }
    if (ok) {
      const inner = q.slice(SL, i)
      q.splice(0, i + EL)
      return bareEditDecodePasteInner(inner)
    }
  }
  return null
}

/**
 * @param {number[]} q mutable queue (front = index 0)
 * @returns {Record<string, unknown> | null} null if more bytes needed
 */
function bareEditTryConsumeKey(q) {
  if (!q.length) return null
  const b1 = q[0]
  if (b1 === 3) {
    q.shift()
    return { type: 'ctrl', code: 'interrupt' }
  }
  if (b1 === 8 || b1 === 127) {
    q.shift()
    return { type: 'ctrl', code: 'backspace' }
  }
  if (b1 === 13 || b1 === 10) {
    q.shift()
    return { type: 'key', ch: '\n' }
  }
  if (b1 === 9) {
    q.shift()
    return { type: 'key', ch: '\t' }
  }
  if (b1 === 27) {
    if (q.length < 2) return null
    const b2 = q[1]
    if (b2 === 91) {
      let i = 2
      while (i < q.length) {
        const b = q[i]
        if (b >= 0x40 && b <= 0x7e) {
          const seq = String.fromCharCode.apply(null, q.slice(2, i + 1))
          q.splice(0, i + 1)
          return bareEditCsiToEvent(seq)
        }
        i++
      }
      return null
    }
    if (b2 === 79) {
      if (q.length < 3) return null
      const b3 = q[2]
      q.splice(0, 3)
      return bareEditSs3ToEvent(b3)
    }
    q.splice(0, 2)
    return { type: 'key', ch: String.fromCharCode(b2) }
  }
  if (b1 < 0x20) {
    q.shift()
    return { type: 'ctrl', code: b1 }
  }
  const need = bareEditUtf8TrailCount(b1)
  if (q.length < 1 + need) return null
  const chunk = q.splice(0, 1 + need)
  return { type: 'key', ch: bareEditUtf8DecodeKey(chunk) }
}

/** Stdin chunk queue + async key reader for edit/chat TUIs (requires edit-key-parse.js first). */

/**
 * @param {unknown} chunk
 * @returns {number[]}
 */
function bareEditChunkBytes(chunk) {
  if (chunk == null) return []
  if (typeof chunk === 'string') {
    const out = []
    for (let i = 0; i < chunk.length; i++) out.push(chunk.charCodeAt(i) & 0xff)
    return out
  }
  const len = /** @type {{ length: number, [k: number]: number }} */ (chunk).length
  const out = []
  for (let i = 0; i < len; i++) out.push(Number(chunk[i]) & 0xff)
  return out
}

/**
 * @param {{ nextByte: () => Promise<number|undefined>, dispose?: () => void, _keyq?: number[] }} reader
 */
async function bareEditReadKey(reader) {
  reader._keyq = reader._keyq || []
  const q = reader._keyq
  for (;;) {
    const pasteText = bareEditTryConsumeBracketedPaste(q)
    if (pasteText !== undefined && pasteText !== null) {
      return { type: 'paste', text: pasteText }
    }
    if (pasteText === null) {
      const b = await reader.nextByte()
      if (b === undefined) {
        const eofPaste = bareEditFinalizeBracketedPasteOnEof(q)
        if (eofPaste !== undefined) {
          return { type: 'paste', text: eofPaste }
        }
        if (!q.length) return { type: 'eof' }
        if (q.length === 1 && q[0] === 27) {
          q.length = 0
          return { type: 'key', ch: '\x1b' }
        }
        const lone = q.shift()
        if (lone !== undefined && lone < 0x20) {
          return { type: 'ctrl', code: lone }
        }
        if (lone !== undefined) {
          return { type: 'key', ch: String.fromCharCode(lone) }
        }
        return { type: 'eof' }
      }
      q.push(b)
      continue
    }
    const ev = bareEditTryConsumeKey(q)
    if (ev) return ev
    const b = await reader.nextByte()
    if (b === undefined) {
      const eofPaste = bareEditFinalizeBracketedPasteOnEof(q)
      if (eofPaste !== undefined) {
        return { type: 'paste', text: eofPaste }
      }
      if (!q.length) return { type: 'eof' }
      if (q.length === 1 && q[0] === 27) {
        q.length = 0
        return { type: 'key', ch: '\x1b' }
      }
      const lone = q.shift()
      if (lone !== undefined && lone < 0x20) {
        return { type: 'ctrl', code: lone }
      }
      if (lone !== undefined) {
        return { type: 'key', ch: String.fromCharCode(lone) }
      }
      return { type: 'eof' }
    }
    q.push(b)
  }
}

/**
 * @param {import('stream').Readable} stdin
 */
function bareEditCreateStdinReader(stdin) {
  /** @type {number[]} */
  const bytes = []
  /** @type {(() => void)[]} */
  const waiters = []
  function drain() {
    while (waiters.length && bytes.length) {
      const w = waiters.shift()
      if (w) w()
    }
  }
  /** @param {unknown} chunk */
  function onData(chunk) {
    bytes.push(...bareEditChunkBytes(chunk))
    drain()
  }
  stdin.on('data', onData)
  return {
    nextByte() {
      if (bytes.length) return Promise.resolve(bytes.shift())
      return new Promise((resolve) => {
        waiters.push(() => resolve(bytes.shift()))
      })
    },
    dispose() {
      stdin.removeListener('data', onData)
    }
  }
}

const BARE_P2P_SUITE_PREFIX = '[bare-p2p-v1]'
const BARE_P2P_SUITE_MAX_HISTORY = 2000

function bareP2pNowMs() {
  return Date.now()
}

function bareP2pId(prefix) {
  const rnd = Math.floor(Math.random() * 0x7fffffff)
  return prefix + '-' + bareP2pNowMs().toString(36) + '-' + rnd.toString(36)
}

function bareP2pCommonExamples(argv0, rows) {
  const out = []
  for (const r of rows || []) out.push('  ' + argv0 + ' ' + r)
  return out.join('\n')
}

function bareP2pHelpText(argv0, summary, usage, examples, seeAlso) {
  const lines = []
  lines.push('usage: ' + usage)
  lines.push(summary)
  lines.push('')
  lines.push('common options: --help --json --quiet --summary --timeout MS --no-color')
  if (examples && examples.length) {
    lines.push('')
    lines.push('examples:')
    lines.push(bareP2pCommonExamples(argv0, examples))
  }
  if (seeAlso && seeAlso.length) {
    lines.push('')
    lines.push('see also: ' + seeAlso.join(', '))
  }
  lines.push('')
  lines.push('troubleshooting: if peer data is empty, run `swarmtop` then `swarmdoctor`.')
  return lines.join('\n')
}

function bareP2pParseCommonFlags(args) {
  const rest = []
  const opt = {
    help: false,
    json: false,
    quiet: false,
    summary: false,
    timeoutMs: 4000,
    noColor: false,
    dryRun: false,
    yes: false
  }
  for (let i = 0; i < args.length; i++) {
    const a = String(args[i] || '')
    if (a === '-h' || a === '--help') opt.help = true
    else if (a === '--json') opt.json = true
    else if (a === '--quiet') opt.quiet = true
    else if (a === '--summary') opt.summary = true
    else if (a === '--dry-run') opt.dryRun = true
    else if (a === '--yes' || a === '-y') opt.yes = true
    else if (a === '--no-color') opt.noColor = true
    else if (a === '--timeout') {
      const n = parseInt(args[i + 1] || '4000', 10)
      if (Number.isFinite(n)) opt.timeoutMs = Math.max(250, Math.min(120000, n))
      i++
    } else rest.push(a)
  }
  return { opt, rest }
}

function bareP2pPrint(ctx, data, opt) {
  if (opt && opt.quiet) return
  if (opt && (opt.json || typeof data !== 'string')) {
    ctx.console.log(typeof data === 'string' ? JSON.stringify({ message: data }) : JSON.stringify(data, null, 2))
    return
  }
  ctx.console.log(String(data))
}

function bareP2pError(ctx, argv0, msg, next, opt) {
  if (opt && opt.quiet) {
    ctx.exitCode = 1
    return
  }
  ctx.console.error(argv0 + ': ' + msg + (next ? ' · try: ' + next : ''))
  ctx.exitCode = 1
}

function bareP2pSuggestSubcommand(sub, known) {
  const s = String(sub || '')
  if (!s) return ''
  let best = ''
  let bestScore = 1e9
  for (const k of known || []) {
    const kk = String(k || '')
    const d = Math.abs(kk.length - s.length) + (kk[0] === s[0] ? 0 : 2)
    if (d < bestScore) {
      bestScore = d
      best = kk
    }
  }
  return bestScore <= 4 ? best : ''
}

function bareP2pFirstRunHint(ctx, app, hint) {
  const env = ctx.env && typeof ctx.env === 'object' ? ctx.env : {}
  if (env.BARE_P2P_NO_HINTS === '1' || env.BARE_P2P_NO_HINTS === 'true') return
  const key = '__bare_p2p_hint_' + app
  if (ctx[key]) return
  ctx[key] = true
  try {
    ctx.console.log('hint: ' + hint)
  } catch {
    /* ignore */
  }
}

function bareP2pMaybeNext(ctx, opt, next) {
  if (opt && opt.quiet) return
  if (next) ctx.console.log('next: ' + next)
}

function bareP2pHome(ctx) {
  const env = ctx.env && typeof ctx.env === 'object' ? ctx.env : {}
  const home = typeof env.HOME === 'string' && env.HOME ? env.HOME : '/home/guest'
  return home
}

function bareP2pJoinPath(a, b) {
  if (!a.endsWith('/')) return a + '/' + b
  return a + b
}

function bareP2pDataDir(ctx) {
  return bareP2pJoinPath(bareP2pHome(ctx), '.bare/p2p-suite')
}

function bareP2pDataFile(ctx, app) {
  return bareP2pJoinPath(bareP2pDataDir(ctx), app + '.json')
}

async function bareP2pReadJson(ctx, path) {
  try {
    if (!ctx.vfs || typeof ctx.vfs.readFile !== 'function') return null
    const b = await ctx.vfs.readFile(path)
    if (!b) return null
    const t = ctx.b4a.toString(b).trim()
    if (!t) return null
    return JSON.parse(t)
  } catch {
    return null
  }
}

async function bareP2pWriteJson(ctx, path, obj) {
  if (!ctx.vfs || typeof ctx.vfs.writeFile !== 'function') return false
  const body = JSON.stringify(obj, null, 2) + '\n'
  const b4 = ctx.b4a
  const buf =
    b4 && typeof b4.from === 'function'
      ? b4.from(body)
      : new TextEncoder().encode(body)
  try {
    await ctx.vfs.writeFile(path, buf)
    return true
  } catch {
    return false
  }
}

function bareP2pDecodeEnvelope(line) {
  const s = String(line || '')
  if (!s.startsWith(BARE_P2P_SUITE_PREFIX)) return null
  const payload = s.slice(BARE_P2P_SUITE_PREFIX.length).trim()
  if (!payload) return null
  try {
    const obj = JSON.parse(payload)
    if (!obj || typeof obj !== 'object') return null
    return obj
  } catch {
    return null
  }
}

function bareP2pEncodeEnvelope(app, kind, payload) {
  return (
    BARE_P2P_SUITE_PREFIX +
    ' ' +
    JSON.stringify({
      schema: 1,
      suite: 'bare-p2p',
      version: '1',
      app,
      kind,
      tsMs: bareP2pNowMs(),
      payload: payload || {}
    })
  )
}

function bareP2pSend(ctx, app, kind, payload) {
  if (app === 'meshdrop' && typeof ctx.bareOsMeshdropSend === 'function') {
    return ctx.bareOsMeshdropSend({
      app,
      kind,
      payload: payload || {},
      tsMs: bareP2pNowMs()
    })
  }
  if (typeof ctx.bareOsChatSend !== 'function') {
    return { ok: false, reason: 'bareOsChatSend unavailable' }
  }
  return ctx.bareOsChatSend(bareP2pEncodeEnvelope(app, kind, payload))
}

function bareP2pCollectFromHistory(ctx, app, limit) {
  if (app === 'meshdrop' && typeof ctx.bareOsMeshdropHistory === 'function') {
    let hist = []
    try {
      hist = ctx.bareOsMeshdropHistory(
        Math.max(1, Math.min(BARE_P2P_SUITE_MAX_HISTORY, limit || 512))
      )
    } catch {
      hist = []
    }
    if (!Array.isArray(hist)) return []
    const out = []
    for (const ev of hist) {
      if (!ev || typeof ev !== 'object') continue
      if (ev.app !== app) continue
      out.push({
        fromPeerKey: typeof ev.fromPeerKey === 'string' ? ev.fromPeerKey : '',
        displayName: typeof ev.sender === 'string' ? ev.sender : '',
        local: Boolean(ev.local),
        receivedAtMs:
          typeof ev.receivedAtMs === 'number' ? ev.receivedAtMs : bareP2pNowMs(),
        packet: {
          app,
          kind: typeof ev.kind === 'string' ? ev.kind : 'unknown',
          payload: ev.payload && typeof ev.payload === 'object' ? ev.payload : {}
        }
      })
    }
    return out
  }
  if (typeof ctx.bareOsChatHistory !== 'function') return []
  let hist = []
  try {
    hist = ctx.bareOsChatHistory(
      Math.max(1, Math.min(BARE_P2P_SUITE_MAX_HISTORY, limit || 512))
    )
  } catch {
    hist = []
  }
  if (!Array.isArray(hist)) return []
  const out = []
  for (const ev of hist) {
    if (!ev || typeof ev !== 'object') continue
    const body = String(ev.body || '')
    const decoded = bareP2pDecodeEnvelope(body)
    if (!decoded || decoded.app !== app) continue
    out.push({
      fromPeerKey: typeof ev.fromPeerKey === 'string' ? ev.fromPeerKey : '',
      displayName: typeof ev.displayName === 'string' ? ev.displayName : '',
      local: Boolean(ev.local),
      receivedAtMs:
        typeof ev.receivedAtMs === 'number' ? ev.receivedAtMs : bareP2pNowMs(),
      packet: decoded
    })
  }
  return out
}

function bareP2pSubscribe(ctx, app, fn) {
  if (app === 'meshdrop' && typeof ctx.bareOsMeshdropSubscribe === 'function') {
    return ctx.bareOsMeshdropSubscribe((ev) => {
      if (!ev || typeof ev !== 'object' || ev.app !== app) return
      fn({
        fromPeerKey: typeof ev.fromPeerKey === 'string' ? ev.fromPeerKey : '',
        displayName: typeof ev.sender === 'string' ? ev.sender : '',
        local: Boolean(ev.local),
        receivedAtMs:
          typeof ev.receivedAtMs === 'number' ? ev.receivedAtMs : bareP2pNowMs(),
        packet: {
          app,
          kind: typeof ev.kind === 'string' ? ev.kind : 'unknown',
          payload: ev.payload && typeof ev.payload === 'object' ? ev.payload : {}
        }
      })
    })
  }
  if (typeof ctx.bareOsChatSubscribe !== 'function') return () => {}
  return ctx.bareOsChatSubscribe((ev) => {
    if (!ev || typeof ev !== 'object') return
    const body = String(ev.body || '')
    const decoded = bareP2pDecodeEnvelope(body)
    if (!decoded || decoded.app !== app) return
    fn({
      fromPeerKey: typeof ev.fromPeerKey === 'string' ? ev.fromPeerKey : '',
      displayName: typeof ev.displayName === 'string' ? ev.displayName : '',
      local: Boolean(ev.local),
      receivedAtMs:
        typeof ev.receivedAtMs === 'number' ? ev.receivedAtMs : bareP2pNowMs(),
      packet: decoded
    })
  })
}

async function bareP2pReadSwarmSnapshot(ctx) {
  const out = {
    atMs: bareP2pNowMs(),
    peerCount: null,
    topicCount: null,
    peers: []
  }
  const snap = await bareP2pReadJson(ctx, '/proc/bare_os/swarm')
  if (!snap || typeof snap !== 'object') return out
  if (typeof snap.peerCount === 'number') out.peerCount = snap.peerCount
  if (typeof snap.topicCount === 'number') out.topicCount = snap.topicCount
  const peers = Array.isArray(snap.peers) ? snap.peers : []
  const detailsRaw = await bareP2pReadJson(ctx, '/proc/bare_os/peer_details.json')
  const details =
    detailsRaw && typeof detailsRaw === 'object' && Array.isArray(detailsRaw.peers)
      ? detailsRaw.peers
      : []
  /** @type {Map<string, Record<string, unknown>>} */
  const byKey = new Map()
  for (const d of details) {
    if (!d || typeof d !== 'object') continue
    const rk = typeof d.remotePublicKey === 'string' ? d.remotePublicKey : ''
    const pid = typeof d.peerId === 'string' ? d.peerId : ''
    if (rk) byKey.set('k:' + rk, d)
    if (pid) byKey.set('p:' + pid, d)
  }
  const merged = []
  for (const p of peers) {
    if (!p || typeof p !== 'object') continue
    const rk = typeof p.remotePublicKey === 'string' ? p.remotePublicKey : ''
    const pid = typeof p.peerId === 'string' ? p.peerId : ''
    const d = (rk && byKey.get('k:' + rk)) || (pid && byKey.get('p:' + pid)) || null
    merged.push(d && typeof d === 'object' ? { ...p, ...d } : p)
  }
  out.peers = merged.slice(0, 128)
  return out
}

async function bareP2pReadProcJson(ctx, path) {
  const v = await bareP2pReadJson(ctx, path)
  return v && typeof v === 'object' ? v : {}
}

function bareP2pFmtClock(ms) {
  const d = new Date(typeof ms === 'number' ? ms : Date.now())
  const z = (n) => (n < 10 ? '0' : '') + n
  return z(d.getHours()) + ':' + z(d.getMinutes()) + ':' + z(d.getSeconds())
}

function bareP2pTruncate(s, cols) {
  const t = String(s || '')
  if (t.length <= cols) return t
  return t.slice(0, Math.max(0, cols - 1)) + '\u2026'
}

/**
 * TEA model for the read-only p2p dashboards (dhttop, swarmmap, …).
 * @param {Record<string, unknown>} ctx
 * @param {{ title: string, subtitle?: string, renderLines: () => string[] | Promise<string[]>, onRefresh?: () => void | Promise<void> }} opts
 */
function bareP2pCreateSimpleTuiApp(ctx, opts) {
  const tui = ctx.tui
  const size0 = tui && typeof tui.size === 'function' ? tui.size() : {}
  return {
    title: String(opts.title || 'p2p'),
    subtitle: opts.subtitle || 'q quit · r refresh',
    lines: ['loading\u2026'],
    error: null,
    width: size0.width || 80,
    height: size0.height || 24,
    init: function () {
      return this._load()
    },
    _load: function () {
      return function () {
        return Promise.resolve()
          .then(function () {
            return opts.renderLines()
          })
          .then(function (lines) {
            return {
              type: 'p2p.lines',
              lines: Array.isArray(lines) ? lines : []
            }
          })
          .catch(function (error) {
            return { type: 'error', error: error }
          })
      }
    },
    _refresh: function () {
      const self = this
      if (typeof opts.onRefresh !== 'function') return this._load()
      return function () {
        return Promise.resolve()
          .then(function () {
            return opts.onRefresh()
          })
          .then(function () {
            return self._load()()
          })
      }
    },
    update: function (msg) {
      if (
        tui &&
        tui.key &&
        tui.key.matches(msg, 'q', 'Q', 'ctrl+c', 'ctrl+q', 'ctrl+x')
      ) {
        return [this, tui.quit]
      }
      if (tui && tui.key && tui.key.matches(msg, 'r', 'R')) {
        return [this, this._refresh()]
      }
      if (msg && msg.type === 'p2p.lines') {
        this.lines = Array.isArray(msg.lines) ? msg.lines.map(String) : []
        this.error = null
        return [this, null]
      }
      if (msg && msg.type === 'error') {
        const err = msg.error
        this.error =
          err && err.message ? String(err.message) : String(err || 'error')
        return [this, null]
      }
      if (msg && msg.type === 'resize') {
        this.width = msg.width || this.width
        this.height = msg.height || this.height
      }
      return [this, null]
    },
    view: function () {
      const cols = Math.max(48, this.width || 80)
      const rows = Math.max(12, this.height || 24)
      const st = tui && tui.style
      const titleText = ' ' + this.title + ' '
      const subText = this.subtitle + ' · ' + bareP2pFmtClock(Date.now())
      let title
      let sub
      if (st) {
        title = st()
          .foreground('brightwhite')
          .background('blue')
          .width(cols)
          .render(titleText)
        sub = st().dim().width(cols).render(subText)
      } else {
        title = bareP2pTruncate(titleText, cols)
        sub = bareP2pTruncate(subText, cols)
      }
      const maxBody = Math.max(1, rows - 3)
      const body = []
      if (this.error) {
        const errLine = 'error: ' + this.error
        body.push(
          st ? st.truncate(errLine, cols) : bareP2pTruncate(errLine, cols)
        )
      }
      for (let i = 0; body.length < maxBody; i++) {
        const raw = i < this.lines.length ? String(this.lines[i]) : ''
        body.push(st ? st.truncate(raw, cols) : bareP2pTruncate(raw, cols))
      }
      return title + '\n' + sub + '\n' + body.join('\n')
    }
  }
}

/**
 * Read-only TUI shell: q quits, r refreshes.
 * Prefers ctx.tui when attached; otherwise the pre-SDK key loop.
 * @param {Record<string, unknown>} ctx
 * @param {{ title: string, subtitle?: string, renderLines: () => string[] | Promise<string[]>, onRefresh?: () => void | Promise<void> }} opts
 */
async function bareP2pRunSimpleTui(ctx, opts) {
  if (ctx.tui && typeof ctx.tui.run === 'function') {
    await ctx.tui.run(bareP2pCreateSimpleTuiApp(ctx, opts))
    return
  }
  await bareP2pRunSimpleTuiLegacy(ctx, opts)
}

/** Pre-SDK key loop (BARE_OS_TUI=0). */
async function bareP2pRunSimpleTuiLegacy(ctx, opts) {
  const stdin = ctx.replStdin
  const stdout = bareEditResolveStdout(ctx)
  if (!stdin || !stdout) {
    ctx.console.error('p2p tui: missing stdin/stdout')
    ctx.exitCode = 1
    return
  }
  const useColor = bareEditUseColor(ctx)
  const envEarly =
    ctx.env && typeof ctx.env === 'object'
      ? /** @type {Record<string, string>} */ (ctx.env)
      : {}
  const cols0 = parseInt(envEarly.COLUMNS || '80', 10) || 80
  const rows0 = parseInt(envEarly.LINES || '24', 10) || 24
  const dims = () => ({
    cols: Math.max(
      48,
      /** @type {{ columns?: number }} */ (stdout).columns || cols0
    ),
    rows: Math.max(12, /** @type {{ rows?: number }} */ (stdout).rows || rows0)
  })

  const reader = bareEditCreateStdinReader(stdin)
  let suspended = false
  let alt = false
  let loop = true

  const draw = async () => {
    const { cols, rows } = dims()
    const lines = await opts.renderLines()
    let out = '\x1b[?25l\x1b[2J\x1b[H'
    const top =
      bareEditSgr('status', useColor) +
      bareP2pTruncate(' ' + opts.title + ' ', cols) +
      EDIT_ANSI_RESET
    out += bareEditCup(1, 1) + '\x1b[K' + top
    const sub = bareP2pTruncate(
      (opts.subtitle || 'q quit · r refresh') +
        ' · ' +
        bareP2pFmtClock(Date.now()),
      cols
    )
    out +=
      bareEditCup(2, 1) +
      '\x1b[K' +
      bareEditSgr('dim', useColor) +
      sub +
      EDIT_ANSI_RESET
    out += bareEditCup(3, 1) + '\x1b[K'
    const maxBody = Math.max(1, rows - 3)
    for (let i = 0; i < maxBody; i++) {
      const raw = i < lines.length ? String(lines[i]) : ''
      out += bareEditCup(4 + i, 1) + '\x1b[K' + bareP2pTruncate(raw, cols)
    }
    bareEditWrite(ctx, stdout, out + '\x1b[?25h')
  }

  try {
    if (typeof ctx.suspendReplForSubprocess === 'function') {
      ctx.suspendReplForSubprocess()
      suspended = true
    }
    if (typeof stdin.setRawMode === 'function') stdin.setRawMode(true)
    if (typeof stdin.resume === 'function') stdin.resume()
    bareEditWrite(ctx, stdout, '\x1b[?1049h')
    alt = true
    await draw()
    while (loop) {
      const ev = await bareEditReadKey(reader)
      if (ev.type === 'eof') break
      if (ev.type === 'ctrl') {
        const code = typeof ev.code === 'number' ? ev.code : 0
        if (
          ev.code === 'interrupt' ||
          code === 3 ||
          code === 17 ||
          code === 24
        ) {
          break
        }
      }
      if (ev.type === 'key' && ev.ch) {
        if (ev.ch === 'q' || ev.ch === 'Q') break
        if (ev.ch === 'r' || ev.ch === 'R') {
          if (typeof opts.onRefresh === 'function') await opts.onRefresh()
          await draw()
          continue
        }
      }
      await draw()
    }
  } finally {
    try {
      if (alt) bareEditWrite(ctx, stdout, '\x1b[?1049l')
      bareEditWrite(ctx, stdout, '\x1b[?25h\x1b[0m')
    } catch {
      /* ignore */
    }
    reader.dispose()
    try {
      if (typeof stdin.setRawMode === 'function') stdin.setRawMode(false)
    } catch {
      /* ignore */
    }
    if (suspended && typeof ctx.resumeReplAfterSubprocess === 'function') {
      ctx.resumeReplAfterSubprocess()
    }
  }
}

async function run(ctx, argv) {
  const argv0 = argv[0] || 'swarmmap'
  const parsed = bareP2pParseCommonFlags(argv.slice(1))
  const opt = parsed.opt
  if (opt.help) {
    ctx.console.log(
      bareP2pHelpText(
        argv0,
        'Swarm topology map TUI.',
        argv0 + ' [--summary] [--json]',
        ['--summary', '--json'],
        ['swarmtop', 'peerdiscover']
      )
    )
    return
  }
  const stdin = ctx.replStdin
  const isTTY = Boolean(stdin && /** @type {{ isTTY?: boolean }} */ (stdin).isTTY)
  const snap = await bareP2pReadSwarmSnapshot(ctx)
  if (!isTTY || opt.json || opt.summary) {
    bareP2pPrint(ctx, opt.summary ? { peers: snap.peerCount, topics: snap.topicCount } : snap, opt)
    return
  }
  await bareP2pRunSimpleTui(ctx, {
    title: 'swarmmap',
    subtitle: 'peer topology · q quit · r refresh',
    renderLines: async () => {
      const s = await bareP2pReadSwarmSnapshot(ctx)
      const lines = []
      lines.push('peerCount: ' + String(s.peerCount ?? '?'))
      lines.push('topicCount: ' + String(s.topicCount ?? '?'))
      lines.push('')
      lines.push('Peers:')
      const peers = Array.isArray(s.peers) ? s.peers : []
      if (!peers.length) lines.push('  (none)')
      for (const p of peers.slice(0, 48)) {
        const id =
          p && typeof p === 'object' && typeof p.remotePublicKey === 'string'
            ? p.remotePublicKey.slice(0, 20)
            : '?'
        lines.push('  ' + id + ' ' + String(p.state || 'connected'))
      }
      return lines
    }
  })
}