用途:Trails 是契约优先的 TypeScript 框架。你用带类型输入、Result 输出、examples、meta 和 implementation 定义一次 trail,就能将同一份契约呈现在 CLI、MCP 或 HTTP(WebSocket 计划中)上,也可无表面直接执行。
主要能力:核心包 @ontrails/core 负责 Result、错误、trail/signal/entity/topo 契约、资源、分层、执行、校验和适配端口。表面包 @ontrails/commander、@ontrails/mcp、@ontrails/hono、@ontrails/http/bun 把同一 topo 开放到 CLI、MCP、Hono HTTP 或 Bun 原生 HTTP。基础设施包含 @ontrails/config、permits、store、drizzle;可观测性为 @ontrails/observability;生态包含 @ontrails/testing、topography、warden。
使用方式:定义 trail 后收集为 topo,再调用 surface(graph) 开放表面;也可 await run(graph, 'greet', { name: 'Alice' }) 无头执行,并用 testAll(graph) 一行跑完整契约套件。字段均需 .describe(),trail ID 用小写点分、动词结尾。intent 为 read 时 MCP 标记只读,为 destroy 时 CLI 自动加 --dry-run。
适用场景:需要以同一契约同时服务 CLI、MCP 与 HTTP 的 TypeScript 项目,以及重视示例即测试、契约治理和 graph 查询的团队。Wayfinder 提供只读图查询(trails wayfind、trails schema),用于查询已保存的 Topography 产物。
限制:WebSocket 尚未发布;Wayfinder 为图读取,不保证语义搜索;beta 阶段安装需使用精确 1.0.0-beta.N 或 @beta;公开发布包变更需分支本地 changeset。价格、收费与更多平台支持资料暂未提供。