domainforge 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (481) hide show
  1. package/.cargo/config.toml +6 -0
  2. package/.claude/settings.local.json +18 -0
  3. package/.coderabbit.yml +43 -0
  4. package/.codex/skills/release-management/SKILL.md +151 -0
  5. package/.codex/skills/release-management/agents/openai.yaml +4 -0
  6. package/.github/actions/decrypt-secrets/action.yml +121 -0
  7. package/.github/agents/Coder.agent.md +97 -0
  8. package/.github/agents/DeepResearch.agent.md +61 -0
  9. package/.github/chatmodes/tdd.vibepro.chatmode.md +1183 -0
  10. package/.github/copilot-instructions.md +13 -0
  11. package/.github/dependabot.yml +68 -0
  12. package/.github/workflows/README.md +165 -0
  13. package/.github/workflows/ci.yml +335 -0
  14. package/.github/workflows/dependabot-automerge.yml +114 -0
  15. package/.github/workflows/dependency-review.yml +27 -0
  16. package/.github/workflows/deploy.yml +87 -0
  17. package/.github/workflows/prepare-release.yml +168 -0
  18. package/.github/workflows/release-crates.yml +42 -0
  19. package/.github/workflows/release-npm.yml +137 -0
  20. package/.github/workflows/release-please.yml +29 -0
  21. package/.github/workflows/release-pypi.yml +96 -0
  22. package/.gitkeep +1 -0
  23. package/.release-please-manifest.json +5 -0
  24. package/.sea-registry.toml +10 -0
  25. package/.serena/project.yml +133 -0
  26. package/.sops.yaml +10 -0
  27. package/AGENTS.md +216 -0
  28. package/CHANGELOG.md +400 -0
  29. package/CLAUDE.md +62 -0
  30. package/CONTRIBUTING.md +323 -0
  31. package/Cargo.lock +3612 -0
  32. package/Cargo.toml +12 -0
  33. package/LICENSE +201 -0
  34. package/README.md +660 -0
  35. package/README_PYTHON.md +256 -0
  36. package/README_TYPESCRIPT.md +305 -0
  37. package/README_WASM.md +329 -0
  38. package/RELEASE_NOTES.md +41 -0
  39. package/bun.lock +378 -0
  40. package/bunfig.toml +11 -0
  41. package/check_output.txt +83 -0
  42. package/clippy_output.txt +80 -0
  43. package/commitlint.config.cjs +8 -0
  44. package/deny.toml +42 -0
  45. package/devbox.json +14 -0
  46. package/devbox.lock +76 -0
  47. package/docs/RELEASE_PROCESS.md +360 -0
  48. package/docs/diagnostics.md +161 -0
  49. package/docs/doc_guidelines.md +53 -0
  50. package/docs/explanations/README.md +21 -0
  51. package/docs/explanations/architecture-overview.md +109 -0
  52. package/docs/explanations/cross-language-binding-strategy.md +68 -0
  53. package/docs/explanations/graph-store-design.md +47 -0
  54. package/docs/explanations/performance-benchmarks.md +63 -0
  55. package/docs/explanations/policy-evaluation-logic.md +106 -0
  56. package/docs/explanations/semantic-modeling-concepts.md +109 -0
  57. package/docs/explanations/three-valued-logic.md +66 -0
  58. package/docs/explanations/versioning-strategy.md +45 -0
  59. package/docs/governance.md +168 -0
  60. package/docs/how-tos/README.md +46 -0
  61. package/docs/how-tos/ci-cd-validation.md +93 -0
  62. package/docs/how-tos/create-custom-units.md +125 -0
  63. package/docs/how-tos/define-policies.md +119 -0
  64. package/docs/how-tos/export-to-calm.md +110 -0
  65. package/docs/how-tos/export-to-protobuf.md +312 -0
  66. package/docs/how-tos/extend-grammar.md +133 -0
  67. package/docs/how-tos/generate-rdf-turtle.md +106 -0
  68. package/docs/how-tos/import-from-calm.md +114 -0
  69. package/docs/how-tos/import-from-sbvr.md +249 -0
  70. package/docs/how-tos/install-cli.md +126 -0
  71. package/docs/how-tos/parse-sea-files.md +132 -0
  72. package/docs/how-tos/policy-evaluation-modes.md +30 -0
  73. package/docs/how-tos/run-cross-language-tests.md +115 -0
  74. package/docs/how-tos/troubleshoot-napi-builds.md +55 -0
  75. package/docs/how-tos/use-modules-imports.md +285 -0
  76. package/docs/index.md +13 -0
  77. package/docs/plans/canonical-normalizer.md +121 -0
  78. package/docs/plans/cd_improvement.md +112 -0
  79. package/docs/plans/cli-ast.md +29 -0
  80. package/docs/plans/expression-bindings-and-normalizer-integration.md +174 -0
  81. package/docs/plans/protobuf_advanced_features_plan.md +597 -0
  82. package/docs/plans/protobuf_plan.yml +525 -0
  83. package/docs/plans/refactor_dsl_architecture.md +131 -0
  84. package/docs/plans/release-plan.md +163 -0
  85. package/docs/plans/sea_fmt_implementation_plan.md +516 -0
  86. package/docs/playbooks/README.md +18 -0
  87. package/docs/playbooks/adding-new-primitive.md +68 -0
  88. package/docs/playbooks/debugging-parser-failures.md +42 -0
  89. package/docs/playbooks/local-release-preparation.md +139 -0
  90. package/docs/playbooks/migrating-schema-versions.md +43 -0
  91. package/docs/playbooks/onboarding-contributors.md +64 -0
  92. package/docs/playbooks/releasing-beta.md +86 -0
  93. package/docs/playbooks/secret-management.md +64 -0
  94. package/docs/reference/README.md +199 -0
  95. package/docs/reference/ast-json-api.md +427 -0
  96. package/docs/reference/calm-mapping.md +519 -0
  97. package/docs/reference/cli-commands.md +588 -0
  98. package/docs/reference/configuration.md +202 -0
  99. package/docs/reference/error-codes.md +664 -0
  100. package/docs/reference/generated-artifacts-policy.md +53 -0
  101. package/docs/reference/grammar-spec.md +255 -0
  102. package/docs/reference/primitives-api.md +317 -0
  103. package/docs/reference/protobuf-api.md +426 -0
  104. package/docs/reference/python-api.md +485 -0
  105. package/docs/reference/registry.md +50 -0
  106. package/docs/reference/sea-dsl-ai-cheatsheet.yaml +913 -0
  107. package/docs/reference/security-model.md +74 -0
  108. package/docs/reference/typescript-api.md +508 -0
  109. package/docs/reference/wasm-api.md +420 -0
  110. package/docs/semantic-pack-review.md +144 -0
  111. package/docs/semantic-pack-signing.md +234 -0
  112. package/docs/semantic-packs.md +284 -0
  113. package/docs/specs/ADR-001-sea-dsl-semantic-source-of-truth.md +33 -0
  114. package/docs/specs/ADR-002-projection-first-class-construct.md +50 -0
  115. package/docs/specs/ADR-003-protobuf-projection-target.md +51 -0
  116. package/docs/specs/ADR-004-projection-compatibility-semantics.md +57 -0
  117. package/docs/specs/ADR-005-multi-language-support-strategy.md +112 -0
  118. package/docs/specs/ADR-006-error-handling-strategy.md +115 -0
  119. package/docs/specs/ADR-007-policy-evaluation-engine.md +95 -0
  120. package/docs/specs/ADR-008-knowledge-graph-integration.md +90 -0
  121. package/docs/specs/ADR-009-module-resolution-strategy.md +115 -0
  122. package/docs/specs/ADR-010-unit-system.md +106 -0
  123. package/docs/specs/PRD-001-sea-projection-framework.md +155 -0
  124. package/docs/specs/PRD-002-sea-cli-tooling.md +169 -0
  125. package/docs/specs/PRD-003-dsl-core-capabilities.md +275 -0
  126. package/docs/specs/README.md +62 -0
  127. package/docs/specs/SDS-001-protobuf-projection-engine.md +451 -0
  128. package/docs/specs/SDS-002-sea-core-architecture.md +268 -0
  129. package/docs/specs/SDS-003-parser-semantic-graph.md +377 -0
  130. package/docs/specs/SDS-004-policy-engine-design.md +362 -0
  131. package/docs/specs/SDS-005-knowledge-graph-module.md +364 -0
  132. package/docs/specs/SDS-006-calm-integration.md +367 -0
  133. package/docs/specs/SDS-007-sbvr-import.md +347 -0
  134. package/docs/templates/template_explanation.md +14 -0
  135. package/docs/templates/template_howto.md +21 -0
  136. package/docs/templates/template_playbook.md +21 -0
  137. package/docs/templates/template_reference.md +17 -0
  138. package/docs/templates/template_tutorial.md +24 -0
  139. package/docs/tutorials/README.md +12 -0
  140. package/docs/tutorials/first-sea-model.md +85 -0
  141. package/docs/tutorials/getting-started.md +98 -0
  142. package/docs/tutorials/python-binding-quickstart.md +107 -0
  143. package/docs/tutorials/typescript-binding-quickstart.md +91 -0
  144. package/docs/tutorials/wasm-in-browser.md +75 -0
  145. package/domainforge-core/CHANGELOG.md +138 -0
  146. package/domainforge-core/Cargo.toml +101 -0
  147. package/domainforge-core/MIGRATING.md +32 -0
  148. package/domainforge-core/README.md +197 -0
  149. package/domainforge-core/benchmark_results.txt +51 -0
  150. package/domainforge-core/build.rs +6 -0
  151. package/domainforge-core/deny.toml +31 -0
  152. package/domainforge-core/docs/specs/projections/sbvr_kg_mapping.md +43 -0
  153. package/domainforge-core/examples/basic.sea +7 -0
  154. package/domainforge-core/examples/cli/import_export_workflow.sh +38 -0
  155. package/domainforge-core/examples/cli/validate_example.sh +30 -0
  156. package/domainforge-core/examples/evolution_semantics.sea +31 -0
  157. package/domainforge-core/examples/parser_demo.rs +203 -0
  158. package/domainforge-core/grammar/sea.pest +408 -0
  159. package/domainforge-core/schemas/calm-v1.schema.json +170 -0
  160. package/domainforge-core/schemas/shacl/sea_shapes.ttl +19 -0
  161. package/domainforge-core/src/authority/compiler.rs +309 -0
  162. package/domainforge-core/src/authority/environment.rs +203 -0
  163. package/domainforge-core/src/authority/error.rs +164 -0
  164. package/domainforge-core/src/authority/fact_resolver.rs +224 -0
  165. package/domainforge-core/src/authority/mod.rs +25 -0
  166. package/domainforge-core/src/authority/pack.rs +133 -0
  167. package/domainforge-core/src/authority/policy.rs +224 -0
  168. package/domainforge-core/src/authority/resolver.rs +446 -0
  169. package/domainforge-core/src/authority/trace.rs +217 -0
  170. package/domainforge-core/src/authority/transform.rs +168 -0
  171. package/domainforge-core/src/authority/types.rs +617 -0
  172. package/domainforge-core/src/bin/domainforge.rs +25 -0
  173. package/domainforge-core/src/calm/export.rs +538 -0
  174. package/domainforge-core/src/calm/import.rs +1220 -0
  175. package/domainforge-core/src/calm/mod.rs +9 -0
  176. package/domainforge-core/src/calm/models.rs +108 -0
  177. package/domainforge-core/src/calm/sbvr_import.rs +9 -0
  178. package/domainforge-core/src/cli/authority.rs +149 -0
  179. package/domainforge-core/src/cli/format.rs +85 -0
  180. package/domainforge-core/src/cli/import.rs +133 -0
  181. package/domainforge-core/src/cli/mod.rs +64 -0
  182. package/domainforge-core/src/cli/normalize.rs +180 -0
  183. package/domainforge-core/src/cli/pack.rs +904 -0
  184. package/domainforge-core/src/cli/parse.rs +112 -0
  185. package/domainforge-core/src/cli/project.rs +294 -0
  186. package/domainforge-core/src/cli/registry.rs +41 -0
  187. package/domainforge-core/src/cli/test.rs +12 -0
  188. package/domainforge-core/src/cli/validate.rs +195 -0
  189. package/domainforge-core/src/cli/validate_kg.rs +80 -0
  190. package/domainforge-core/src/concept_id.rs +89 -0
  191. package/domainforge-core/src/error/diagnostics.rs +426 -0
  192. package/domainforge-core/src/error/fuzzy.rs +253 -0
  193. package/domainforge-core/src/error/mod.rs +13 -0
  194. package/domainforge-core/src/formatter/comments.rs +223 -0
  195. package/domainforge-core/src/formatter/config.rs +114 -0
  196. package/domainforge-core/src/formatter/mod.rs +22 -0
  197. package/domainforge-core/src/formatter/printer.rs +906 -0
  198. package/domainforge-core/src/graph/mod.rs +858 -0
  199. package/domainforge-core/src/graph/to_ast.rs +66 -0
  200. package/domainforge-core/src/kg.rs +1476 -0
  201. package/domainforge-core/src/kg_import.rs +251 -0
  202. package/domainforge-core/src/lib.rs +203 -0
  203. package/domainforge-core/src/module/mod.rs +1 -0
  204. package/domainforge-core/src/module/resolver.rs +260 -0
  205. package/domainforge-core/src/parser/ast.rs +2919 -0
  206. package/domainforge-core/src/parser/ast_convert.rs +494 -0
  207. package/domainforge-core/src/parser/ast_schema.rs +491 -0
  208. package/domainforge-core/src/parser/error.rs +291 -0
  209. package/domainforge-core/src/parser/lint.rs +39 -0
  210. package/domainforge-core/src/parser/mod.rs +193 -0
  211. package/domainforge-core/src/parser/printer.rs +702 -0
  212. package/domainforge-core/src/parser/profiles.rs +71 -0
  213. package/domainforge-core/src/parser/string_utils.rs +138 -0
  214. package/domainforge-core/src/patterns.rs +68 -0
  215. package/domainforge-core/src/policy/core.rs +1148 -0
  216. package/domainforge-core/src/policy/expression.rs +399 -0
  217. package/domainforge-core/src/policy/mod.rs +18 -0
  218. package/domainforge-core/src/policy/normalize.rs +1028 -0
  219. package/domainforge-core/src/policy/quantifier.rs +940 -0
  220. package/domainforge-core/src/policy/three_valued.rs +140 -0
  221. package/domainforge-core/src/policy/three_valued_microbench.rs +104 -0
  222. package/domainforge-core/src/policy/type_inference.rs +67 -0
  223. package/domainforge-core/src/policy/violation.rs +36 -0
  224. package/domainforge-core/src/primitives/concept_change.rs +61 -0
  225. package/domainforge-core/src/primitives/entity.rs +224 -0
  226. package/domainforge-core/src/primitives/flow.rs +111 -0
  227. package/domainforge-core/src/primitives/instance.rs +93 -0
  228. package/domainforge-core/src/primitives/mapping_contract.rs +50 -0
  229. package/domainforge-core/src/primitives/metric.rs +79 -0
  230. package/domainforge-core/src/primitives/mod.rs +25 -0
  231. package/domainforge-core/src/primitives/projection_contract.rs +50 -0
  232. package/domainforge-core/src/primitives/quantity.rs +56 -0
  233. package/domainforge-core/src/primitives/relation.rs +68 -0
  234. package/domainforge-core/src/primitives/resource.rs +237 -0
  235. package/domainforge-core/src/primitives/resource_instance.rs +88 -0
  236. package/domainforge-core/src/primitives/role.rs +49 -0
  237. package/domainforge-core/src/projection/buf.rs +404 -0
  238. package/domainforge-core/src/projection/contracts.rs +22 -0
  239. package/domainforge-core/src/projection/engine.rs +19 -0
  240. package/domainforge-core/src/projection/mod.rs +16 -0
  241. package/domainforge-core/src/projection/protobuf.rs +3331 -0
  242. package/domainforge-core/src/projection/registry.rs +43 -0
  243. package/domainforge-core/src/python/authority.rs +253 -0
  244. package/domainforge-core/src/python/error.rs +227 -0
  245. package/domainforge-core/src/python/formatter.rs +86 -0
  246. package/domainforge-core/src/python/graph.rs +366 -0
  247. package/domainforge-core/src/python/mod.rs +9 -0
  248. package/domainforge-core/src/python/policy.rs +651 -0
  249. package/domainforge-core/src/python/primitives.rs +796 -0
  250. package/domainforge-core/src/python/registry.rs +98 -0
  251. package/domainforge-core/src/python/semantic_pack.rs +619 -0
  252. package/domainforge-core/src/python/units.rs +96 -0
  253. package/domainforge-core/src/registry/mod.rs +432 -0
  254. package/domainforge-core/src/registry/tests.rs +210 -0
  255. package/domainforge-core/src/sbvr.rs +744 -0
  256. package/domainforge-core/src/semantic_pack/builder.rs +470 -0
  257. package/domainforge-core/src/semantic_pack/canonical_json.rs +184 -0
  258. package/domainforge-core/src/semantic_pack/diagnostics.rs +214 -0
  259. package/domainforge-core/src/semantic_pack/diff.rs +216 -0
  260. package/domainforge-core/src/semantic_pack/mod.rs +31 -0
  261. package/domainforge-core/src/semantic_pack/pack_set.rs +240 -0
  262. package/domainforge-core/src/semantic_pack/resolver.rs +437 -0
  263. package/domainforge-core/src/semantic_pack/review.rs +125 -0
  264. package/domainforge-core/src/semantic_pack/schema.rs +342 -0
  265. package/domainforge-core/src/semantic_pack/signing.rs +105 -0
  266. package/domainforge-core/src/semantic_pack/validator.rs +368 -0
  267. package/domainforge-core/src/semantic_version.rs +140 -0
  268. package/domainforge-core/src/test_utils.rs +12 -0
  269. package/domainforge-core/src/typescript/authority.rs +184 -0
  270. package/domainforge-core/src/typescript/error.rs +146 -0
  271. package/domainforge-core/src/typescript/formatter.rs +76 -0
  272. package/domainforge-core/src/typescript/graph.rs +391 -0
  273. package/domainforge-core/src/typescript/mod.rs +9 -0
  274. package/domainforge-core/src/typescript/policy.rs +564 -0
  275. package/domainforge-core/src/typescript/primitives.rs +784 -0
  276. package/domainforge-core/src/typescript/registry.rs +88 -0
  277. package/domainforge-core/src/typescript/semantic_pack.rs +470 -0
  278. package/domainforge-core/src/typescript/units.rs +76 -0
  279. package/domainforge-core/src/units/mod.rs +462 -0
  280. package/domainforge-core/src/uuid_module.rs +42 -0
  281. package/domainforge-core/src/validation_error.rs +818 -0
  282. package/domainforge-core/src/validation_result.rs +30 -0
  283. package/domainforge-core/src/wasm/authority.rs +192 -0
  284. package/domainforge-core/src/wasm/error.rs +145 -0
  285. package/domainforge-core/src/wasm/formatter.rs +69 -0
  286. package/domainforge-core/src/wasm/graph.rs +471 -0
  287. package/domainforge-core/src/wasm/mod.rs +16 -0
  288. package/domainforge-core/src/wasm/policy.rs +607 -0
  289. package/domainforge-core/src/wasm/primitives.rs +295 -0
  290. package/domainforge-core/src/wasm/semantic_pack.rs +471 -0
  291. package/domainforge-core/src/wasm/units.rs +62 -0
  292. package/domainforge-core/std/aws.sea +6 -0
  293. package/domainforge-core/std/core.sea +6 -0
  294. package/domainforge-core/std/http.sea +27 -0
  295. package/domainforge-core/tests/aggregation_enhanced_tests.rs +162 -0
  296. package/domainforge-core/tests/aggregation_eval_tests.rs +248 -0
  297. package/domainforge-core/tests/aggregation_integration_tests.rs +379 -0
  298. package/domainforge-core/tests/aggregation_parser_tests.rs +92 -0
  299. package/domainforge-core/tests/aggregation_tests.rs +102 -0
  300. package/domainforge-core/tests/authority_conformance_tests.rs +1173 -0
  301. package/domainforge-core/tests/calm_round_trip_tests.rs +283 -0
  302. package/domainforge-core/tests/calm_schema_validation_tests.rs +137 -0
  303. package/domainforge-core/tests/cast_operator_tests.rs +85 -0
  304. package/domainforge-core/tests/cli_binary_check.rs +37 -0
  305. package/domainforge-core/tests/cli_import_tests.rs +291 -0
  306. package/domainforge-core/tests/cli_path_traversal_tests.rs +124 -0
  307. package/domainforge-core/tests/cli_tests.rs +63 -0
  308. package/domainforge-core/tests/diagnostics_tests.rs +203 -0
  309. package/domainforge-core/tests/dimension_unit_tests.rs +80 -0
  310. package/domainforge-core/tests/entity_tests.rs +69 -0
  311. package/domainforge-core/tests/evolution_semantics_tests.rs +157 -0
  312. package/domainforge-core/tests/flow_tests.rs +78 -0
  313. package/domainforge-core/tests/flow_unit_validation_tests.rs +31 -0
  314. package/domainforge-core/tests/graph_integration_tests.rs +218 -0
  315. package/domainforge-core/tests/graph_tests.rs +626 -0
  316. package/domainforge-core/tests/import_parsing_tests.rs +23 -0
  317. package/domainforge-core/tests/instance_integration_tests.rs +98 -0
  318. package/domainforge-core/tests/instance_parsing_tests.rs +58 -0
  319. package/domainforge-core/tests/instance_tests.rs +61 -0
  320. package/domainforge-core/tests/kg_uri_encoding_tests.rs +53 -0
  321. package/domainforge-core/tests/lint_tests.rs +19 -0
  322. package/domainforge-core/tests/metric_tests.rs +143 -0
  323. package/domainforge-core/tests/module_resolution_tests.rs +100 -0
  324. package/domainforge-core/tests/namespace_registry_tests.rs +247 -0
  325. package/domainforge-core/tests/null_handling_tests.rs +26 -0
  326. package/domainforge-core/tests/parser_ast_v3.rs +53 -0
  327. package/domainforge-core/tests/parser_dimension_registry_tests.rs +20 -0
  328. package/domainforge-core/tests/parser_integration_tests.rs +294 -0
  329. package/domainforge-core/tests/parser_metadata_tests.rs +97 -0
  330. package/domainforge-core/tests/parser_resource_domain_only_graph_test.rs +21 -0
  331. package/domainforge-core/tests/parser_resource_limits_tests.rs +122 -0
  332. package/domainforge-core/tests/parser_tests.rs +512 -0
  333. package/domainforge-core/tests/pattern_semantics_tests.rs +87 -0
  334. package/domainforge-core/tests/phase_14_determinism_tests.rs +166 -0
  335. package/domainforge-core/tests/phase_15_validation_error_tests.rs +136 -0
  336. package/domainforge-core/tests/phase_16_unicode_tests.rs +248 -0
  337. package/domainforge-core/tests/phase_17_export_tests.rs +285 -0
  338. package/domainforge-core/tests/phase_17_round_trip_tests.rs +264 -0
  339. package/domainforge-core/tests/policy_tests.rs +635 -0
  340. package/domainforge-core/tests/primitives_integration_tests.rs +151 -0
  341. package/domainforge-core/tests/print_rdf_xml.rs +14 -0
  342. package/domainforge-core/tests/printer_tests.rs +204 -0
  343. package/domainforge-core/tests/profile_tests.rs +35 -0
  344. package/domainforge-core/tests/projection_contracts_tests.rs +154 -0
  345. package/domainforge-core/tests/protobuf_projection_tests.rs +199 -0
  346. package/domainforge-core/tests/quantity_tests.rs +41 -0
  347. package/domainforge-core/tests/rdf_xml_typed_literal_tests.rs +105 -0
  348. package/domainforge-core/tests/registry_schema_tests.rs +33 -0
  349. package/domainforge-core/tests/resource_tests.rs +50 -0
  350. package/domainforge-core/tests/resource_unit_tests.rs +24 -0
  351. package/domainforge-core/tests/roles_relations_tests.rs +61 -0
  352. package/domainforge-core/tests/round_trip_tests.rs +34 -0
  353. package/domainforge-core/tests/runtime_toggle_tests.rs +70 -0
  354. package/domainforge-core/tests/sbvr_fact_schema_tests.rs +60 -0
  355. package/domainforge-core/tests/sbvr_flow_facts_tests.rs +55 -0
  356. package/domainforge-core/tests/sbvr_parsing_tests.rs +53 -0
  357. package/domainforge-core/tests/semantic_pack_alias_resolution.rs +197 -0
  358. package/domainforge-core/tests/semantic_pack_build.rs +302 -0
  359. package/domainforge-core/tests/semantic_pack_consumer_smoke.rs +150 -0
  360. package/domainforge-core/tests/semantic_pack_pack_set.rs +160 -0
  361. package/domainforge-core/tests/semantic_pack_signing.rs +157 -0
  362. package/domainforge-core/tests/semantic_pack_three_valued.rs +250 -0
  363. package/domainforge-core/tests/semantic_pack_validate.rs +196 -0
  364. package/domainforge-core/tests/std_lib_tests.rs +37 -0
  365. package/domainforge-core/tests/temporal_evaluation_tests.rs +159 -0
  366. package/domainforge-core/tests/temporal_semantics_tests.rs +214 -0
  367. package/domainforge-core/tests/three_valued_quantifiers_tests.rs +164 -0
  368. package/domainforge-core/tests/turtle_entity_export_tests.rs +38 -0
  369. package/domainforge-core/tests/turtle_escaping_tests.rs +53 -0
  370. package/domainforge-core/tests/turtle_resource_export_tests.rs +34 -0
  371. package/domainforge-core/tests/type_inference_tests.rs +40 -0
  372. package/domainforge-core/tests/unicode_validation_tests.rs +169 -0
  373. package/domainforge-core/tests/unit_tests.rs +81 -0
  374. package/domainforge-core/tests/validate_tests.rs +38 -0
  375. package/domainforge-core/tests/validation_unit_mismatch_tests.rs +83 -0
  376. package/domainforge-core/tests/wasm_tests.rs +229 -0
  377. package/domainforge-python/CHANGELOG-python.md +12 -0
  378. package/domainforge-python/MIGRATING.md +24 -0
  379. package/domainforge-python/README.md +256 -0
  380. package/domainforge-python/domainforge/__init__.py +95 -0
  381. package/domainforge-python/domainforge/domainforge.pyi +519 -0
  382. package/domainforge-python/pyproject.toml +36 -0
  383. package/domainforge-typescript/CHANGELOG-typescript.md +12 -0
  384. package/domainforge-typescript/LICENSE +201 -0
  385. package/domainforge-typescript/MIGRATING.md +24 -0
  386. package/domainforge-typescript/README.md +305 -0
  387. package/domainforge-typescript/index.d.ts +452 -0
  388. package/domainforge-typescript/index.js +361 -0
  389. package/domainforge-typescript/package.json +60 -0
  390. package/example.js +61 -0
  391. package/examples/browser.html +366 -0
  392. package/examples/namespaces/finance/cashflow.sea +5 -0
  393. package/examples/namespaces/logistics/core.sea +7 -0
  394. package/examples/observability_metrics.sea +38 -0
  395. package/fixtures/semantic_packs/acme_procurement/domain/entities.sea +39 -0
  396. package/fixtures/semantic_packs/acme_procurement/domain/metrics.sea +11 -0
  397. package/fixtures/semantic_packs/acme_procurement/domain/relations.sea +7 -0
  398. package/fixtures/semantic_packs/acme_procurement/domain/resources.sea +9 -0
  399. package/fixtures/semantic_packs/acme_procurement/review/acme.procurement.semantic-review.jsonl +7 -0
  400. package/fixtures/semantic_packs/acme_procurement/tests/ambiguous_vendor_alias.sea +8 -0
  401. package/fixtures/semantic_packs/acme_procurement/tests/deprecated_vendor_alias.sea +8 -0
  402. package/fixtures/semantic_packs/acme_procurement/tests/invalid_relation.sea +3 -0
  403. package/fixtures/semantic_packs/acme_procurement/tests/proposed_concept.sea +8 -0
  404. package/fixtures/semantic_packs/acme_procurement/tests/rejected_concept.sea +8 -0
  405. package/fixtures/semantic_packs/acme_procurement/tests/unit_mismatch.sea +7 -0
  406. package/fixtures/semantic_packs/acme_procurement/tests/unknown_vendor_policy.sea +8 -0
  407. package/fixtures/semantic_packs/acme_procurement/tests/valid_purchase_policy.sea +8 -0
  408. package/index.d.ts +2 -0
  409. package/index.js +8 -0
  410. package/justfile +200 -0
  411. package/lefthook.yml +13 -0
  412. package/lib/validate_native_exports.d.ts +4 -0
  413. package/lib/validate_native_exports.js +12 -0
  414. package/package.json +22 -0
  415. package/pytest.ini +5 -0
  416. package/python/tests/test_registry.py +75 -0
  417. package/python/tests/test_units.py +18 -0
  418. package/release-please-config.json +49 -0
  419. package/requirements-dev.txt +3 -0
  420. package/requirements.txt +3 -0
  421. package/rust-toolchain.toml +3 -0
  422. package/schemas/ast-v1.schema.json +72 -0
  423. package/schemas/ast-v2.schema.json +1200 -0
  424. package/schemas/ast-v3.schema.json +1200 -0
  425. package/schemas/sea-registry.schema.json +45 -0
  426. package/scripts/build-python.sh +37 -0
  427. package/scripts/build-release.sh +279 -0
  428. package/scripts/build-typescript.sh +13 -0
  429. package/scripts/build-wasm.sh +113 -0
  430. package/scripts/bump-version.sh +245 -0
  431. package/scripts/check_unused_test_imports.py +85 -0
  432. package/scripts/ci_tasks.py +379 -0
  433. package/scripts/clear_debug_test.sh +10 -0
  434. package/scripts/create-github-release.sh +262 -0
  435. package/scripts/create-tag.sh +203 -0
  436. package/scripts/find_and_link_test_binary.sh +70 -0
  437. package/scripts/generate-changelog.sh +271 -0
  438. package/scripts/generate-release-notes.sh +205 -0
  439. package/scripts/lint_release_security.py +96 -0
  440. package/scripts/lint_release_workflows.py +82 -0
  441. package/scripts/lint_workflow_gates.py +113 -0
  442. package/scripts/optimized-wasm-build.sh +61 -0
  443. package/scripts/patch_napi_types.py +62 -0
  444. package/scripts/pre-release-check.sh +289 -0
  445. package/scripts/prepare_rust_debug.sh +52 -0
  446. package/scripts/release.sh +373 -0
  447. package/scripts/resolve_rust_binary.py +230 -0
  448. package/scripts/run_commitlint.sh +29 -0
  449. package/scripts/test-all.sh +77 -0
  450. package/scripts/update_launch_program.py +93 -0
  451. package/secrets/README.md +27 -0
  452. package/secrets/secrets.yaml +21 -0
  453. package/test_integration.py +67 -0
  454. package/tests/test_authority.py +328 -0
  455. package/tests/test_ci_tasks.py +143 -0
  456. package/tests/test_expression.py +256 -0
  457. package/tests/test_golden_payment_flow.py +42 -0
  458. package/tests/test_graph.py +127 -0
  459. package/tests/test_instance.py +136 -0
  460. package/tests/test_parser.py +82 -0
  461. package/tests/test_primitives.py +68 -0
  462. package/tests/test_role_relation_parity.py +56 -0
  463. package/tests/test_runtime_toggle.py +156 -0
  464. package/tests/test_semantic_pack.py +639 -0
  465. package/tests/test_three_valued_eval.py +159 -0
  466. package/tsconfig.json +30 -0
  467. package/typescript-tests/advanced.test.ts +165 -0
  468. package/typescript-tests/authority.test.ts +216 -0
  469. package/typescript-tests/expression.test.ts +228 -0
  470. package/typescript-tests/golden-payment-flow.test.ts +51 -0
  471. package/typescript-tests/graph.test.ts +142 -0
  472. package/typescript-tests/native-binding.test.ts +20 -0
  473. package/typescript-tests/primitives.test.ts +88 -0
  474. package/typescript-tests/registry.test.ts +122 -0
  475. package/typescript-tests/role_relation.test.ts +63 -0
  476. package/typescript-tests/runtime_toggle.test.ts +141 -0
  477. package/typescript-tests/semantic-pack.test.ts +556 -0
  478. package/typescript-tests/three_valued_eval.test.ts +135 -0
  479. package/typescript-tests/units.test.ts +36 -0
  480. package/vitest.config.ts +13 -0
  481. package/wasm_demo.html +225 -0
