POSTFACT — Resolve Ambiguous Side Effects Before Retry

POSTFACT

这次调用真的发生了吗？

POSTFACT 是一款轻量的模糊结果判定工具，适用于自主软件。在有副作用的 API／工具操作出现模糊失败后、重试前使用它。

生产环境：https://postfact-api-production.up.railway.app

它刻意采用严格判定：

• 只有肯定性证据能够证明操作已完成时，才判定为 DONE。
• 只有肯定性证据能够证明操作未执行时，才判定为 NOT_DONE。
• 证据不足时一律判定为 UNKNOWN。UNKNOWN 是安全的默认值。

POSTFACT 不会执行底层操作、转移资金，也不会假装超时就代表失败。

REST

生产环境端点：POST https://postfact-api-production.up.railway.app/v1/resolve

输入接受方法／状态／失败信息、副作用和幂等性上下文、持久化引用，以及可选的肯定性证据。输出包括 state、retry_safe、confidence、evidence 和 next。

MCP

远程端点：POST https://postfact-api-production.up.railway.app/mcp

工具：resolve_outcome

该工具描述明确告知 Agent，应在有副作用的操作模糊失败后、重试前调用 POSTFACT。

中间件形式的契约

const outcome = await postfact.resolve(failureContext)
if (outcome.state === 'DONE') return completed
if (outcome.state === 'NOT_DONE' && outcome.retry_safe) return retry()
return verifyOrHold()

未来的 SDK 可以封装重试中间件，而无需更改线路契约。

POSTFACT + RECOVER

POSTFACT 回答我们能确定发生了什么？ RECOVER 回答接下来最安全的操作是什么？ 未来的重试栈可以先调用 POSTFACT，再在结果仍不确定时调用 RECOVER。

安全发现与演示

• 健康状态：GET https://postfact-api-production.up.railway.app/health
• 演示：GET https://postfact-api-production.up.railway.app/demo
• 活动：GET https://postfact-api-production.up.railway.app/activity
• 机器可读的活动数据：GET https://postfact-api-production.up.railway.app/activity.json

GET /demo 会刻意排除在真实使用情况分析之外。

真实使用情况排行榜

GET /activity 显示永久的 FIRST 10 TRUE STRANGERS 排行榜。GET /activity.json 提供机器可读的摘要。演示／内部流量不计入其中。生产环境的持久化存储挂载在 /data。

运行

npm test
npm start

默认端口：8080。