自改进决策契约 xiciyang/rsi-contract

@xiciyang/rsi-contract

五个自改进决策原语——目标设定、方向选择、效果判定、风险识别、回退决策。
每个都是一次纯函数调用：给输入、出结论、附证据、自带阻断理由。

这不是什么（先说清楚）

这不是一个 RSI 循环。 本库不含：

- 编排、调度、迭代控制
- 重试、停止条件、预算控制
- 状态持久化、人工晋级闸门
- 任何「自我进化」的执行体

逐轮推进是调用方的事。这里只把「一次决策该怎么判」固化成可测试的契约——因为自改进系统最容易骗自己的地方不是执行，而是判定：

- 目标设定时把「想做」当成「值得做且做得成」
- 方向选择时把「能跑通」当成「该走这条路」
- 效果判定时用自己产出的证据证明自己有效
- 风险识别时默认「往好处走」
- 回退决策时给不出「怎么证明真的回去了」

五个能力各自回答一个问题，并明确写出不做什么（见 CONTRACT.md 的分配表）。

五个能力

| 能力 | 回答的问题 | 明确不做 |
| goalSetting | 现在有哪几件值得做且做得成的事？ | 不选手段、不评风险、不执行 |
| directionSelection | 用哪个手段去做？ | 不评风险、不执行、不改目标度量 |
| effectJudgment | 做完之后，Δ 是真的吗？ | 不产出下一步、不用自己产出的证据 |
| riskAssessment | 这个方向有多危险？ | 不做回退决策、不执行、不替调用方降档 |
| rollbackDecision | 出事了回到哪、怎么回、怎么证明回去了？ | 不执行回退、不触发回退（只给方案） |

另外提供：significance()（改进量与显著性判据）、verifyRollbackDecision()（回退是否真的发生）、
canonicalJson()、factorTable()、assertNoSafeLevel()。

安装

npm i @xiciyang/rsi-contract
或直接把 src/ 拷进你的项目（零运行时依赖，只用 node: 内置模块）

要求：Node.js >= 20。没有网络、文件系统或 GPU 依赖——需要数据时由调用方在外面取好、以参数注入。

用法

import { goalSetting, effectJudgment, rollbackDecision, significance } from '@xiciyang/rsi-contract'

const goals = goalSetting({ /* 候选、预算、可验证性 … / }) const verdict = effectJudgment({ / before/after、噪声模型、证据来源 … / }) const plan = rollbackDecision({ / 变更、可达回退点 … */ })

每个返回值都带 ok / blocked / 判据与证据字段；被拒绝时给出理由，不是静默返回 false。
字段与错误码以 CONTRACT.md 为准（契约版本 0.1.0，能力语义版本 2.0.0）。

测试

node tests/run.mjs

7 个 spec、616 条断言，覆盖：五个能力的正常/阻断路径、判据自检、确定性（同输入同输出）、契约导出面一致性。全部是纯逻辑，任何机器上都应全绿。

为什么会有人需要它

自改进/自动调优系统最常见的事故不是「改错了」，而是判定层坏了却没人发现：效果判定用了自己刚写下的日志、显著性判据在噪声上做优化、回退方案从未被验证过。把判定抽成纯函数、让每个判定带反例与阻断理由，是这类系统能被外部审查的前提。

本库只提供这一层；怎么用、要不要真的自动执行，是调用方的风险决定。

许可

BSD-3-Clause。见 LICENSE。