@ 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返回 aLoadResult; 解析 失败按消息形状分类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/domainforge0.22.2投影记录 它; 更新的解析器版本需要故意的适配器升级,而不是意外漂移. - 预测是只读数据。 这里没有执行模式、执行政策或赠款 权限 —— 它使语义可以参考.
- 错误分类匹配解析器的可读信件; 未识别失败
报告为
unknown与其文本而不是错误分类.
相关软件包
@godspeedai/domainforge- 那个 独立 domainForge 解析此适配器包 (在它自己的版本上被保存, 固定在此) .@godspeedai/cognate-kernel-api—— 说SemanticRef财务报告和审定财务报表CapabilityContract键入投影结果.@godspeedai/cognate-runtime-bun—— 说 引用约束能力的引用运行时间.@godspeedai/cognateSDK伞.
许可证
阿帕奇 - 2.0