@@ -0,0 +1,744 @@
1
+ use crate::graph::Graph;
2
+ use serde::{Deserialize, Serialize};
3
+ use std::collections::HashSet;
4
+
5
+ #[derive(Debug, Clone)]
6
+ pub enum SbvrError {
7
+ SerializationError(String),
8
+ UnsupportedConstruct(String),
9
+ }
10
+
11
+ impl std::fmt::Display for SbvrError {
12
+ fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
13
+ match self {
14
+ SbvrError::SerializationError(msg) => write!(f, "SBVR serialization error: {}", msg),
15
+ SbvrError::UnsupportedConstruct(msg) => write!(f, "Unsupported construct: {}", msg),
16
+ }
17
+ }
18
+ }
19
+
20
+ impl std::error::Error for SbvrError {}
21
+
22
+ #[derive(Debug, Clone, Serialize, Deserialize)]
23
+ pub struct SbvrTerm {
24
+ pub id: String,
25
+ pub name: String,
26
+ pub term_type: TermType,
27
+ pub definition: Option<String>,
28
+ }
29
+
30
+ #[derive(Debug, Clone, Serialize, Deserialize)]
31
+ pub enum TermType {
32
+ GeneralConcept,
33
+ IndividualConcept,
34
+ VerbConcept,
35
+ }
36
+
37
+ #[derive(Debug, Clone, Serialize, Deserialize)]
38
+ pub struct SbvrFactType {
39
+ pub id: String,
40
+ pub subject: String,
41
+ pub verb: String,
42
+ pub object: String,
43
+ #[serde(default)]
44
+ pub destination: Option<String>,
45
+ #[serde(default = "SbvrFactType::default_schema_version")]
46
+ pub schema_version: String,
47
+ }
48
+
49
+ impl SbvrFactType {
50
+ pub fn default_schema_version() -> String {
51
+ "2.0".to_string()
52
+ }
53
+ }
54
+
55
+ #[derive(Debug, Clone, Serialize, Deserialize)]
56
+ pub struct SbvrBusinessRule {
57
+ pub id: String,
58
+ pub name: String,
59
+ pub rule_type: RuleType,
60
+ pub expression: String,
61
+ pub severity: String,
62
+ #[serde(default)]
63
+ pub priority: Option<u8>,
64
+ }
65
+
66
+ #[derive(Debug, Clone, Serialize, Deserialize)]
67
+ pub enum RuleType {
68
+ Obligation,
69
+ Prohibition,
70
+ Permission,
71
+ Derivation,
72
+ }
73
+
74
+ #[derive(Debug, Clone, Serialize, Deserialize)]
75
+ pub struct SbvrModel {
76
+ pub vocabulary: Vec<SbvrTerm>,
77
+ pub facts: Vec<SbvrFactType>,
78
+ pub rules: Vec<SbvrBusinessRule>,
79
+ }
80
+
81
+ impl SbvrModel {
82
+ pub fn new() -> Self {
83
+ Self {
84
+ vocabulary: Vec::new(),
85
+ facts: Vec::new(),
86
+ rules: Vec::new(),
87
+ }
88
+ }
89
+
90
+ pub fn from_graph(graph: &Graph) -> Result<Self, SbvrError> {
91
+ let mut model = Self::new();
92
+ let mut relation_predicates: HashSet<String> = HashSet::new();
93
+
94
+ for entity in graph.all_entities() {
95
+ model.vocabulary.push(SbvrTerm {
96
+ id: entity.id().to_string(),
97
+ name: entity.name().to_string(),
98
+ term_type: TermType::GeneralConcept,
99
+ definition: Some(format!("Entity: {}", entity.name())),
100
+ });
101
+ }
102
+
103
+ for role in graph.all_roles() {
104
+ model.vocabulary.push(SbvrTerm {
105
+ id: role.id().to_string(),
106
+ name: role.name().to_string(),
107
+ term_type: TermType::GeneralConcept,
108
+ definition: Some(format!("Role: {}", role.name())),
109
+ });
110
+ }
111
+
112
+ for resource in graph.all_resources() {
113
+ model.vocabulary.push(SbvrTerm {
114
+ id: resource.id().to_string(),
115
+ name: resource.name().to_string(),
116
+ term_type: TermType::IndividualConcept,
117
+ definition: Some(format!(
118
+ "Resource: {} ({})",
119
+ resource.name(),
120
+ resource.unit()
121
+ )),
122
+ });
123
+ }
124
+
125
+ for pattern in graph.all_patterns() {
126
+ model.vocabulary.push(SbvrTerm {
127
+ id: pattern.id().to_string(),
128
+ name: pattern.name().to_string(),
129
+ term_type: TermType::IndividualConcept,
130
+ definition: Some(format!(
131
+ "Pattern '{}' matches {}",
132
+ pattern.name(),
133
+ pattern.regex()
134
+ )),
135
+ });
136
+ }
137
+
138
+ model.vocabulary.push(SbvrTerm {
139
+ id: "verb:transfers".to_string(),
140
+ name: "transfers".to_string(),
141
+ term_type: TermType::VerbConcept,
142
+ definition: Some("Transfer of resource between entities".to_string()),
143
+ });
144
+
145
+ for relation in graph.all_relations() {
146
+ if relation_predicates.insert(relation.predicate().to_string()) {
147
+ model.vocabulary.push(SbvrTerm {
148
+ id: format!("verb:{}", relation.predicate()),
149
+ name: relation.predicate().to_string(),
150
+ term_type: TermType::VerbConcept,
151
+ definition: Some(format!(
152
+ "Fact type predicate '{}' connecting declared roles",
153
+ relation.predicate()
154
+ )),
155
+ });
156
+ }
157
+
158
+ model.facts.push(SbvrFactType {
159
+ id: relation.id().to_string(),
160
+ subject: graph
161
+ .get_role(relation.subject_role())
162
+ .map(|role| role.name().to_string())
163
+ .unwrap_or_else(|| relation.subject_role().to_string()),
164
+ verb: relation.predicate().to_string(),
165
+ object: graph
166
+ .get_role(relation.object_role())
167
+ .map(|role| role.name().to_string())
168
+ .unwrap_or_else(|| relation.object_role().to_string()),
169
+ destination: relation.via_flow().map(|id| {
170
+ graph
171
+ .get_resource(id)
172
+ .map(|resource| resource.name().to_string())
173
+ .unwrap_or_else(|| id.to_string())
174
+ }),
175
+ schema_version: SbvrFactType::default_schema_version(),
176
+ });
177
+ }
178
+
179
+ for flow in graph.all_flows() {
180
+ model.facts.push(SbvrFactType {
181
+ id: flow.id().to_string(),
182
+ subject: flow.from_id().to_string(),
183
+ verb: "transfers".to_string(),
184
+ object: flow.resource_id().to_string(),
185
+ destination: Some(flow.to_id().to_string()),
186
+ schema_version: SbvrFactType::default_schema_version(),
187
+ });
188
+ }
189
+
190
+ Ok(model)
191
+ }
192
+
193
+ pub fn to_xmi(&self) -> Result<String, SbvrError> {
194
+ let mut xmi = String::new();
195
+
196
+ xmi.push_str("<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n");
197
+ xmi.push_str("<xmi:XMI xmlns:xmi=\"http://www.omg.org/XMI\" xmlns:sbvr=\"http://www.omg.org/spec/SBVR/20080801\">\n");
198
+ xmi.push_str(" <sbvr:Vocabulary name=\"SEA_Model\">\n");
199
+
200
+ for term in &self.vocabulary {
201
+ match term.term_type {
202
+ TermType::GeneralConcept => {
203
+ xmi.push_str(&format!(
204
+ " <sbvr:GeneralConcept id=\"{}\" name=\"{}\">\n",
205
+ Self::escape_xml(&term.id),
206
+ Self::escape_xml(&term.name)
207
+ ));
208
+ if let Some(def) = &term.definition {
209
+ xmi.push_str(&format!(
210
+ " <sbvr:Definition>{}</sbvr:Definition>\n",
211
+ Self::escape_xml(def)
212
+ ));
213
+ }
214
+ xmi.push_str(" </sbvr:GeneralConcept>\n");
215
+ }
216
+ TermType::IndividualConcept => {
217
+ xmi.push_str(&format!(
218
+ " <sbvr:IndividualConcept id=\"{}\" name=\"{}\">\n",
219
+ Self::escape_xml(&term.id),
220
+ Self::escape_xml(&term.name)
221
+ ));
222
+ if let Some(def) = &term.definition {
223
+ xmi.push_str(&format!(
224
+ " <sbvr:Definition>{}</sbvr:Definition>\n",
225
+ Self::escape_xml(def)
226
+ ));
227
+ }
228
+ xmi.push_str(" </sbvr:IndividualConcept>\n");
229
+ }
230
+ TermType::VerbConcept => {
231
+ xmi.push_str(&format!(
232
+ " <sbvr:VerbConcept id=\"{}\" name=\"{}\">\n",
233
+ Self::escape_xml(&term.id),
234
+ Self::escape_xml(&term.name)
235
+ ));
236
+ if let Some(def) = &term.definition {
237
+ xmi.push_str(&format!(
238
+ " <sbvr:Definition>{}</sbvr:Definition>\n",
239
+ Self::escape_xml(def)
240
+ ));
241
+ }
242
+ xmi.push_str(" </sbvr:VerbConcept>\n");
243
+ }
244
+ }
245
+ }
246
+
247
+ for fact in &self.facts {
248
+ xmi.push_str(&format!(
249
+ " <sbvr:FactType id=\"{}\">\n",
250
+ Self::escape_xml(&fact.id)
251
+ ));
252
+ xmi.push_str(&format!(
253
+ " <sbvr:SchemaVersion>{}</sbvr:SchemaVersion>\n",
254
+ Self::escape_xml(&fact.schema_version)
255
+ ));
256
+ xmi.push_str(&format!(
257
+ " <sbvr:Subject>{}</sbvr:Subject>\n",
258
+ Self::escape_xml(&fact.subject)
259
+ ));
260
+ xmi.push_str(&format!(
261
+ " <sbvr:Verb>{}</sbvr:Verb>\n",
262
+ Self::escape_xml(&fact.verb)
263
+ ));
264
+ xmi.push_str(&format!(
265
+ " <sbvr:Object>{}</sbvr:Object>\n",
266
+ Self::escape_xml(&fact.object)
267
+ ));
268
+ if let Some(dest) = &fact.destination {
269
+ xmi.push_str(&format!(
270
+ " <sbvr:Destination>{}</sbvr:Destination>\n",
271
+ Self::escape_xml(dest)
272
+ ));
273
+ }
274
+ xmi.push_str(" </sbvr:FactType>\n");
275
+ }
276
+
277
+ for rule in &self.rules {
278
+ let rule_element = match rule.rule_type {
279
+ RuleType::Obligation => "Obligation",
280
+ RuleType::Prohibition => "Prohibition",
281
+ RuleType::Permission => "Permission",
282
+ RuleType::Derivation => "Derivation",
283
+ };
284
+
285
+ xmi.push_str(&format!(
286
+ " <sbvr:{} id=\"{}\" name=\"{}\">\n",
287
+ rule_element,
288
+ Self::escape_xml(&rule.id),
289
+ Self::escape_xml(&rule.name)
290
+ ));
291
+ xmi.push_str(&format!(
292
+ " <sbvr:Expression>{}</sbvr:Expression>\n",
293
+ Self::escape_xml(&rule.expression)
294
+ ));
295
+ xmi.push_str(&format!(
296
+ " <sbvr:Severity>{}</sbvr:Severity>\n",
297
+ Self::escape_xml(&rule.severity)
298
+ ));
299
+ if let Some(p) = rule.priority {
300
+ xmi.push_str(&format!(" <sbvr:Priority>{}</sbvr:Priority>\n", p));
301
+ }
302
+ xmi.push_str(&format!(" </sbvr:{}>\n", rule_element));
303
+ }
304
+
305
+ xmi.push_str(" </sbvr:Vocabulary>\n");
306
+ xmi.push_str("</xmi:XMI>\n");
307
+
308
+ Ok(xmi)
309
+ }
310
+
311
+ fn escape_xml(s: &str) -> String {
312
+ s.replace('&', "&amp;")
313
+ .replace('<', "&lt;")
314
+ .replace('>', "&gt;")
315
+ .replace('"', "&quot;")
316
+ .replace('\'', "&apos;")
317
+ }
318
+
319
+ /// Parse an SBVR XMI document and return a SbvrModel
320
+ pub fn from_xmi(xmi: &str) -> Result<Self, SbvrError> {
321
+ let doc = roxmltree::Document::parse(xmi)
322
+ .map_err(|e| SbvrError::SerializationError(format!("Failed to parse XMI: {}", e)))?;
323
+
324
+ let mut model = SbvrModel::new();
325
+
326
+ // Find vocabulary node
327
+ for node in doc.descendants() {
328
+ if node.has_tag_name("GeneralConcept") {
329
+ let id = node.attribute("id").unwrap_or_default().to_string();
330
+ let name = node.attribute("name").unwrap_or_default().to_string();
331
+ let mut definition = None;
332
+ for child in node.children() {
333
+ if child.has_tag_name("Definition") {
334
+ definition = Some(child.text().unwrap_or_default().to_string());
335
+ }
336
+ }
337
+ model.vocabulary.push(SbvrTerm {
338
+ id,
339
+ name,
340
+ term_type: TermType::GeneralConcept,
341
+ definition,
342
+ });
343
+ }
344
+
345
+ if node.has_tag_name("IndividualConcept") {
346
+ let id = node.attribute("id").unwrap_or_default().to_string();
347
+ let name = node.attribute("name").unwrap_or_default().to_string();
348
+ let mut definition = None;
349
+ for child in node.children() {
350
+ if child.has_tag_name("Definition") {
351
+ definition = Some(child.text().unwrap_or_default().to_string());
352
+ }
353
+ }
354
+ model.vocabulary.push(SbvrTerm {
355
+ id,
356
+ name,
357
+ term_type: TermType::IndividualConcept,
358
+ definition,
359
+ });
360
+ }
361
+
362
+ if node.has_tag_name("VerbConcept") {
363
+ let id = node.attribute("id").unwrap_or_default().to_string();
364
+ let name = node.attribute("name").unwrap_or_default().to_string();
365
+ let mut definition = None;
366
+ for child in node.children() {
367
+ if child.has_tag_name("Definition") {
368
+ definition = Some(child.text().unwrap_or_default().to_string());
369
+ }
370
+ }
371
+ model.vocabulary.push(SbvrTerm {
372
+ id,
373
+ name,
374
+ term_type: TermType::VerbConcept,
375
+ definition,
376
+ });
377
+ }
378
+
379
+ if node.has_tag_name("FactType") {
380
+ let id = node.attribute("id").unwrap_or_default().to_string();
381
+ let mut subject = String::new();
382
+ let mut verb = String::new();
383
+ let mut object = String::new();
384
+ let mut destination = None;
385
+ let mut schema_version = SbvrFactType::default_schema_version();
386
+
387
+ for child in node.children() {
388
+ if child.has_tag_name("SchemaVersion") {
389
+ schema_version = child.text().unwrap_or_default().to_string();
390
+ }
391
+ if child.has_tag_name("Subject") {
392
+ subject = child.text().unwrap_or_default().to_string();
393
+ }
394
+ if child.has_tag_name("Verb") {
395
+ verb = child.text().unwrap_or_default().to_string();
396
+ }
397
+ if child.has_tag_name("Object") {
398
+ object = child.text().unwrap_or_default().to_string();
399
+ }
400
+ if child.has_tag_name("Destination") {
401
+ destination = Some(child.text().unwrap_or_default().to_string());
402
+ }
403
+ }
404
+
405
+ model.facts.push(SbvrFactType {
406
+ id,
407
+ subject,
408
+ verb,
409
+ object,
410
+ destination,
411
+ schema_version,
412
+ });
413
+ }
414
+
415
+ // Parse basic rules (Obligation/Prohibition/Permission/Derivation)
416
+ if node.has_tag_name("Obligation")
417
+ || node.has_tag_name("Prohibition")
418
+ || node.has_tag_name("Permission")
419
+ || node.has_tag_name("Derivation")
420
+ {
421
+ let id = node.attribute("id").unwrap_or_default().to_string();
422
+ let name = node.attribute("name").unwrap_or_default().to_string();
423
+ let kind = if node.has_tag_name("Obligation") {
424
+ RuleType::Obligation
425
+ } else if node.has_tag_name("Prohibition") {
426
+ RuleType::Prohibition
427
+ } else if node.has_tag_name("Permission") {
428
+ RuleType::Permission
429
+ } else {
430
+ RuleType::Derivation
431
+ };
432
+ let mut expression = String::new();
433
+ let mut severity = String::from("Info");
434
+ let mut parsed_priority: Option<u8> = None;
435
+ for child in node.children() {
436
+ if child.has_tag_name("Expression") {
437
+ expression = child.text().unwrap_or_default().to_string();
438
+ }
439
+ if child.has_tag_name("Severity") {
440
+ severity = child.text().unwrap_or_default().to_string();
441
+ }
442
+ if child.has_tag_name("Priority") {
443
+ if let Some(text) = child.text() {
444
+ if let Ok(value) = text.trim().parse::<u8>() {
445
+ parsed_priority = Some(value);
446
+ }
447
+ }
448
+ }
449
+ }
450
+ let mut rule = SbvrBusinessRule {
451
+ id,
452
+ name,
453
+ rule_type: kind,
454
+ expression,
455
+ severity,
456
+ priority: parsed_priority,
457
+ };
458
+ if rule.priority.is_none() {
459
+ rule.priority = Some(match rule.rule_type {
460
+ RuleType::Obligation => 5,
461
+ RuleType::Prohibition => 5,
462
+ RuleType::Permission => 1,
463
+ RuleType::Derivation => 3,
464
+ });
465
+ }
466
+ model.rules.push(rule);
467
+ }
468
+ }
469
+
470
+ Ok(model)
471
+ }
472
+
473
+ /// Convert parsed SbvrModel into a Graph
474
+ pub fn to_graph(&self) -> Result<crate::graph::Graph, SbvrError> {
475
+ use crate::graph::Graph;
476
+ use crate::primitives::{Entity, Flow, Resource};
477
+ use crate::units::unit_from_string;
478
+ use rust_decimal::Decimal;
479
+
480
+ let mut graph = Graph::new();
481
+
482
+ // Create vocabulary terms first
483
+ for term in &self.vocabulary {
484
+ match term.term_type {
485
+ TermType::GeneralConcept => {
486
+ let entity =
487
+ Entity::new_with_namespace(term.name.clone(), "default".to_string());
488
+ graph
489
+ .add_entity(entity)
490
+ .map_err(SbvrError::SerializationError)?;
491
+ }
492
+ TermType::IndividualConcept => {
493
+ let unit_symbol = term.definition.as_deref().and_then(|def| {
494
+ if let Some(open) = def.rfind('(') {
495
+ if let Some(close_offset) = def[open..].find(')') {
496
+ let close = open + close_offset;
497
+ let candidate = def[open + 1..close].trim();
498
+ if !candidate.is_empty() {
499
+ return Some(candidate.to_string());
500
+ }
501
+ }
502
+ }
503
+ None
504
+ });
505
+ let unit_symbol = unit_symbol.unwrap_or_else(|| {
506
+ // SBVR definitions currently omit explicit unit metadata, so default to "units".
507
+ // Extend the SBVR model if richer unit information becomes available.
508
+ "units".to_string()
509
+ });
510
+ let res = Resource::new_with_namespace(
511
+ term.name.clone(),
512
+ unit_from_string(&unit_symbol),
513
+ "default".to_string(),
514
+ );
515
+ graph
516
+ .add_resource(res)
517
+ .map_err(SbvrError::SerializationError)?;
518
+ }
519
+ TermType::VerbConcept => {
520
+ // We don't represent verbs directly as primitives
521
+ }
522
+ }
523
+ }
524
+
525
+ // Now create flows
526
+ for fact in &self.facts {
527
+ // find subject (entity)
528
+ let subject_name = self
529
+ .vocabulary
530
+ .iter()
531
+ .find(|t| t.id == fact.subject)
532
+ .map(|t| t.name.clone())
533
+ .unwrap_or(fact.subject.clone());
534
+
535
+ let object_name = self
536
+ .vocabulary
537
+ .iter()
538
+ .find(|t| t.id == fact.object)
539
+ .map(|t| t.name.clone())
540
+ .unwrap_or(fact.object.clone());
541
+
542
+ let destination_name = fact
543
+ .destination
544
+ .clone()
545
+ .and_then(|d| {
546
+ self.vocabulary
547
+ .iter()
548
+ .find(|t| t.id == d)
549
+ .map(|t| t.name.clone())
550
+ })
551
+ .unwrap_or_default();
552
+
553
+ let subject_id = graph.find_entity_by_name(&subject_name).ok_or_else(|| {
554
+ SbvrError::UnsupportedConstruct(format!("Unknown subject entity: {}", subject_name))
555
+ })?;
556
+
557
+ let destination_id = graph
558
+ .find_entity_by_name(&destination_name)
559
+ .ok_or_else(|| {
560
+ SbvrError::UnsupportedConstruct(format!(
561
+ "Unknown destination entity: {}",
562
+ destination_name
563
+ ))
564
+ })?;
565
+
566
+ let resource_id = graph.find_resource_by_name(&object_name).ok_or_else(|| {
567
+ SbvrError::UnsupportedConstruct(format!("Unknown resource: {}", object_name))
568
+ })?;
569
+
570
+ // SBVR FactType does not expose an explicit quantity, so default flows to 1.
571
+ // This is intentional until the SBVR model is extended with quantity metadata.
572
+ let quantity = Decimal::from(1);
573
+
574
+ let flow = Flow::new(resource_id, subject_id, destination_id, quantity);
575
+ graph
576
+ .add_flow(flow)
577
+ .map_err(SbvrError::SerializationError)?;
578
+ }
579
+
580
+ // Map SBVR Business Rules into Graph Policies
581
+ for rule in &self.rules {
582
+ // Parse expression using SEA DSL expression parser
583
+ let expr = crate::parser::parse_expression_from_str(rule.expression.as_str()).map_err(
584
+ |e| {
585
+ SbvrError::SerializationError(format!("Failed to parse rule expression: {}", e))
586
+ },
587
+ )?;
588
+
589
+ let mut policy = crate::policy::Policy::new_with_namespace(
590
+ rule.name.clone(),
591
+ "default".to_string(),
592
+ expr,
593
+ );
594
+
595
+ // Map rule type to modality/kind
596
+ match rule.rule_type {
597
+ RuleType::Obligation => {
598
+ policy = policy.with_modality(crate::policy::PolicyModality::Obligation);
599
+ policy = policy.with_kind(crate::policy::PolicyKind::Constraint);
600
+ }
601
+ RuleType::Prohibition => {
602
+ policy = policy.with_modality(crate::policy::PolicyModality::Prohibition);
603
+ policy = policy.with_kind(crate::policy::PolicyKind::Constraint);
604
+ }
605
+ RuleType::Permission => {
606
+ policy = policy.with_modality(crate::policy::PolicyModality::Permission);
607
+ policy = policy.with_kind(crate::policy::PolicyKind::Constraint);
608
+ }
609
+ RuleType::Derivation => {
610
+ policy = policy.with_modality(crate::policy::PolicyModality::Permission);
611
+ policy = policy.with_kind(crate::policy::PolicyKind::Derivation);
612
+ }
613
+ }
614
+
615
+ // Priority mapping
616
+ if let Some(p) = rule.priority {
617
+ policy = policy.with_priority(p as i32);
618
+ } else {
619
+ // Default based on rule type
620
+ let default_p = match rule.rule_type {
621
+ RuleType::Obligation => 5,
622
+ RuleType::Prohibition => 5,
623
+ RuleType::Permission => 1,
624
+ RuleType::Derivation => 3,
625
+ };
626
+ policy = policy.with_priority(default_p);
627
+ }
628
+
629
+ graph
630
+ .add_policy(policy)
631
+ .map_err(SbvrError::SerializationError)?;
632
+ }
633
+
634
+ Ok(graph)
635
+ }
636
+ }
637
+
638
+ impl Default for SbvrModel {
639
+ fn default() -> Self {
640
+ Self::new()
641
+ }
642
+ }
643
+
644
+ impl Graph {
645
+ pub fn export_sbvr(&self) -> Result<String, SbvrError> {
646
+ let model = SbvrModel::from_graph(self)?;
647
+ model.to_xmi()
648
+ }
649
+ }
650
+
651
+ #[cfg(test)]
652
+ mod tests {
653
+ use super::*;
654
+ use crate::primitives::{Entity, Flow, Resource};
655
+ use rust_decimal::Decimal;
656
+
657
+ #[test]
658
+ fn test_sbvr_model_creation() {
659
+ let model = SbvrModel::new();
660
+ assert_eq!(model.vocabulary.len(), 0);
661
+ assert_eq!(model.facts.len(), 0);
662
+ assert_eq!(model.rules.len(), 0);
663
+ }
664
+
665
+ #[test]
666
+ fn test_export_to_sbvr() {
667
+ let mut graph = Graph::new();
668
+
669
+ let entity1 = Entity::new_with_namespace("Supplier", "supply_chain");
670
+ let entity2 = Entity::new_with_namespace("Manufacturer", "supply_chain");
671
+ let resource = Resource::new_with_namespace(
672
+ "Parts",
673
+ crate::units::unit_from_string("kg"),
674
+ "supply_chain",
675
+ );
676
+
677
+ let entity1_id = entity1.id().clone();
678
+ let entity2_id = entity2.id().clone();
679
+ let resource_id = resource.id().clone();
680
+
681
+ graph.add_entity(entity1).unwrap();
682
+ graph.add_entity(entity2).unwrap();
683
+ graph.add_resource(resource).unwrap();
684
+
685
+ #[allow(deprecated)]
686
+ let flow = Flow::new(resource_id, entity1_id, entity2_id, Decimal::new(100, 0));
687
+ graph.add_flow(flow).unwrap();
688
+
689
+ let sbvr_xml = graph.export_sbvr().unwrap();
690
+
691
+ assert!(sbvr_xml.contains("<sbvr:FactType"));
692
+ assert!(sbvr_xml.contains("<sbvr:GeneralConcept"));
693
+ assert!(sbvr_xml.contains("Supplier"));
694
+ assert!(sbvr_xml.contains("Manufacturer"));
695
+ }
696
+
697
+ #[test]
698
+ fn test_xml_escaping() {
699
+ assert_eq!(SbvrModel::escape_xml("A&B"), "A&amp;B");
700
+ assert_eq!(SbvrModel::escape_xml("<tag>"), "&lt;tag&gt;");
701
+ assert_eq!(SbvrModel::escape_xml("\"quote\""), "&quot;quote&quot;");
702
+ }
703
+
704
+ #[test]
705
+ fn test_sbvr_rule_to_policy() {
706
+ let mut model = SbvrModel::new();
707
+
708
+ // minimal vocabulary
709
+ model.vocabulary.push(SbvrTerm {
710
+ id: "e1".to_string(),
711
+ name: "Warehouse".to_string(),
712
+ term_type: TermType::GeneralConcept,
713
+ definition: None,
714
+ });
715
+ model.vocabulary.push(SbvrTerm {
716
+ id: "e2".to_string(),
717
+ name: "Factory".to_string(),
718
+ term_type: TermType::GeneralConcept,
719
+ definition: None,
720
+ });
721
+ model.vocabulary.push(SbvrTerm {
722
+ id: "r1".to_string(),
723
+ name: "Cameras".to_string(),
724
+ term_type: TermType::IndividualConcept,
725
+ definition: None,
726
+ });
727
+
728
+ model.rules.push(SbvrBusinessRule {
729
+ id: "rule1".to_string(),
730
+ name: "MustHavePositiveQuantity".to_string(),
731
+ rule_type: RuleType::Obligation,
732
+ expression: "forall f in flows: (f.quantity > 0)".to_string(),
733
+ severity: "Info".to_string(),
734
+ priority: None,
735
+ });
736
+
737
+ let graph = model.to_graph().expect("SBVR to Graph conversion failed");
738
+ assert_eq!(graph.policy_count(), 1);
739
+ let policy = graph.all_policies().into_iter().next().unwrap();
740
+ assert_eq!(policy.name, "MustHavePositiveQuantity");
741
+ assert_eq!(policy.priority, 5); // default for Obligation
742
+ assert_eq!(policy.modality, crate::policy::PolicyModality::Obligation);
743
+ }
744
+ }