/**
 * Manager 侧 `RemoteSpawner.endpointFor` 的**端点翻译接线**单测（覆盖网络 R4）。
 *
 * ## 为什么单独立一个文件（2026-09-16 实测代价）
 * `translateEndpoint` 是 R4 的**唯一**翻译点：`via='relay'` 的 host，其实例在 Worker 上监听
 * `127.0.0.1:<实例端口>`，而 Manager 必须拨 relay 为那个端口开的**动态回环口号**。
 *
 * 首版实现里 `RemoteSpawner` 的构造函数**漏了 `this.translateEndpoint = options.translateEndpoint`**
 * —— 于是整个翻译**静默失效**：`endpointFor` 原样返回 Worker 侧口号 ⇒ Manager 往**自己本机**
 * 拨 `127.0.0.1:21000` ⇒ 连接被拒两次 ⇒ 代理 `reply.raw.destroy()`。
 * 现场表现只有两条：浏览器/curl 看到 **`Empty reply from server`**；平台日志**一行错误都没有**。
 * （定位靠"在 47 上临时监听 21000，请求被这个探针接走"——即**用判别器测，而不是读代码猜**。）
 *
 * ⇒ 本文件把"翻译必须真的生效"钉成断言：**构造时就验**，不依赖集群环境、不依赖 relay 在跑。
 *
 * 运行：`node --test test/remote-spawner.test.mjs`（已登记进 `npm test` / `npm run verify`）。
 *
 * @module test/remote-spawner
 */

import assert from 'node:assert/strict'
import { test } from 'node:test'
import { RemoteSpawner, PROBE_TIMEOUT_MS, AGENT_ERROR_TEXT_MAX } from '../lib/supervisor/remote-spawner.js'

/* ─────────── 小工具 ─────────── */

/** Worker 侧 agent 的回包（`GET /endpoint/:userId` 的形状）。 */
function fakeFetch(payload) {
  const calls = []
  const impl = async (url, init) => {
    calls.push(`${init?.method ?? 'GET'} ${url}`)
    return { ok: true, status: 200, json: async () => payload, text: async () => JSON.stringify(payload) }
  }
  impl.calls = calls
  return impl
}

/** `via='relay'` 的一台 worker：agent 口号 19000，relay 已把它映射到本机 38253。 */
const W106 = {
  hostId: 'w-2',
  agentUrl: 'http://127.0.0.1:19000',
  reachability: { hostId: 'w-2', via: 'relay', address: '127.0.0.1:38253', scheme: 'http' },
  token: 'tok-106',
}

function make(opts = {}) {
  return new RemoteSpawner({
    agentUrl: 'http://127.0.0.1:19100',
    token: 'tok-local',
    defaultHostId: 'w-1',
    hostIdFor: async () => 'w-2',
    hostsProvider: async () => [W106],
    fetchImpl: fakeFetch({ running: true, host: '127.0.0.1', port: 21000 }),
    ...opts,
  })
}

/* ─────────── T1–T4 ─────────── */

test('T1 翻译器被真的接上：传入的 hostId/endpoint 与返回值都要生效', async () => {
  const seen = []
  const s = make({
    translateEndpoint: (hostId, ep) => {
      seen.push([hostId, ep])
      return { host: '127.0.0.1', port: 34241 }
    },
  })
  assert.deepEqual(await s.endpointFor('u1'), { host: '127.0.0.1', port: 34241 })
  // ★ 这一条就是首版漏赋值时唯一会红的断言：漏了 ⇒ seen 为空、返回 {21000}
  assert.deepEqual(seen, [['w-2', { host: '127.0.0.1', port: 21000 }]])
})

test('T2 未给翻译器 ⇒ 原样透传（local / manager-ssh 的同号语义，行为零变化）', async () => {
  const s = make()
  assert.deepEqual(await s.endpointFor('u1'), { host: '127.0.0.1', port: 21000 })
})

test('T3 翻译器回 undefined ⇒ endpointFor 也回 undefined（失败关闭，不回退 Worker 口号）', async () => {
  const s = make({ translateEndpoint: () => undefined })
  assert.equal(await s.endpointFor('u1'), undefined)
})

test('T4 实例未运行 ⇒ undefined，且**不该**调翻译器（没有端口可翻）', async () => {
  let called = false
  const s = make({
    fetchImpl: fakeFetch({ running: false }),
    translateEndpoint: () => {
      called = true
      return undefined
    },
  })
  assert.equal(await s.endpointFor('u1'), undefined)
  assert.equal(called, false)
})

/* ─────────── T5：跨机探活的客户端预算（2026-09-25 第 17 棒补）─────────── */

