@bd7pil/reeve 0.1.4 → 0.1.6

package/README.md

@@ -2,15 +2,16 @@
 
 > **In English:** this package is the whole REEVE system for opencode v2: eight
 > agent definitions, the review skill, the task ledger with concurrency gates,
-> wall-clock supervision and cross-restart reconciliation, the self-hosted
-> Bifrost proxy with chain hot-reload, and performance stats. It fills the
+> wall-clock supervision and cross-restart reconciliation, the in-process
+> GATE proxy layer (routing, fallback chains, ledger, model catalog), and
+> performance stats. It fills the
 > gaps v2 leaves open (`task_status`, silent child death, concurrency limits,
 > timeouts) without ever writing `agents.*.model` — that key belongs to
 > openchamber. Install with `{ "model": "reeve/pro", "plugins":
 > ["@bd7pil/reeve"] }` and nothing else needs to live in the config directory.
 > The rest of this document is the detailed Chinese reference.
 
-包里就是**整个系统**：8 个 agent + review skill + 记账/闸门/墙钟/对账 + 代理自持（Bifrost 链热更）+ 性能统计。
+包里就是**整个系统**：8 个 agent + review skill + 记账/闸门/墙钟/对账 + GATE 代理层（路由/回退/台账/目录，热更 ≤5s）+ 性能统计。
 配置目录里不需要放任何 REEVE 文件——装插件、写两行配置即可（见下「安装」）。
 
 v2 原生缺的那几条，全靠这个插件补齐：

package/default-fallback.json

