@godspeedai/cognate-domainforge

中文文档
0.10.0发布于 2026/11/16Apache-2.0ES Module构建来源已验证近 30 天下载 3222

从DomainForge Graph输出到Cognate语义参考和只读语义预测(spec §7.1,§19)的版本被固定的适配器.

中文使用文档
文档目录7 节
  1. 安装
  2. 快开始
  3. 适配器在解析器上添加的内容
  4. 由世界组成的一体化
  5. 限制
  6. 相关软件包
  7. 许可证

@ godspideai/ cognate- domainforge (英语)

将DomainForge域模型转换为Cognate语义对象与能力. 这个软件包是 外部周围的版本固定适配器 @godspeedai/domainforge npm 软件包 (按 0.22.2),用于描述 .sea 域语言进入实体图, 资源、流动、关系、政策和衡量标准。 适配器将图形转换为 结晶 SemanticRefs 和只读 SemanticProjection,它是唯一支持的路径 从域模型到Cognate能力合同.

何时使用此软件包 : 您将您的域建模于 .sea 想要你的柯纳特 应用程序携带可核查出处的能力——每个能追踪的语义物体 重新命名从未悄悄地重新解开.

安装

bun add @godspeedai/cognate-domainforge

要求数 阿宝 >= 1.4.0. 外部解析器 @godspeedai/domainforge 时间 0.22.2 自动安装为固定的依赖关系 .sea 解析(包括其本土约束). SDK飞船Bun-native TypeScript源,所以 添加 @types/bun 财务报告和审定财务报表 @types/node 在检查您的工程时, 作为非依赖性 .

快开始

import {
  bindCapabilities,
  loadSemanticProjection,
  SemanticRegistry,
  serializeProjection,
} from "@godspeedai/cognate-domainforge";

const source = `
Entity "Warehouse" in logistics
Entity "Factory" in manufacturing
Resource "Cameras" units in equipment
Flow "Cameras" from "Warehouse" to "Factory" quantity 10
`;

const result = loadSemanticProjection(source, { uri: "file:///domain/logistics.sea" });
if (!result.ok) {
  // Never throws: failures come back typed as one of
  // "syntax" | "unresolved_reference" | "ambiguous_identity" | "binding_unavailable" | "unknown"
  console.error(result.error.kind, result.error);
} else {
  const projection = result.projection;
  projection.objects.map((o) => o.ref.id);
  // ["logistics::Warehouse", "manufacturing::Factory", "equipment::Cameras",
  //  "equipment::flow(equipment::Cameras|logistics::Warehouse|manufacturing::Factory)"]
  console.log(projection.source.digest); // sha256 of the exact source text

  // Canonical, deterministic serialization (stable key order) for storage or diffing:
  const canonical = serializeProjection(projection);

  // Resolve historical refs against exactly the projection they came from:
  const registry = new SemanticRegistry();
  registry.register(projection);
  const resolution = registry.resolve(projection.objects[0]!.ref);
  // { kind: "resolved", object, projection } — or { kind: "unresolved", ref, reason }
  // A rename does not resolve to the same-named object unless you record an explicit,
  // reviewed alias: registry.alias(oldRef, newRef, { reviewedBy: "...", meaningCheck: "..." });

  // The only path from a semantic object to a capability contract:
  const contracts = bindCapabilities(projection, [
    { semanticId: "logistics::Warehouse", capability: { id: "logistics.warehouse", version: "1.0.0", attributes: {} } },
  ]);
  contracts[0]!.semanticRef; // the provenance attached to the capability
}

适配器在解析器上添加的内容

  • 已经打过字,永远不扔了. loadSemanticProjection 返回 a LoadResult; 解析 失败按消息形状分类 syntax, (中文(简体) ), unresolved_reference, (中文(简体) ), ambiguous_identity, (中文(简体) ), binding_unavailable,或 unknown。 。 。 .
  • 稳定身份. 物体被识别为 namespace::name. 流动具有决定性 生成 id (namespace::flow(resource|from|to)),因为基础解析器指定 在每个剖面上流出新的随机编号;计算出的相撞表面为 ambiguous_identity 而不是沉默的合并.
  • 能力标本. bindCapabilities 丢入未知的语义标识并拒绝 绑定 Policy 目标——政策被引用的制约,从来就没有能力. 无约束对象无所出:无隐含能力.
  • 一个绘图表. mappingTable 记录,每个域名类型,是否为 支持,其框架视图、含义、基本性和源访问器. External 这是 一种不可操作( 它没有图表声明) .

由世界组成的一体化

与域名0.22.2, loadSemanticWorld({ entry, sources, worldName }) 通过 Graph.parseSourceMap,返回已核实的根 worldRef 财务报告和审定财务报表 DomainModelIdentity并创造对决心世界的支持。 使用此 API 而不是解析单个导入的文件 。 见 docs/how-to/load-a-composed-semantic-world.md。 。 。 .

限制

  • 绑入 @godspeedai/domainforge 0.22.2投影记录 它; 更新的解析器版本需要故意的适配器升级,而不是意外漂移.
  • 预测是只读数据。 这里没有执行模式、执行政策或赠款 权限 —— 它使语义可以参考.
  • 错误分类匹配解析器的可读信件; 未识别失败 报告为 unknown 与其文本而不是错误分类.

许可证

阿帕奇 - 2.0

版本与发布记录

@godspeedai/cognate-domainforge 共发布 20 个版本,首次发布于 2026/10/09;过去 12 个月发布了 20 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.10.0latest2026/11/16今天
0.9.22026/11/152 天前
0.9.12026/11/143 天前
0.9.02026/11/0610 天前
0.8.02026/10/2720 天前
0.7.12026/10/2523 天前

关于 @godspeedai/cognate-domainforge 的常见问题

@godspeedai/cognate-domainforge 是什么?

从DomainForge Graph输出到Cognate语义参考和只读语义预测(spec §7.1,§19)的版本被固定的适配器.

如何安装 @godspeedai/cognate-domainforge?

在项目目录运行 npm install @godspeedai/cognate-domainforge,或使用 pnpm add / yarn add / bun add。

@godspeedai/cognate-domainforge 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/godspeedai__cognate-domainforge 是否存在。

@godspeedai/cognate-domainforge 支持 ESM 还是 CommonJS?

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

@godspeedai/cognate-domainforge 可以商用吗?

@godspeedai/cognate-domainforge 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@godspeedai/cognate-domainforge 的下载量有多少?

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

@godspeedai/cognate-domainforge 还在维护吗?

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