test('T5 /restart-probe 走独立预算：⛔ 不许吃 10s 默认值（否则跨机"启用插件"永久失败）', async () => {
  // 真机实证（47 · 第 17 棒）：这个口吃默认 10s，而对端要**真重启实例**（冷启动 10–14 s）
  // ＋ 2.5 s 稳定窗 ⇒ 每次必超时；`call()` 还会再重试 3 次（每次都再重启一次实例，实测
  // 一条任务连打 8 次 /restart-probe、约 100 s 后以 "The operation was aborted due to timeout" 收场）。
  const seen = []
  const s = make({
    fetchImpl: async (url, init) => {
      seen.push({ url: String(url), hasSignal: init?.signal !== undefined })
      return { ok: true, status: 200, json: async () => ({ ok: true, reason: '' }), text: async () => '{}' }
    },
  })
  const r = await s.restartAndProbe('u1')
  assert.equal(r.ok, true)
  assert.equal(seen.length, 1, '一次成功就不该重试（重试 = 再重启一次实例）')
  assert.ok(seen[0].url.endsWith('/restart-probe/u1'), '必须打对端的 /restart-probe')
  assert.ok(seen[0].hasSignal, '必须带超时信号（⛔ 不许变成"永不超时"）')
  assert.ok(
    PROBE_TIMEOUT_MS >= 60_000,
    `客户端预算 ${PROBE_TIMEOUT_MS}ms 必须 ≥ 对端探活预算 60000ms（旧值 10s ⇒ 跨机启用插件永久失败）`,
  )
})

/* ─────────── T6–T8：跨机错误消息保留长度（2026-09-25 第 23 棒 · §5-12）─────────── */

/** Worker 侧 agent 回一个**非 2xx**，正文为 `body` —— 用来把 `call()` 的错误分支逼出来。 */
function failingFetch(status, body) {
  const calls = []
  const impl = async (url, init) => {
    calls.push(`${init?.method ?? 'GET'} ${url} @${status}`)
    return { ok: false, status, json: async () => ({}), text: async () => body }
  }
  impl.calls = calls
  return impl
}

/** 从 reject 出来的错误里取 `message`（并断言它确实是 Error）。 */
async function caughtMessage(promise) {
  try {
    await promise
  } catch (err) {
    assert.ok(err instanceof Error, '必须是 Error（⛔ 别把非 Error 直接抛出）')
    return err.message
  }
  assert.fail('本该抛错，却成功返回了')
}

test('T6 4xx 的真实原因不再被截到 200 字符（证据完整落进 Manager 侧 message）', async () => {
  // 第 17 棒现场：Manager 侧任务 detail 只看到半截，真根因（pnpm 原文）只能从 worker 的
  // journald 补 —— 跨机形态下这条取证路径对运维不可用。故本断言钉住"整段可读"。
  const body = `pnpm failed: ${'EPERM-chmod-'.repeat(80)}` // 973 字符
  assert.ok(body.length > 200 && body.length <= AGENT_ERROR_TEXT_MAX, `夹具长度须落在 (200, ${AGENT_ERROR_TEXT_MAX}]`)
  const s = make({ fetchImpl: failingFetch(400, body) })
  const msg = await caughtMessage(s.applyPlugins('u1', []))
  assert.ok(!msg.includes('slice'), '错误正文里不该出现实现细节')
  assert.equal(msg.endsWith(body), true, '4xx 正文必须**逐字完整**保留（旧口径只留前 200）')
  assert.ok(msg.length > 200 + 'agent POST /plugins/apply → 400: '.length, '整条 message 必须明显长于旧口径')
})

test('T7 边界：恰好上限全留；多 1 个字符即被截到上限', async () => {
  const exact = 'A'.repeat(AGENT_ERROR_TEXT_MAX)
  const over = `${exact}B`
  const s1 = make({ fetchImpl: failingFetch(400, exact) })
  const msg1 = await caughtMessage(s1.applyPlugins('u1', []))
  assert.ok(msg1.endsWith(exact), `恰好 ${AGENT_ERROR_TEXT_MAX} 字符必须**一个不少**`)

  const s2 = make({ fetchImpl: failingFetch(400, over) })
  const msg2 = await caughtMessage(s2.applyPlugins('u1', []))
  assert.equal(msg2.endsWith(exact), true, `超过 ${AGENT_ERROR_TEXT_MAX} 时截到上限`)
  assert.equal(msg2.endsWith(over), false, '⛔ 超过上限不许全留（上限还在，不是"关了限制"）')
})

test('T8 5xx 分支走同一上限，且既有重试语义未被改动（仍重试 4 次）', async () => {
  // ⛔ 本单只放宽"保留长度"，⛔ 不动重试次数 —— 5xx 仍要跑满 4 次尝试（退避 200/1000/3000 ms）。
  const body = 'B'.repeat(AGENT_ERROR_TEXT_MAX + 50)
  const f = failingFetch(503, body)
  const s = make({ fetchImpl: f })
  const msg = await caughtMessage(s.applyPlugins('u1', []))
  assert.equal(msg.endsWith('B'.repeat(AGENT_ERROR_TEXT_MAX)), true, '5xx 分支同样保留到上限')
  assert.equal(f.calls.length, 4, '5xx 仍重试 4 次（本单不改重试语义）')
})