/* 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
}

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 : {}
}

const BARE_MESHDROP_CHUNK_RAW = 12 * 1024

function bareMeshdropName(path) {
  const parts = String(path || '').split('/')
  return parts[parts.length - 1] || 'file.bin'
}

function bareMeshdropChunkB64Limit() {
  const raw = BARE_MESHDROP_CHUNK_RAW
  return Math.ceil((raw * 4) / 3) + 16
}

function bareMeshdropChunkSliceB64(b64, index) {
  const max = bareMeshdropChunkB64Limit()
  const from = index * max
  const to = Math.min(b64.length, from + max)
  return b64.slice(from, to)
}

async function bareMeshdropDbRead(ctx) {
  const p = bareP2pDataFile(ctx, 'meshdrop')
  const cur = await bareP2pReadJson(ctx, p)
  if (cur && typeof cur === 'object') return cur
  return {
    schema: 2,
    outgoing: {},
    incoming: {},
    transfers: {}
  }
}

async function bareMeshdropDbWrite(ctx, db) {
  return bareP2pWriteJson(ctx, bareP2pDataFile(ctx, 'meshdrop'), db)
}

function bareMeshdropEnsureTransfer(db, transferId) {
  if (!db.transfers || typeof db.transfers !== 'object') db.transfers = {}
  if (!db.transfers[transferId]) {
    db.transfers[transferId] = {
      transferId,
      status: 'new',
      chunksTotal: 0,
      chunksReceived: 0,
      updatedAtMs: Date.now()
    }
  }
  return db.transfers[transferId]
}

async function run(ctx, argv) {
  const argv0 = argv[0] || 'meshdrop'
  const parsed = bareP2pParseCommonFlags(argv.slice(1))
  const args = parsed.rest
  const opt = parsed.opt
  if (opt.help || args.length === 0) {
    ctx.console.log(
      bareP2pHelpText(
        argv0,
        'P2P file inbox/outbox over bare-p2p envelopes on chat transport.',
        argv0 +
          ' offer FILE [--to PEER_HINT] | send-next OFFER_ID [MAX_CHUNKS] | inbox [N] | accept OFFER_ID | fetch OFFER_ID [DEST] | status [TRANSFER_ID] | cancel TRANSFER_ID',
        ['offer ./file.bin --to peerHint', 'send-next offer-123 8', 'status --summary'],
        ['swarmtop', 'peerctl']
      )
    )
    if (args.length === 0) ctx.exitCode = 1
    return
  }

  const sub = args[0]
  if (sub === 'offer') {
    const file = args[1]
    if (!file) {
      return bareP2pError(ctx, argv0, 'offer requires FILE', argv0 + ' --help', opt)
    }
    const b = await ctx.vfs.readFile(file)
    if (!b) {
      return bareP2pError(ctx, argv0, 'unable to read ' + file, 'check file path', opt)
    if (opt.dryRun) {
      bareP2pPrint(ctx, { ok: true, dryRun: true, action: 'offer', file, to }, opt)
      return
    }
    }
    const b64 = ctx.b4a.toString(b, 'base64')
    const toIdx = args.indexOf('--to')
    const to = toIdx >= 0 ? String(args[toIdx + 1] || '').trim() : ''
    const offerId = bareP2pId('offer')
    const transferId = bareP2pId('xfer')
    const chunkChars = bareMeshdropChunkB64Limit()
    const chunksTotal = Math.max(1, Math.ceil(b64.length / chunkChars))
    const firstChunk = bareMeshdropChunkSliceB64(b64, 0)
    const db = await bareMeshdropDbRead(ctx)
    if (!db.outgoing || typeof db.outgoing !== 'object') db.outgoing = {}
    db.outgoing[offerId] = {
      offerId,
      transferId,
      file,
      fileName: bareMeshdropName(file),
      byteLength: b.byteLength,
      base64: b64,
      chunkChars,
      chunksTotal,
      sentChunks: firstChunk ? 1 : 0,
      to,
      status: 'offered',
      updatedAtMs: Date.now()
    }
    const tr = bareMeshdropEnsureTransfer(db, transferId)
    tr.role = 'sender'
    tr.offerId = offerId
    tr.status = 'offered'
    tr.chunksTotal = chunksTotal
    tr.chunksReceived = 0
    tr.updatedAtMs = Date.now()
    await bareMeshdropDbWrite(ctx, db)

    if (typeof ctx.bareOsEmitMirrorDriveHint === 'function') {
      ctx.bareOsEmitMirrorDriveHint({
        app: 'meshdrop',
        phase: 'offer',
        offerId,
        transferId,
        fileName: bareMeshdropName(file),
        byteLength: b.byteLength,
        chunksTotal
      })
    }
    const r = bareP2pSend(ctx, 'meshdrop', 'offer', {
      offerId,
      transferId,
      fromPath: file,
      fileName: bareMeshdropName(file),
      byteLength: b.byteLength,
      chunkChars,
      chunksTotal,
      firstChunkB64: firstChunk,
      to
    })
    if (r && r.ok === false) {
      return bareP2pError(ctx, argv0, String(r.reason || 'send failed'), 'swarmdoctor', opt)
    }
    bareP2pPrint(ctx, 'offered ' + file + ' as ' + offerId + ' (' + chunksTotal + ' chunks)', opt)
    bareP2pMaybeNext(ctx, opt, argv0 + ' send-next ' + offerId)
    return
  }

  if (sub === 'send-next') {
    const offerId = String(args[1] || '').trim()
    if (!offerId) {
      return bareP2pError(ctx, argv0, 'send-next requires OFFER_ID', argv0 + ' status', opt)
    }
    const maxChunks = Math.max(
      1,
      Math.min(64, parseInt(args[2] || '8', 10) || 8)
    )
    const db = await bareMeshdropDbRead(ctx)
    const rec = db?.outgoing?.[offerId]
    if (!rec) {
      return bareP2pError(ctx, argv0, 'unknown offer: ' + offerId, argv0 + ' status', opt)
    }
    let sent = 0
    while (sent < maxChunks && rec.sentChunks < rec.chunksTotal) {
      const idx = rec.sentChunks
      const chunk = bareMeshdropChunkSliceB64(rec.base64, idx)
      const r = bareP2pSend(ctx, 'meshdrop', 'chunk', {
        offerId: rec.offerId,
        transferId: rec.transferId,
        index: idx,
        chunksTotal: rec.chunksTotal,
        chunkB64: chunk
      })
      if (r && r.ok === false) break
      rec.sentChunks++
      rec.updatedAtMs = Date.now()
      sent++
    }
    rec.status = rec.sentChunks >= rec.chunksTotal ? 'all-chunks-sent' : 'sending'
    const tr = bareMeshdropEnsureTransfer(db, rec.transferId)
    tr.status = rec.status
    tr.updatedAtMs = rec.updatedAtMs
    await bareMeshdropDbWrite(ctx, db)
    bareP2pSend(ctx, 'meshdrop', 'progress', {
      offerId: rec.offerId,
      transferId: rec.transferId,
      sentChunks: rec.sentChunks,
      chunksTotal: rec.chunksTotal
    })
    bareP2pPrint(ctx, 'sent ' + sent + ' chunk(s), ' + rec.sentChunks + '/' + rec.chunksTotal, opt)
    return
  }

  if (sub === 'inbox') {
    const n = Math.max(1, Math.min(200, parseInt(args[1] || '20', 10) || 20))
    const rows = bareP2pCollectFromHistory(ctx, 'meshdrop', 2000)
    const offers = rows.filter((r) => r.packet?.kind === 'offer').slice(-n)
    for (const row of offers) {
      const p = row.packet?.payload || {}
      const offerId = typeof p.offerId === 'string' ? p.offerId : '?'
      const fileName = typeof p.fileName === 'string' ? p.fileName : '?'
      const bytes = typeof p.byteLength === 'number' ? p.byteLength : 0
      const chunks = typeof p.chunksTotal === 'number' ? p.chunksTotal : '?'
      const from = row.displayName || row.fromPeerKey.slice(0, 10) || 'peer'
      bareP2pPrint(ctx,
        '[' +
          bareP2pFmtClock(row.receivedAtMs) +
          '] ' +
          offerId +
          '  ' +
          fileName +
          '  ' +
          bytes +
          'B  chunks=' +
          String(chunks) +
          '  from=' +
          from
      , opt)
    }
    return
  }

  if (sub === 'accept') {
    const offerId = String(args[1] || '').trim()
    if (!offerId) {
      return bareP2pError(ctx, argv0, 'accept requires OFFER_ID', argv0 + ' inbox', opt)
    }
    const rows = bareP2pCollectFromHistory(ctx, 'meshdrop', 2000)
    const offer = rows.findLast(
      (r) =>
        r.packet?.kind === 'offer' &&
        r.packet.payload &&
        typeof r.packet.payload === 'object' &&
        r.packet.payload.offerId === offerId
    )
    if (!offer) {
      return bareP2pError(ctx, argv0, 'offer not found: ' + offerId, argv0 + ' inbox', opt)
    }
    const p = offer.packet.payload
    const transferId =
      typeof p.transferId === 'string' ? p.transferId : bareP2pId('xfer')
    const fileName =
      typeof p.fileName === 'string' ? p.fileName : offerId + '.received'
    const chunksTotal = typeof p.chunksTotal === 'number' ? p.chunksTotal : 1
    const db = await bareMeshdropDbRead(ctx)
    if (!db.incoming || typeof db.incoming !== 'object') db.incoming = {}
    db.incoming[offerId] = {
      offerId,
      transferId,
      fileName,
      chunksTotal,
      chunks: {},
      acceptedAtMs: Date.now(),
      status: 'accepted'
    }
    if (typeof p.firstChunkB64 === 'string' && p.firstChunkB64) {
      db.incoming[offerId].chunks[0] = p.firstChunkB64
    }
    const tr = bareMeshdropEnsureTransfer(db, transferId)
    tr.role = 'receiver'
    tr.offerId = offerId
    tr.status = 'accepted'
    tr.chunksTotal = chunksTotal
    tr.chunksReceived = Object.keys(db.incoming[offerId].chunks).length
    tr.updatedAtMs = Date.now()
    await bareMeshdropDbWrite(ctx, db)
    bareP2pSend(ctx, 'meshdrop', 'accept', { offerId, transferId })
    bareP2pPrint(ctx, 'accepted ' + offerId + ' (transfer ' + transferId + ')', opt)
    return
  }

  if (sub === 'fetch') {
    const offerId = String(args[1] || '').trim()
    if (!offerId) {
      return bareP2pError(ctx, argv0, 'fetch requires OFFER_ID', argv0 + ' inbox', opt)
    }
    const rows = bareP2pCollectFromHistory(ctx, 'meshdrop', 2000)
    const offer = rows.findLast(
      (r) =>
        r.packet?.kind === 'offer' &&
        r.packet.payload &&
        typeof r.packet.payload === 'object' &&
        r.packet.payload.offerId === offerId
    )
    if (!offer) {
      return bareP2pError(ctx, argv0, 'offer not found: ' + offerId, argv0 + ' inbox', opt)
    }
    const p = offer.packet.payload
    const fileName =
      typeof p.fileName === 'string' ? p.fileName : offerId + '.bin'
    const dest = args[2] || fileName
    const db = await bareMeshdropDbRead(ctx)
    const incoming = db?.incoming?.[offerId]
    if (!incoming) {
      return bareP2pError(ctx, argv0, 'offer not accepted locally', argv0 + ' accept ' + offerId, opt)
    }
    const chunks = incoming.chunks && typeof incoming.chunks === 'object' ? incoming.chunks : {}
    const total = typeof incoming.chunksTotal === 'number' ? incoming.chunksTotal : 0
    const pieces = []
    for (let i = 0; i < total; i++) {
      const part = chunks[i]
      if (typeof part !== 'string' || !part) {
        return bareP2pError(ctx, argv0, 'missing chunk ' + i + '/' + total, argv0 + ' status ' + incoming.transferId, opt)
      }
      pieces.push(part)
    }
    const buf = ctx.b4a.from(pieces.join(''), 'base64')
    await ctx.vfs.writeFile(dest, buf)
    incoming.status = 'saved'
    incoming.savedTo = dest
    incoming.savedAtMs = Date.now()
    const tr = bareMeshdropEnsureTransfer(db, incoming.transferId)
    tr.status = 'saved'
    tr.chunksReceived = total
    tr.updatedAtMs = Date.now()
    await bareMeshdropDbWrite(ctx, db)
    bareP2pSend(ctx, 'meshdrop', 'complete', {
      offerId,
      transferId: incoming.transferId,
      savedTo: dest
    })
    bareP2pPrint(ctx, 'saved ' + offerId + ' -> ' + dest, opt)
    return
  }

  if (sub === 'status') {
    const transferId = String(args[1] || '').trim()
    const db = await bareMeshdropDbRead(ctx)
    const rows = bareP2pCollectFromHistory(ctx, 'meshdrop', 2000)
    for (const row of rows) {
      const kind = row.packet?.kind
      const p = row.packet?.payload
      if (!p || typeof p !== 'object') continue
      const id = typeof p.transferId === 'string' ? p.transferId : ''
      if (transferId && id !== transferId) continue
      if (kind === 'chunk' && typeof p.offerId === 'string' && typeof p.index === 'number') {
        const inRec = db?.incoming?.[p.offerId]
        if (inRec && inRec.status !== 'cancelled' && inRec.status !== 'saved') {
          if (!inRec.chunks || typeof inRec.chunks !== 'object') inRec.chunks = {}
          if (typeof p.chunkB64 === 'string' && !inRec.chunks[p.index]) {
            inRec.chunks[p.index] = p.chunkB64
          }
          const got = Object.keys(inRec.chunks).length
          inRec.status = got >= inRec.chunksTotal ? 'received-all' : 'receiving'
          const tr = bareMeshdropEnsureTransfer(db, inRec.transferId)
          tr.status = inRec.status
          tr.chunksTotal = inRec.chunksTotal
          tr.chunksReceived = got
          tr.updatedAtMs = Date.now()
        }
      }
      if (kind === 'cancel' && id) {
        const tr = bareMeshdropEnsureTransfer(db, id)
        tr.status = 'cancelled'
        tr.updatedAtMs = Date.now()
      }
      if (kind === 'progress' && id) {
        const tr = bareMeshdropEnsureTransfer(db, id)
        if (typeof p.sentChunks === 'number') tr.sentChunks = p.sentChunks
        if (typeof p.chunksTotal === 'number') tr.chunksTotal = p.chunksTotal
        tr.status = 'sending'
        tr.updatedAtMs = Date.now()
      }
      if (kind === 'complete' && id) {
        const tr = bareMeshdropEnsureTransfer(db, id)
        tr.status = 'complete'
        tr.updatedAtMs = Date.now()
      }
    }
    await bareMeshdropDbWrite(ctx, db)
    const items = Object.values(db.transfers || {})
      .filter((x) => !transferId || x.transferId === transferId)
      .sort((a, b) => (b.updatedAtMs || 0) - (a.updatedAtMs || 0))
    if (!items.length) {
      bareP2pPrint(ctx, opt.summary ? { transfers: 0 } : 'no transfers', opt)
      return
    }
    if (opt.summary) {
      bareP2pPrint(
        ctx,
        {
          transfers: items.length,
          active: items.filter((x) => String(x.status || '').includes('send') || String(x.status || '').includes('receiv')).length
        },
        opt
      )
      return
    }
    for (const it of items) {
      bareP2pPrint(
        ctx,
        (it.transferId || '?') +
          ' role=' +
          String(it.role || '?') +
          ' status=' +
          String(it.status || '?') +
          ' chunks=' +
          String(it.chunksReceived || 0) +
          '/' +
          String(it.chunksTotal || 0)
        ,
        opt
      )
    }
    return
  }

  if (sub === 'cancel') {
    const transferId = String(args[1] || '').trim()
    if (!transferId) {
      return bareP2pError(ctx, argv0, 'cancel requires TRANSFER_ID', argv0 + ' status', opt)
    }
    if (!opt.yes) {
      bareP2pPrint(ctx, 'confirmation required: pass --yes to cancel transfer', opt)
      ctx.exitCode = 1
      return
    }
    const db = await bareMeshdropDbRead(ctx)
    const tr = bareMeshdropEnsureTransfer(db, transferId)
    tr.status = 'cancelled'
    tr.updatedAtMs = Date.now()
    await bareMeshdropDbWrite(ctx, db)
    bareP2pSend(ctx, 'meshdrop', 'cancel', { transferId })
    bareP2pPrint(ctx, 'cancelled ' + transferId, opt)
    return
  }

  const sug = bareP2pSuggestSubcommand(sub, ['offer', 'send-next', 'inbox', 'accept', 'fetch', 'status', 'cancel'])
  bareP2pError(ctx, argv0, 'unsupported subcommand' + (sug ? ' (did you mean ' + sug + '?)' : ''), argv0 + ' --help', opt)
}