@misaka-net/misakanet-setup 0.8.0 → 0.8.1

package/bin/misakanet-setup.mjs

@@ -197,7 +197,7 @@ function readText(path) {
  * except the two that name the version (measured 2026-10-22: the 0.6.0 release pull request
  * failed 9 e2e legs on exactly that).
  */
-const VERSION = '0.8.0'  // x-release-please-version
+const VERSION = '0.8.1'  // x-release-please-version
 
 /**
  * The shape of a client id, in one place.
@@ -1245,6 +1245,40 @@ let lastResponseOk = false;
 // `--verify` can print is what actually came back (`{}` is not a diagnosis).
 let lastResponsePreview = '';
 
+// The server's retry horizon on the last response, in seconds, when it sent one: the `Retry-After`
+// response header (seconds or an HTTP-date), the standard shape `docs/index.html` already reads on
+// 429s. Per-request, so a horizon from an earlier call can never leak into a later failure's words.
+let lastRetryAfterSeconds = null;
+
+/** `Retry-After` → seconds. Both forms the header allows; anything else is "no horizon", not 0. */
+function retryAfterSeconds(headerValue) {
+  const raw = String(headerValue || '').trim();
+  if (!raw) return null;
+  if (/^\d+$/.test(raw)) return Number(raw);
+  const at = Date.parse(raw);
+  if (Number.isNaN(at)) return null;
+  return Math.max(0, Math.round((at - Date.now()) / 1000));
+}
+
+/**
+ * How long the server says to wait before re-running, when it says. The failure body's `retry_after`
+ * (seconds, HTTP `Retry-After` semantics) wins over the header, and neither is guessed: a server that
+ * stays silent gets no horizon sentence at all.
+ */
+function retryHorizonOf(result) {
+  const fromBody = result && (result.retry_after ?? result.retry_after_seconds);
+  const n = Number(fromBody);
+  if (Number.isFinite(n) && n > 0) return Math.round(n);
+  return lastRetryAfterSeconds;
+}
+
+/** "45 秒" / "15 分钟" / "2 小时" — the horizon in the words a person reads a clock in. */
+function humanWait(seconds) {
+  if (seconds < 60) return `${seconds} 秒`;
+  if (seconds < 3600) return `${Math.round(seconds / 60)} 分钟`;
+  return `${Math.round(seconds / 3600)} 小时`;
+}
+
 async function mcpRequest(method, params, timeoutMs = 6000, urlOverride = '') {
   const headers = {
     'Content-Type': 'application/json',
@@ -1260,6 +1294,7 @@ async function mcpRequest(method, params, timeoutMs = 6000, urlOverride = '') {
   lastRequestKind = '';
   lastResponseOk = false;
   lastResponsePreview = '';
+  lastRetryAfterSeconds = null;
   try {
     const response = await fetch(urlOverride || ENDPOINT, {
       method: 'POST',
@@ -1271,6 +1306,9 @@ async function mcpRequest(method, params, timeoutMs = 6000, urlOverride = '') {
     // below, not by this line — but "it answered with something that is not a handshake" and
     // "nothing answered" are different facts (see probeOutcome()).
     lastResponseOk = true;
+    lastRetryAfterSeconds = retryAfterSeconds(
+      response.headers && typeof response.headers.get === 'function'
+        ? response.headers.get('Retry-After') : null);
     const payload = await response.json();
     lastResponsePreview = JSON.stringify(payload).slice(0, 160);
     if (payload && payload.error) {
@@ -1618,8 +1656,15 @@ async function ensureIdentity() {
       : serverCode
         ? `服务端拒绝了这次注册（${serverCode}）`
         : `多半是网络（${lastRequestError || '没有收到响应'}）`;
+    // …and when the server says *how long* to wait, say that too instead of "稍后". The horizon is
+    // never guessed and never rounded into a promise: a server that sent none keeps the vague
+    // wording, because a made-up wait is the same lie as the network guess this replaced (issue
+    // #3511 — the retry-horizon half; the `code` half landed with #3512).
+    const horizon = retryHorizonOf(result);
     need(`匿名注册没成功：${cause} → 读课程不受影响，但写入类工具（write_lesson）现在用不了；`
-      + '稍后重跑本命令就能拿到 token'
+      + (horizon
+        ? `约 ${humanWait(horizon)}后重跑本命令就能拿到 token（服务端给出的重试窗口）`
+        : '稍后重跑本命令就能拿到 token')
       + (serverHint ? `（服务端提示：${serverHint}）` : ''));
     return '';
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@misaka-net/misakanet-setup",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "MisakaNet failure lessons for your agents: writes an MCP endpoint into each agent config, rules blocks where the client takes one, and a Claude Code hook. At most one anonymous request leaves this machine at install; then only the agent's calls — unless MISAKANET_HOOK_FETCH=1 (off by default) the hook sends the failed call's error text or command.",
   "bin": {
     "misakanet-setup": "bin/misakanet-setup.mjs"