港口合同

每个跨越Isomorph边界的数据形状的单一真理源 组件. 司马先: 手写 JSON Schema 在 schema/ 是来源; 跳 软件包( r)gen-go/)和类型脚本包(gen-ts/ → @fourier-labs/harbour-contracts已经 生成 和执着。 没有处理器, 后置堆栈, 或 MCP 操作程序是针对一个形状构建的 这里首先存在.

版式

计划

运行时资源简介是由转换、文物和 定义明确的应用程序显示。 支持的配置文件是 standard, (中文(简体) ), memory-1g,以及 memory-2g;消费者必须拒绝未经确认的原始CPU或内存覆盖.

两种计划携带逻辑 超越结构类型,生成到帮助者:

• error-category.enum.json → IsRetryable(category) (前进) / isRetryable(category) (TS), 处理具体类别和家庭前缀storage.unsupported-engine.<engine>) (中文(简体) ). 未知类别已关闭( 不可重试) .
• version-state.schema.json → CanTransition(environment, from, to) 编号 : IsTerminal(state) (开始)和 canTransition 编号 : isTerminal (TS),由 x-transitions 边缘列表——如此控制平面 任何消费者都同意一个来源的合法性.
• binding-classification-subject.schema.json 财务报告和审定财务报表 sanitized-binding-evidence.schema.json · 犬形长度前缀SHA-256 预想/潜水员加上确切姓名, 在 Go 和 TypeScript 中请求映射和分配接收验证器.
• integration-execute-request.schema.json → IntegrationExecuteInputRules + 键 validateIntegrationExecuteInput(operation, input) (TS)/ (中文(简体) ) ValidateIntegrationExecuteInput (走开), 从每个操作的 then- 块(propertyNames.enum, (中文(简体) ), required每个外地 maximum编号 :default) (中文(简体) ). 治理者执行路径, 应用 SDK 和工具包的本地检查 拒绝同样判决的请求(limit must be an integer between 1 and 15; 计 数 SDK出售TypeScript文件,因为它没有依赖性.

工作流程

make gen       # regenerate gen-go/ + gen-ts/ from schema/ (Node only — no Go needed)
make verify    # regenerate, then fail if git shows a diff  ← the staleness gate (CI runs this)
make build     # compile-check the generated Go + TS (needs go + local tsc)
make test      # generator determinism + contract-logic tests (Node; Go when installed)

代码是 只节点 这样 make gen 可在任何地方复制 tsc 为: 仅用于 编译检查 产出(make build),而不是生成.

更改形状

1. 编辑方案 schema/。类别 enum 和 状态机器是 关闭 - 延长 他们 只有通过 PR 到此 repo (PR是通知消费者的地方).
2. make gen 承诺 gen-go/ + 键 gen-ts/ 除了改变计划.
3. CI (中文(简体) )make verify失败 .
4. 不编辑 VERSION, (中文(简体) ), package.json其版本或 CHANGELOG.md: 发布版本来自 页:1 vX.Y.Z 合并后按下标签( t)ADR 0050 (英语)) (中文(简体) ).
5. 形状变化是 (contracts) 变化:通过 /review + 键 /code-review ultra → /ship。 。 。 .

消费者应该将出版的三部分版本和出版的三部分放在上面 schemasDigest编号 :aiFixturesDigest 内 contract-release.json他们的线人应该 (一) 对照所生成的型号或计划,验证罐头装置; 在合同没有签出时,它不能默默不作. Npm文物中包含 schema/, (中文(简体) ), fixtures/ai/, (中文(简体) ), gen-ts/ 和释放 显示,所以每个由显示器命名的字节都可从 同样的释放。 通过标记的 Go 模块源源仍然可用 .

generatedGo 财务报告和审定财务报表 generatedTypeScript 封存每个 .go编号 :.ts 文档中 软件包目录. gen-go/contract_release.go 财务报告和审定财务报表 gen-ts/contract-release.ts 是唯一的排除: 那些生成的文件 嵌入集合消化器本身,所以将它们包括进去将产生一个 自我参考,没有有限的摘要。 列出的排除和 (a) 测试拒绝任何不同的排斥设置和独立 重新计算每个包含的文件和集合 .

平台中性的工作量和秘密参考资料是标识,而不是一般的 URLs (英语). 他们用 scheme://authority/path 经审查的添加剂计划 登记(aws-sm, (中文(简体) ), iam-role, (中文(简体) ), k8s-sa, (中文(简体) ), secretref, (中文(简体) ), spiffe, (中文(简体) ), vault, (中文(简体) ), vault-v2) (中文(简体) ). 一个新的平台在合同发布中扩展了登记处. 用户信息、 端口、 % 编码、 查询字符串、 碎片和空路径 区段故意无法代表,防止引用字段 成为证明或任意价值的运输.

V2 度量计方案是与现有 v1 政策/跟踪挂钩的预测 身份证明 在迁移期间,消费者可双读v1和v2,并可双写 都一样 旧记录从不重写;更正仅为附加调整 或取代记录。 删除 v1 写作需要单独记录 消费者削减证据.

消费

• 开始: go get github.com/Fourier-Labs-AI/harbour-contracts/[email protected]

  二事使此相通,而后一相相出,非所显也.

  发布标记必须是3个部分的分集. 运行和npm 需要 MAJOR.MINOR.PATCH,而此寄存器记录 MAJOR.MINOR.PATCH.MICRO因此,可公布的发布要求多边空间研究组织: 成为零, 并按确定性绘制地图:仓库 0.9.0.0 − 包装 0.9.0 → 发布标签 v0.9.0。可选的四部分记账标签 v0.9.0.0 可能 在同一承诺中指明,但不公布。 CI验证这张地图, 更改日志标题和标签格式.

  Repo是私人的,Go从全球缓存取来. 设定此值一次 机器 :

  go env -w GOPRIVATE=github.com/Fourier-Labs-AI/*
  git config --global credential."https://github.com/Fourier-Labs-AI".helper '!gh auth git-credential'
  git config --global credential."https://github.com/Fourier-Labs-AI".useHttpPath true
  

  证书的配置必须是 全局和URL范围d,该组合是 非附带事项 :

  • 无法覆盖文件夹( I)includeIf gitdir:…) (中文(简体) ). 运行 git ls-remote 内部 ~/go/pkg/mod/cache/vcs/…所以每个指南的助手从不 适用。 完全失败 /tmp 并且从伊索莫特的复出 让它看起来像一个糟糕的标签 而不是一个认证问题.
  • 使用 URL 前缀进行范围界定使其远离您其他的 GitHub 账户:仅 github.com/Fourier-Labs-AI/* 使用此证书.
  • 一个SSH insteadOf 重写是通常的建议,而且 这里不对 除非你们 SSH 密钥属于一个有 Fourier org 访问权限的账户. 检查 ssh -T [email protected] 在到达它之前.

  没有以上, go get 失败 Repository not found ——读作: 缺少标签, 而不是缺少访问权限 .

• {\FN华文楷体\FS16\1CHE0E0E0}TS: npm i @fourier-labs/harbour-contracts ——由CI从标签上发表. 手写AI政策解决器(resolver/index.ts(b) 与该船同装的船舶 @fourier-labs/harbour-contracts/resolver 子路径导出( n)package.json exports) (中文(简体) ).

页:1

gen.mjs 从节点生产两种语言。 走开 构建字段对齐 实值 (gofmt为通过 make fmt) ;这从未 影响编译,而 staleness gate 比较了原始生成器输出,所以保持绿色.