@@ -0,0 +1,49 @@
+{
+  "//": "GATE 的兜底配置（机器上没有任何 reeve-fallback.jsonc 时用它）。刻意只放付费候选——免费车道（9router）属于每台机器自己的选择，写在用户配置里。",
+  "//cells": "providers.<id>：base_url + path（默认 /v1/chat/completions）+ auth（auth.json 里的 id，按序取第一个有 key 的）+ key（env.X 引用或公开字面量，覆盖 auth）+ lane（native | passthrough）+ models/models_fetch（目录来源）。",
+  "//tiers": "chain_for_model 里的 `reeve/*` 三条 = 引擎档位模型（插件注册的 reeve/flash|pro|multimodal）。引擎发**全名**进请求体，键必须写全名。没有免费车道时：flash → tier2a（便宜付费链）、multimodal → tier2a（bundle 里没有视觉专链）。",
+  "schema": 1,
+  "policy": {
+    "retry_on_errors": [401, 402, 403, 429, 500, 503, 529],
+    "max_fallback_attempts": 3,
+    "cooldown_seconds": 60,
+    "restore_primary_after_cooldown": false,
+    "first_prompt_watchdog_ms": 90000,
+    "provider_retries": 1,
+    "models_ttl_seconds": 300,
+    "session_ttl_seconds": 1800
+  },
+  "providers": {
+    "9router": { "base_url": "http://127.0.0.1:20128", "key": "none", "models": ["*"], "models_fetch": true },
+    "zhipuai-coding-plan": { "base_url": "https://open.bigmodel.cn", "path": "/api/coding/paas/v4/chat/completions", "auth": ["zhipuai-coding-plan"] },
+    "xxyapi-deepseek": { "base_url": "https://www.xxyapi.com", "auth": ["xxyapi-deepseek"] },
+    "lmuai": { "base_url": "https://api.lmuai.com", "auth": ["lmuai", "lmuai-glm"] },
+    "deepseek": { "base_url": "https://api.deepseek.com", "auth": ["deepseek", "deepseek-api"] },
+    "xiaomi": { "base_url": "https://api.xiaomimimo.com", "auth": ["xiaomi"] },
+    "alibaba-cn": { "base_url": "https://dashscope.aliyuncs.com", "path": "/compatible-mode/v1/chat/completions", "auth": ["alibaba-cn"] },
+    "opencode": { "base_url": "https://opencode.ai/inference/openai/v1", "path": "/chat/completions", "key": "public", "lane": "passthrough", "models": ["*"] }
+  },
+  "chains": {
+    "tier1": { "targets": ["zhipuai-coding-plan/glm-5.3", "deepseek/deepseek-flash"] },
+    "tier2a": { "targets": ["zhipuai-coding-plan/glm-5.3-flash", "xxyapi-deepseek/deepseek-v4.1-flash", "lmuai/glm-5.3-flash", "deepseek/deepseek-flash"] },
+    "default": { "targets": ["zhipuai-coding-plan/glm-5.3-flash", "xxyapi-deepseek/deepseek-v4.1-flash", "deepseek/deepseek-flash"] }
+  },
+  "agents": {
+    "planner": "tier1",
+    "advisor": "tier1",
+    "critic": "tier1",
+    "foreman": "tier2a",
+    "executor": "tier2a",
+    "reviewer": "tier2a",
+    "scout": "default",
+    "librarian": "default"
+  },
+  "chain_for_model": {
+    "reeve/flash": "tier2a",
+    "reeve/pro": "tier1",
+    "reeve/multimodal": "tier2a",
+    "zhipuai-coding-plan/glm-5.3": "tier1",
+    "zhipuai-coding-plan/glm-5.3-flash": "tier2a"
+  },
+  "default_chain": "default"
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bd7pil/reeve",
-  "version": "0.1.4",
-  "description": "REEVE 编排层（opencode v2 插件）：agent/skill 注册 + 子任务台账 + 代理自持（Bifrost 链热更）+ 性能统计",
+  "version": "0.1.6",
+  "description": "REEVE 编排层（opencode v2 插件）：agent/skill 注册 + 子任务台账 + GATE 代理层（路由/回退/台账）+ 性能统计",
   "type": "module",
   "main": "index.js",
   "exports": {
@@ -11,7 +11,7 @@
     "node": ">=22"
   },
   "scripts": {
-    "test": "node test/unit.mjs && node test/reconcile.mjs && node test/snapshot.mjs && node test/proxy.mjs && node test/chain.mjs && node test/stats.mjs && node test/entry.mjs",
+    "test": "node test/unit.mjs && node test/reconcile.mjs && node test/snapshot.mjs && node test/gate.mjs && node test/guard.mjs && node test/stats.mjs && node test/entry.mjs && node test/wiring.mjs && node test/runtime.mjs",
     "test:coverage": "c8 --reporter=text --reporter=json-summary --reports-dir=coverage --exclude=test/** --exclude=bench.mjs npm test",
     "check:coverage": "node ../scripts/check-coverage.mjs",
     "prepublishOnly": "npm test"
@@ -21,7 +21,7 @@
     "src",
     "agents",
     "skills",
-    "default-chain.json",
+    "default-fallback.json",
     "provision.json",
     "LICENSE",
     "THIRD-PARTY.md",

package/provision.json

@@ -1,51 +1,57 @@
 {
   "schema": 1,
   "name": "reeve",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "license": "MIT",
+  "//": "REEVE 在 ocrc 实例里的装配说明。**没有二进制工件** —— 代理层是插件内的 GATE（纯 JS），不需要任何本地服务（Bifrost 时代已结束）。",
   "host": {
     "node": ">=22",
-    "os": ["linux"],
-    "arch": ["x64"]
+    "os": [
+      "linux",
+      "win32"
+    ],
+    "arch": [
+      "x64"
+    ]
   },
   "enginePlugin": {
-    "spec": "@bd7pil/reeve@0.1.4",
+    "spec": "@bd7pil/reeve@0.1.6",
     "kind": "package",
     "entry": "~/.ocrc/components/reeve/node_modules/@bd7pil/reeve",
     "requiresPeer": []
   },
-  "artifacts": [
-    {
-      "id": "bifrost",
-      "version": "2.3.0",
-      "url": "https://downloads.getmaxim.ai/bifrost/v2.3.0/linux/amd64/bifrost-http",
-      "sha256": "e62a6425218d037e2aea10446f1f4ad1979291902623575a04b7e0ed46886f92",
-      "size": 134264480,
-      "dest": "~/.reeve/proxy/bifrost-http",
-      "mode": "0755"
-    }
-  ],
   "extension": {
     "apiVersion": 1,
     "id": "reeve",
     "zip": "https://github.com/BD7PIL/reeve/releases/download/reeve-latest/reeve.zip",
     "tag": "reeve-latest",
-    "capabilities": ["sessions", "filesystem"],
+    "capabilities": [
+      "sessions",
+      "filesystem"
+    ],
     "filesystem": [
       "~/.reeve-staging/.reeve/**",
       "~/.reeve/**",
       "~/.local/share/opencode/reeve/**",
-      "~/.reeve-staging/.local/share/opencode/reeve/**"
+      "~/.reeve-staging/.local/share/opencode/reeve/**",
+      "~/.config/opencode/reeve/**",
+      "~/.reeve-staging/.config/opencode/reeve/**"
     ]
   },
-  "configSync": ["reeve.jsonc", "agents"],
+  "//configSync": "GATE 的 fallback 配置（链/策略）由 ocrc 的 sync 推；reeve.jsonc 与 agents 是插件自身的配置面。",
+  "configSync": [
+    "reeve.jsonc",
+    "agents",
+    ".config/opencode/reeve"
+  ],
   "verify": [
     {
-      "kind": "file",
-      "path": "~/.reeve/proxy/bifrost-http",
-      "mode": "0755"
+      "kind": "engine-plugin-loaded",
+      "spec": "@bd7pil/reeve"
     },
-    { "kind": "engine-plugin-loaded", "spec": "@bd7pil/reeve" },
-    { "kind": "guest-installed", "id": "reeve" }
+    {
+      "kind": "guest-installed",
+      "id": "reeve"
+    }
   ]
 }

package/src/constants.js

@@ -1,10 +1,24 @@
 // REEVE 记账层的常量与状态机定义。
 // 施工图：docs/research/opencode-v2-plugin-api.md
 
+import { readFileSync } from 'node:fs'
+
 export const PLUGIN_ID = 'reeve'
 
-/** 与 package.json 的 version 保持一致；快照文件里会带上，便于面板判断版本。 */
-export const PLUGIN_VERSION = '0.1.4'
+/**
+ * 插件版本（快照文件里会带上，便于面板/台账判断"跑的是哪一版"）。
+ *
+ * **从 package.json 读**，不再手抄一个常量：手抄的那种"保持一致"是句祝愿 ——
+ * 0.1.5 发布时就漂过（package.json 0.1.5、常量还写 0.1.4，两端快照都报了旧版本）。
+ * 读不到就退回 '0.0.0'（只影响一个字符串，别让插件起不来）。
+ */
+export const PLUGIN_VERSION = (() => {
+  try {
+    return JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version ?? '0.0.0'
+  } catch {
+    return '0.0.0'
+  }
+})()
 
 /** 工具注册的命名空间。注意：真正决定"模型能否看见"的是 codemode:false（施工图 §3.1）。 */
 export const TOOL_NAMESPACE = 'reeve'

package/src/gate/classify.js

@@ -0,0 +1,77 @@
+// 错误分类：决定"这一笔该不该换候选"。
+//
+// 语义顺序（复刻自我们 v1 时代那套 fallback 的行为规格，不引入其代码）：
+//   ① 硬拒绝：abort / context_overflow → **永不换**（换了也是同样结局，还会跟用户的中断打架）
+//   ② 语义必换：quota_exceeded / model_not_found / missing_api_key → 不看状态码，直接换
+//   ③ 状态码白名单（policy.retry_on_errors）→ 换
+//   ④ 显式 isRetryable === true → 需要"状态码安全阀"（白名单 ∪ 5xx ∪ 408/425/429）才接受
+//   ⑤ 文本兜底（中英，含 9router 冷却期那种 503+retry-after 的说法）
+//
+// 只做判断，不做 IO——纯函数，测试逐条钉。
+
+const NEVER = [/abort/i, /context[\s_-]{0,12}overflow/i, /context\s+length/i, /too\s+many\s+tokens/i, /上下文.{0,6}超/i, /超出.{0,8}上[下]文/i]
+const ALWAYS = [
+  /quota[\s_-]*exceeded/i,
+  /resource[\s_-]*exhausted/i,
+  /out\s+of\s+credits/i,
+  /payment\s+required/i,
+  /insufficient[\s_-]*(quota|credits?|balance)/i,
+  /使用上限|额度不足|余额不足|已耗尽|达到.{0,6}限制/i,
+  /model[^\n]{0,24}not[^\n]{0,12}(found|supported)/i,
+  /模型.{0,6}(不存在|不支持)/i,
+  /missing[\s_-]*api[\s_-]*key/i,
+  /api[\s_-]*key[^\n]{0,16}(missing|not\s+set|required)/i,
+]
+const TEXT_HINTS = [
+  /rate[\s_-]*limit/i,
+  /too[\s_-]*many[\s_-]*requests/i,
+  /quota\s+will\s+reset\s+after/i,
+  /all\s+credentials\s+for\s+model/i,
+  /service[\s_-]*unavailable/i,
+  /overloaded/i,
+  /try[\s_-]*again/i,
+  /频率限制|请求过于频繁|暂时不可用|服务不可用|请稍后重试|限流/i,
+]
+const SAFE_EXTRA = Object.freeze([408, 425, 429])
+
+const asString = (v) => (typeof v === 'string' ? v : '')
+
+/** 状态码提取：`statusCode` → `status` → 嵌套（data/error/cause）→ 从文本里按白名单数字找。 */
+export function statusOf({ status, text, error, policy } = {}) {
+  const candidates = [status, error?.statusCode, error?.status, error?.data?.statusCode, error?.data?.status, error?.error?.statusCode, error?.error?.status, error?.cause?.statusCode, error?.cause?.status]
+  for (const c of candidates) if (Number.isFinite(Number(c)) && Number(c) >= 100) return Number(c)
+  const hay = `${asString(text)} ${asString(error?.message)} ${asString(error?.error?.message)}`
+  for (const n of policy?.retry_on_errors ?? []) {
+    if (new RegExp(`\\b${n}\\b`).test(hay)) return n
+  }
+  return null
+}
+
+/**
+ * @returns {{ retryable: boolean, reason: string, status: number|null }}
+ * reason ∈ never:abort|never:context | always:quota|always:model|always:key | status:<n> | explicit | text:<hint> | not-retryable
+ */
+export function classifyFailure({ status, text, error, headers, policy } = {}) {
+  const hay = `${asString(text)} ${asString(error?.message)} ${asString(error?.name)} ${asString(error?.error?.message)}`
+  for (const re of NEVER) if (re.test(hay)) return { retryable: false, reason: re === NEVER[0] ? 'never:abort' : 'never:context', status: statusOf({ status, text, error, policy }) }
+  for (const [i, re] of ALWAYS.entries()) if (re.test(hay)) return { retryable: true, reason: ['always:quota', 'always:quota', 'always:quota', 'always:quota', 'always:quota', 'always:quota', 'always:model', 'always:model', 'always:key', 'always:key'][i] ?? 'always', status: statusOf({ status, text, error, policy }) }
+
+  const code = statusOf({ status, text, error, policy })
+  const list = policy?.retry_on_errors ?? []
+  if (code !== null && list.includes(code)) return { retryable: true, reason: `status:${code}`, status: code }
+
+  if (error?.isRetryable === true || error?.data?.isRetryable === true) {
+    const safe = code !== null && (list.includes(code) || (code >= 500 && code < 600) || SAFE_EXTRA.includes(code))
+    return { retryable: safe, reason: safe ? 'explicit' : 'explicit-unsafe-status', status: code }
+  }
+
+  for (const re of TEXT_HINTS) if (re.test(hay)) return { retryable: true, reason: 'text', status: code }
+  // 裸数字：429/503/… 出现在文本里（上游把码写进了消息）
+  for (const n of list) if (new RegExp(`\\b${n}\\b`).test(hay)) return { retryable: true, reason: `text:${n}`, status: code }
+
+  // 9router 形状：冷却期内的 503 + retry-after（有 retry-after 就是"过一会儿再来"，值得换）
+  const retryAfter = headers?.get?.('retry-after') ?? headers?.['retry-after']
+  if (code === 503 && retryAfter) return { retryable: true, reason: 'status:503', status: code }
+
+  return { retryable: false, reason: 'not-retryable', status: code }
+}

package/src/gate/config.js

@@ -0,0 +1,172 @@
+// GATE 配置加载与归一化。
+//
+// 配置来源（按序）：options.fallbackConfigPath → ~/.config/opencode/reeve-fallback.jsonc → 打包的 default-fallback.json。
+// 规则与仓库其它组件同一条：**坏文件当作"未变更"**（保留上一份好配置、如实报问题），缺文件回落打包默认。
+// jsonc 支持整行 `//` 注释（与引擎侧 opencode.jsonc 同风格）。
+import { readFile, stat } from 'node:fs/promises'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+/** 打包的兜底配置（无用户配置时用它）。 */
+export const BUNDLED_FALLBACK_PATH = fileURLToPath(new URL('../../default-fallback.json', import.meta.url))
+
+/**
+ * 机器上的用户配置（三端共享同一份）。
+ * 形状说明：`~/.config/opencode/reeve/` 这一个**目录**是三端共享面（开发机上是 junction → 仓内
+ * `.config/opencode/reeve/`，对端由 ocrc sync 同步这个目录），配置文件放里面；以后要再加
+ * "策略/车道"之类的小配置也进这个目录，别再散落。
+ */
+export function defaultFallbackConfigPath({ home = homedir() } = {}) {
+  return join(home, '.config', 'opencode', 'reeve', 'fallback.jsonc')
+}
+
+export const POLICY_DEFAULTS = Object.freeze({
+  retry_on_errors: Object.freeze([401, 402, 403, 429, 500, 503, 529]),
+  max_fallback_attempts: 3,
+  cooldown_seconds: 60,
+  restore_primary_after_cooldown: false,
+  first_prompt_watchdog_ms: 90_000,
+  provider_retries: 1,
+  models_ttl_seconds: 300,
+  session_ttl_seconds: 1800,
+})
+
+const DEFAULT_PATH = '/v1/chat/completions'
+export const LANES = Object.freeze({ NATIVE: 'native', PASSTHROUGH: 'passthrough' })
+
+export function stripLineComments(text) {
+  return String(text)
+    .split('\n')
+    .filter((l) => !l.trim().startsWith('//'))
+    .join('\n')
+}
+
+const asRecord = (v) => (v && typeof v === 'object' && !Array.isArray(v) ? v : null)
+const asStrings = (v) => (Array.isArray(v) ? v.filter((x) => typeof x === 'string' && x.length > 0) : [])
+
+/**
+ * 归一化 + 校验。**不抛**：把能用的一部分留下，问题如实收集进 `problems`（面板与日志据此报）。
+ */
+export function normalizeGateConfig(raw) {
+  const problems = []
+  const src = asRecord(raw) ?? {}
+  const policy = { ...POLICY_DEFAULTS }
+  const pSrc = asRecord(src.policy) ?? {}
+  for (const key of Object.keys(POLICY_DEFAULTS)) {
+    const v = pSrc[key]
+    if (v === undefined) continue
+    if (typeof v !== typeof POLICY_DEFAULTS[key] && !(Array.isArray(v) && Array.isArray(POLICY_DEFAULTS[key]))) {
+      problems.push(`policy.${key} 类型不对（忽略）`)
+      continue
+    }
+    policy[key] = v
+  }
+  policy.retry_on_errors = (Array.isArray(policy.retry_on_errors) ? policy.retry_on_errors : []).filter((n) => Number.isFinite(n))
+
+  const providers = {}
+  for (const [id, v] of Object.entries(asRecord(src.providers) ?? {})) {
+    const p = asRecord(v)
+    if (!p) {
+      problems.push(`providers.${id} 不是对象（忽略）`)
+      continue
+    }
+    if (typeof p.base_url !== 'string' || p.base_url.length === 0) {
+      problems.push(`providers.${id} 缺 base_url（不可达，候选会被跳过）`)
+    }
+    providers[id] = {
+      id,
+      base_url: typeof p.base_url === 'string' ? p.base_url.replace(/\/+$/, '') : '',
+      path: typeof p.path === 'string' && p.path.length > 0 ? p.path : DEFAULT_PATH,
+      auth: asStrings(p.auth).length > 0 ? asStrings(p.auth) : [id],
+      key: typeof p.key === 'string' && p.key.length > 0 ? p.key : null,
+      models: asStrings(p.models),
+      models_fetch: p.models_fetch === true,
+      lane: p.lane === LANES.PASSTHROUGH ? LANES.PASSTHROUGH : LANES.NATIVE,
+      retries: Number.isFinite(p.retries) ? Number(p.retries) : policy.provider_retries,
+    }
+  }
+
+  const chains = {}
+  for (const [name, v] of Object.entries(asRecord(src.chains) ?? {})) {
+    const targets = asStrings(asRecord(v)?.targets)
+    if (targets.length === 0) {
+      problems.push(`chains.${name} 没有 targets（忽略）`)
+      continue
+    }
+    chains[name] = { targets }
+  }
+
+  const agents = {}
+  for (const [agent, chain] of Object.entries(asRecord(src.agents) ?? {})) {
+    if (typeof chain !== 'string' || !chains[chain]) {
+      problems.push(`agents.${agent} 指向的链不存在：${String(chain)}（忽略）`)
+      continue
+    }
+    agents[agent] = chain
+  }
+
+  const chainForModel = {}
+  for (const [model, chain] of Object.entries(asRecord(src.chain_for_model) ?? {})) {
+    if (typeof chain !== 'string' || !chains[chain]) {
+      problems.push(`chain_for_model.${model} 指向的链不存在：${String(chain)}（忽略）`)
+      continue
+    }
+    chainForModel[model] = chain
+  }
+
+  const defaultChain = typeof src.default_chain === 'string' && chains[src.default_chain] ? src.default_chain : Object.keys(chains)[0] ?? null
+  if (defaultChain === null) problems.push('没有可用的链（default_chain 缺失）')
+
+  return { schema: 1, policy, providers, chains, agents, chain_for_model: chainForModel, default_chain: defaultChain, problems }
+}
+
+/**
+ * 读配置：returns `{ config, from, problems, error }`。
+ * `raw === null` 表示"这次没读到可用的一层"（调用方保留上一份好配置）。
+ */
+export async function loadGateConfig({ path = defaultFallbackConfigPath(), bundledPath = BUNDLED_FALLBACK_PATH, readFileImpl = readFile } = {}) {
+  for (const p of [path, bundledPath]) {
+    if (!p) continue
+    try {
+      const text = await readFileImpl(p, 'utf8')
+      const parsed = JSON.parse(stripLineComments(text))
+      const config = normalizeGateConfig(parsed)
+      return { config, from: p, problems: config.problems, error: null }
+    } catch (err) {
+      // 用户配置读不动 → 试打包默认；打包默认也读不动 → 报错（调用方保留上一份）
+      if (p === bundledPath) return { config: null, from: null, problems: [], error: `配置读不动：${String(err).slice(0, 160)}` }
+    }
+  }
+  return { config: null, from: null, problems: [], error: '没有可读的配置（用户配置与打包默认都失败）' }
+}
+
+/**
+ * 只 stat 的热更探针（与插件盯链文件的同一条纪律：**只 stat**，变了才重读）。
+ * 返回 { stop }；`changed` 回调拿到新的 `{ config, from, error }`（坏文件由调用方决定保留旧的）。
+ */
+export function watchGateConfig({ path = defaultFallbackConfigPath(), bundledPath = BUNDLED_FALLBACK_PATH, intervalMs = 5000, onChange, readFileImpl = readFile, statImpl = stat }) {
+  let marker = null
+  const tick = async () => {
+    let m = null
+    try {
+      const st = await statImpl(path)
+      m = `${Number(st.mtimeMs)}:${Number(st.size)}`
+    } catch {
+      m = 'missing'
+    }
+    if (marker === null) {
+      marker = m
+      return
+    }
+    if (m === marker) return
+    marker = m
+    const next = await loadGateConfig({ path, bundledPath, readFileImpl })
+    onChange?.(next)
+  }
+  const timer = setInterval(() => void tick().catch(() => {}), Math.max(200, intervalMs))
+  timer.unref?.()
+  // 立刻记一次基线：否则"启动后马上改文件"会被第一次 tick 当成基线吞掉（实测踩到）
+  void tick().catch(() => {})
+  return { stop: () => clearInterval(timer) }
+}