@consiliency/contract

中文文档
0.6.5发布于 2026/07/09MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 1万

协和跨repo合同包:共享的JSON合同数据,符合矢量,薄npm/PyPI阅读器,以及Cononical html.v1公共合同表面.

中文使用文档

@ 和谐/ 合同

协和互换 合同包 —— 单一的,中立的规则书: agent-harness 财务报告和审定财务报表 governed-pipeline 销售商(由两个供应商拥有)。 它定义:

  • 页:1 .consiliency/ 布局 + 显示方案
  • 页:1 类型登记 —— 说 product 编号 : service 编号 : library 编号 : infra 编号 : tooling-meta 编号 : experiment 编号 : document,加上修改器(data-bearing 编号 : public 编号 : regulated 编号 : user-facing),与 baseline-only 作为法律声明
  • 每个类型(7个文件类)所需文件集
  • 界面声明计划(实现 + 承诺的交叉检索边缘)
  • 循环门协议(存在/新鲜度/完整性/版本-sew)
  • 页:1 canonical_html.v1 显示方案
  • 版本-sew 协议
  • + 治理范围(CS-0.12) ——通过简介(部分通过简介,不是布尔;其存在=同意受管)、受管设定逐项声明、默认被忽略设置的登记册和 present-nonconforming 编号 : foreign 编号 : unmanaged 治理标签
  • 租赁+收件箱协调(CS-0.10b) - 那个 lease (TTL + 心跳 + 自动过期, 软/ 硬, repo/ path- set/ symbol 范围), 仅附件 lease_event 流,该 lease_store 协议(唯一的真相来源)和 coordination_channel 收件箱协议( 从来没有权威性)
  • 预测发现 + git-rocade(切片 C0) - 那个 projections.index.v1 计划(确定性纯相聚指数的每颗卫星投影表,无) generated_at,所以每个驱动程序复制字节相同的条目 git_discipline_protocol (管道自备的参考课程、租赁+脚印、合并政策以及 从来没有 德莱特 -赫曼 -雷夫斯 以无常为规则 pipeline_ref_classes 两种登记时间都读取,以商定是否拥有所有权
  • 可互换性兼容性( X 切片) —— 说 scripts/interchangeability/run_driver_equivalence.py 证明上述纯合并索赔并不仅仅是这个包件本身的参考合并所声称的: projections-index-pure-merge-deterministic 矢量通过真实 spec-render/build_projections_index.py 生产者和声称的字节相同产出,实事求是(见 scripts/interchangeability/README.md(中文(简体) )
  • 合同核心(XG-1 Sice 1) - 单一的,加密的认证 authority_event_protocol.v1 计划与 核心/链签名拆分 (端口为独立槽签名) core; 光谱附件 chain 退出签名,永远不要重签),一 犬形字节算法 可在Node 20的无依赖性联合来文中执行(见 docs/design/authority-event-canonical-bytes.md),销售商的文摘标注 authority_key_registry.v1 Ed25519 信任根 (仅公用密钥),一个Ed25519在两个读取器中验证引用,以及13个符合矢量——一个在读取器和每个伪造类中都是有效的事件VERIFIES(不良/丢失的签名,未知/攻击者密钥 id,算法-拼接,签名者QQQapprover不匹配,被撤销/过期密钥,cert digest不匹配) REJECS
  • 认证标签镜(CS-1.4, XG-1 Slice 5) ——拆分单曲 certified 证据标签进入 parity-certified (字形可复制的等同证书,没有权威事件——今天的CS proj-S认证船)和 authority-certified (平等PLUS是经核实的、经人批准的权力机构活动——保留到XG-1权力机构循环土地到最终); certified 仅作为被腐烂的别名生存 parity-certified永远 authority-certified,因此,现有的生产者/消费者继续验证(见 docs/design/CS-1.4-certified-label-rescope.md(中文(简体) )

双重出版: 无 @consiliency/contract + 键 PyPI 密码 consiliency-contract,来自共享的 JSON 数据 + 符合向量,因此两种语言读取器保持字节-同.

现况 - 0.6.5 定义词条 protected_source_category 词汇表(协议的第一个生产者========= 两级计划:所需粗体 category (七个行刑流程桶 -- -- 之前存在的六加一新 governance_contracts 生产方桶 管理来源)加上可选的自由形式 subtype 携带 生产商的细颗粒. 这个 protected_source_categories 登记指针 粗矿、已注册的精矿和粗矿图 用于所有~14个受管管线细分类 protected_source_category 计划验证 a {category, subtype} 释相. SoT 定义仅- 添加剂, 无已存在的语义 变化; 受管管线和相位线在后期符合. 0.6.4 分配冻结的平价 certificate 计划 联合国 result-state $ref 关闭(从光谱显示的verbatim,消化器固定在 core/spec-parity/provenance.json因此,外部消费者(例如,绿地) XG-6)对照真实的等效证书计划进行验证,而不是手卷, repo自有的证明证书——只添加剂,没有现行化学语义变化. 0.6.0 将 certified 证据标签进入 parity-certified (byte-parity cert,没有权威事件——什么CS proj-). 页:1 (今天的认证船) authority-certified (平等PLUS a ) 经核实、经人批准的权威活动——保留至XG-1 权力循环土地端到端),保留 certified 作为被贬值的别名 联 合 国 parity-certified 只有,所以现有的生产者/消费者继续验证 (CS-1.4, XG-1 第5节;见 docs/design/CS-1.4-certified-label-rescope.md) (中文(简体) ). 0.5.1 将权威字节钉入光谱 罐核v2 (单位:千美元)canonical_bytes,而不是第4行——经证明的字节-同声+摘要固定在其中 core/authority-canon/provenance.json)并应用已结算的 XG-4 域分隔决定:Ed25519 签名涵盖当局概况 文摘预览 spec-canon:v2:authority\n ‖ canonical_bytes(core),趋同 改为零 当conon-core 添加配置时重新签名. 0.5.0 增加了XG-1 合同核心: authority_event_protocol.v1 计划(核心/链签分拆) authority_key_registry.v1 Ed25519 信任根, 犬形字节间距 算法 + Ed25519 在两个读取器中验证引用, 以及13个伪造 符合向量. 0.4.2 制作 projections.index.v1 人均到期上限 双侧: proj-code 是 [presence-only, hash-checked] 财务报告和审定财务报表 proj-S-certified 实值 [realized-edge-observed, certified] (倒置),替换 单侧 not:certified 警卫. 0.4.1 制作逐项条目(proj-code) 标出代码 + 事实; proj-S-certified 需求 source_S_digest, (中文(简体) ), (无事实/承诺). 0.4.0 添加 Slice C0 投影-发现+ 纪律合同projections.index.v1, (中文(简体) ), git_discipline_protocol, (中文(简体) ), pipeline_ref_classes在顶上 0.3.0 所需文件重新平衡, 页:1 0.2.0 CS-0.12 采用/治理范围 + CS-0.10b 租赁/插箱 协调,以及 0.1.0 阶段0L0内容. 共享的JSON数据生活在 core/ 财务报告和审定财务报表 conformance/; npm 和 PyPI 数据 读取器是故意在相同的字节上装入薄荷的.

阅读器 API

Java 脚本 :

import {
  CONTRACT,
  CONTRACT_VERSION,
  listVectors,
  loadContract,
  loadRegistry,
  loadSchema,
  loadVector,
  // authority-event core (XG-1 Slice 1)
  canonicalCoreBytes,
  verifyAuthorityEvent,
} from "@consiliency/contract";

Python : (中文(简体) )

from consiliency_contract import (
    CONTRACT,
    CONTRACT_VERSION,
    list_vectors,
    load_contract,
    load_registry,
    load_schema,
    load_vector,
)
# authority-event core (XG-1 Slice 1); needs the optional `authority` extra
# (cryptography) only for signature verification.
from consiliency_contract.authority import (
    canonical_core_bytes,
    verify_authority_event,
)

核查

npm test
python -m unittest discover -s tests -p 'test_*.py'
python -m build

版本与发布记录

@consiliency/contract 共发布 12 个版本,首次发布于 2026/07/02;过去 12 个月发布了 12 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.6.5latest2026/07/094 个月前
0.6.42026/07/094 个月前
0.6.32026/07/074 个月前
0.6.22026/07/074 个月前
0.6.12026/07/074 个月前
0.6.02026/07/064 个月前

关于 @consiliency/contract 的常见问题

@consiliency/contract 是什么?

协和跨repo合同包:共享的JSON合同数据,符合矢量,薄npm/PyPI阅读器,以及Cononical html.v1公共合同表面.

如何安装 @consiliency/contract?

在项目目录运行 npm install @consiliency/contract,或使用 pnpm add / yarn add / bun add。

@consiliency/contract 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@consiliency/contract 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@consiliency/contract 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@consiliency/contract 可以商用吗?

@consiliency/contract 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@consiliency/contract 的下载量有多少?

根据 npm 官方下载统计,@consiliency/contract 在 2026/10/11 – 2026/11/09 这 30 天内被下载 10,442 次,日均约 348 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@consiliency/contract 还在维护吗?

最新版本 0.6.5 发布于 2026/07/09(4 个月前);至今共发布 12 个版本,其中过去 12 个月发布了 12 个;首次发布于 2026/07/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。