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,1220 @@
1
+ use super::models::{CalmModel, NodeType, Parties, RelationshipType};
2
+ use crate::policy::Policy;
3
+ use crate::primitives::{Entity, Flow, Resource, ResourceInstance};
4
+ use crate::units::unit_from_string;
5
+ use crate::ConceptId;
6
+ use crate::Graph;
7
+ use rust_decimal::Decimal;
8
+ use serde_json::Value;
9
+ use std::collections::HashMap;
10
+ use std::str::FromStr;
11
+
12
+ pub fn import(calm_json: Value) -> Result<Graph, String> {
13
+ let calm_model: CalmModel = serde_json::from_value(calm_json)
14
+ .map_err(|e| format!("Failed to parse CALM model: {}", e))?;
15
+
16
+ let mut graph = Graph::new();
17
+ let mut id_map: HashMap<String, ConceptId> = HashMap::new();
18
+
19
+ // First pass: import entities and resources to populate id_map
20
+ for node in &calm_model.nodes {
21
+ import_entity_or_resource_node(node, &mut graph, &mut id_map)?;
22
+ // Import policies (constraints) as part of the first pass as they do not
23
+ // reference other nodes.
24
+ import_constraint_node(node, &mut graph, &mut id_map)?;
25
+ }
26
+
27
+ // Second pass: import instances now that referenced IDs are available
28
+ for node in &calm_model.nodes {
29
+ import_instance_node(node, &mut graph, &mut id_map)?;
30
+ }
31
+
32
+ for relationship in &calm_model.relationships {
33
+ import_relationship(relationship, &mut graph, &id_map)?;
34
+ }
35
+
36
+ Ok(graph)
37
+ }
38
+
39
+ fn import_entity_or_resource_node(
40
+ node: &super::models::CalmNode,
41
+ graph: &mut Graph,
42
+ id_map: &mut HashMap<String, ConceptId>,
43
+ ) -> Result<(), String> {
44
+ let calm_id = &node.unique_id;
45
+
46
+ let sea_id = match &node.node_type {
47
+ NodeType::Actor | NodeType::Location => {
48
+ let entity = import_entity(node)?;
49
+ let id = entity.id().clone();
50
+ graph.add_entity(entity)?;
51
+ id
52
+ }
53
+ NodeType::Resource => {
54
+ let resource = import_resource(node)?;
55
+ let id = resource.id().clone();
56
+ graph.add_resource(resource)?;
57
+ id
58
+ }
59
+ _ => return Ok(()), // Skip instances (handled in second pass) and other unsupported node types
60
+ };
61
+
62
+ id_map.insert(calm_id.clone(), sea_id);
63
+ Ok(())
64
+ }
65
+
66
+ fn import_constraint_node(
67
+ node: &super::models::CalmNode,
68
+ graph: &mut Graph,
69
+ id_map: &mut HashMap<String, ConceptId>,
70
+ ) -> Result<(), String> {
71
+ let calm_id = &node.unique_id;
72
+
73
+ if let NodeType::Constraint = node.node_type {
74
+ let primitive = node.metadata.get("sea:primitive").and_then(|v| v.as_str());
75
+ match primitive {
76
+ Some("Pattern") => {
77
+ let regex = node
78
+ .metadata
79
+ .get("sea:regex")
80
+ .and_then(|v| v.as_str())
81
+ .ok_or("Missing sea:regex for Pattern node")?;
82
+ let ns = node
83
+ .namespace
84
+ .clone()
85
+ .unwrap_or_else(|| "default".to_string());
86
+ let pattern =
87
+ crate::patterns::Pattern::new(node.name.clone(), ns, regex.to_string())
88
+ .map_err(|e| format!("Invalid pattern regex: {}", e))?;
89
+ let pattern_id = pattern.id().clone();
90
+ graph.add_pattern(pattern).map_err(|e| e.to_string())?;
91
+ id_map.insert(calm_id.clone(), pattern_id);
92
+ return Ok(());
93
+ }
94
+ Some("Metric") => {
95
+ return Ok(());
96
+ }
97
+ Some("Policy") | None => {}
98
+ _ => return Ok(()),
99
+ }
100
+
101
+ let expr_str = node
102
+ .metadata
103
+ .get("sea:expression")
104
+ .and_then(|v| v.as_str())
105
+ .ok_or("Missing sea:expression for constraint node")?;
106
+
107
+ let expr = crate::parser::parse_expression_from_str(expr_str)
108
+ .map_err(|e| format!("Failed to parse policy expression: {}", e))?;
109
+
110
+ let ns = node
111
+ .namespace
112
+ .clone()
113
+ .unwrap_or_else(|| "default".to_string());
114
+ let mut policy = Policy::new_with_namespace(node.name.clone(), ns.clone(), expr);
115
+
116
+ if let Some(priority_val) = node.metadata.get("sea:priority") {
117
+ if let Some(priority) = priority_val.as_i64() {
118
+ policy = policy.with_priority(priority as i32);
119
+ }
120
+ }
121
+
122
+ if let Some(modality) = node.metadata.get("sea:modality").and_then(|v| v.as_str()) {
123
+ match modality {
124
+ "Obligation" => {
125
+ policy = policy.with_modality(crate::policy::PolicyModality::Obligation)
126
+ }
127
+ "Prohibition" => {
128
+ policy = policy.with_modality(crate::policy::PolicyModality::Prohibition)
129
+ }
130
+ "Permission" => {
131
+ policy = policy.with_modality(crate::policy::PolicyModality::Permission)
132
+ }
133
+ _ => {}
134
+ }
135
+ }
136
+
137
+ if let Some(kind) = node.metadata.get("sea:kind").and_then(|v| v.as_str()) {
138
+ match kind {
139
+ "Constraint" => policy = policy.with_kind(crate::policy::PolicyKind::Constraint),
140
+ "Derivation" => policy = policy.with_kind(crate::policy::PolicyKind::Derivation),
141
+ "Obligation" => policy = policy.with_kind(crate::policy::PolicyKind::Obligation),
142
+ _ => {}
143
+ }
144
+ }
145
+
146
+ let policy_id = policy.id.clone();
147
+ graph.add_policy(policy)?;
148
+ id_map.insert(calm_id.clone(), policy_id);
149
+ }
150
+
151
+ Ok(())
152
+ }
153
+
154
+ fn import_instance_node(
155
+ node: &super::models::CalmNode,
156
+ graph: &mut Graph,
157
+ id_map: &mut HashMap<String, ConceptId>,
158
+ ) -> Result<(), String> {
159
+ let calm_id = &node.unique_id;
160
+
161
+ let sea_id = match &node.node_type {
162
+ NodeType::Instance => {
163
+ let instance = import_instance(node, id_map)?;
164
+ let id = instance.id().clone();
165
+ graph.add_instance(instance)?;
166
+ id
167
+ }
168
+ _ => return Ok(()), // Skip entities and resources (handled in first pass) and other unsupported node types
169
+ };
170
+
171
+ id_map.insert(calm_id.clone(), sea_id);
172
+ Ok(())
173
+ }
174
+
175
+ fn import_entity(node: &super::models::CalmNode) -> Result<Entity, String> {
176
+ let mut entity = if let Some(ns) = &node.namespace {
177
+ Entity::new_with_namespace(node.name.clone(), ns.clone())
178
+ } else {
179
+ Entity::new_with_namespace(node.name.clone(), "default".to_string())
180
+ };
181
+
182
+ if let Some(attrs) = node.metadata.get("sea:attributes") {
183
+ if let Some(obj) = attrs.as_object() {
184
+ for (key, value) in obj {
185
+ entity.set_attribute(key.clone(), value.clone());
186
+ }
187
+ }
188
+ }
189
+
190
+ Ok(entity)
191
+ }
192
+
193
+ fn import_resource(node: &super::models::CalmNode) -> Result<Resource, String> {
194
+ let unit = node
195
+ .metadata
196
+ .get("sea:unit")
197
+ .and_then(|v| v.as_str())
198
+ .unwrap_or("units")
199
+ .to_string();
200
+
201
+ let unit_obj = unit_from_string(unit);
202
+
203
+ let mut resource = if let Some(ns) = &node.namespace {
204
+ Resource::new_with_namespace(node.name.clone(), unit_obj, ns.clone())
205
+ } else {
206
+ Resource::new_with_namespace(node.name.clone(), unit_obj, "default".to_string())
207
+ };
208
+
209
+ if let Some(attrs) = node.metadata.get("sea:attributes") {
210
+ if let Some(obj) = attrs.as_object() {
211
+ for (key, value) in obj {
212
+ resource.set_attribute(key.clone(), value.clone());
213
+ }
214
+ }
215
+ }
216
+
217
+ Ok(resource)
218
+ }
219
+
220
+ fn import_instance(
221
+ node: &super::models::CalmNode,
222
+ id_map: &HashMap<String, ConceptId>,
223
+ ) -> Result<ResourceInstance, String> {
224
+ let entity_id_str = node
225
+ .metadata
226
+ .get("sea:entity_id")
227
+ .and_then(|v| v.as_str())
228
+ .ok_or("Missing sea:entity_id in instance metadata")?;
229
+
230
+ let resource_id_str = node
231
+ .metadata
232
+ .get("sea:resource_id")
233
+ .and_then(|v| v.as_str())
234
+ .ok_or("Missing sea:resource_id in instance metadata")?;
235
+
236
+ let entity_id = id_map
237
+ .get(entity_id_str)
238
+ .ok_or_else(|| format!("Unknown entity ID: {}", entity_id_str))?;
239
+
240
+ let resource_id = id_map
241
+ .get(resource_id_str)
242
+ .ok_or_else(|| format!("Unknown resource ID: {}", resource_id_str))?;
243
+
244
+ let mut instance = if let Some(ns) = &node.namespace {
245
+ ResourceInstance::new_with_namespace(resource_id.clone(), entity_id.clone(), ns.clone())
246
+ } else {
247
+ ResourceInstance::new_with_namespace(
248
+ resource_id.clone(),
249
+ entity_id.clone(),
250
+ "default".to_string(),
251
+ )
252
+ };
253
+
254
+ if let Some(attrs) = node.metadata.get("sea:attributes") {
255
+ if let Some(obj) = attrs.as_object() {
256
+ for (key, value) in obj {
257
+ instance.set_attribute(key.clone(), value.clone());
258
+ }
259
+ }
260
+ }
261
+
262
+ Ok(instance)
263
+ }
264
+
265
+ fn import_relationship(
266
+ relationship: &super::models::CalmRelationship,
267
+ graph: &mut Graph,
268
+ id_map: &HashMap<String, ConceptId>,
269
+ ) -> Result<(), String> {
270
+ match &relationship.relationship_type {
271
+ RelationshipType::Flow { flow } => {
272
+ let (source_id, dest_id) = match &relationship.parties {
273
+ Parties::SourceDestination {
274
+ source,
275
+ destination,
276
+ } => (source, destination),
277
+ _ => {
278
+ return Err("Flow relationship must have source/destination parties".to_string())
279
+ }
280
+ };
281
+
282
+ let source_uuid = id_map
283
+ .get(source_id)
284
+ .ok_or_else(|| format!("Unknown source ID: {}", source_id))?;
285
+
286
+ let dest_uuid = id_map
287
+ .get(dest_id)
288
+ .ok_or_else(|| format!("Unknown destination ID: {}", dest_id))?;
289
+
290
+ let resource_uuid = id_map
291
+ .get(&flow.resource)
292
+ .ok_or_else(|| format!("Unknown resource ID: {}", flow.resource))?;
293
+
294
+ let quantity = Decimal::from_str(&flow.quantity)
295
+ .map_err(|e| format!("Invalid quantity '{}': {}", flow.quantity, e))?;
296
+
297
+ let flow_obj = Flow::new(
298
+ resource_uuid.clone(),
299
+ source_uuid.clone(),
300
+ dest_uuid.clone(),
301
+ quantity,
302
+ );
303
+ graph.add_flow(flow_obj)?;
304
+ }
305
+ RelationshipType::Simple(rel_type) => {
306
+ let rel_type_text = rel_type.as_str();
307
+ if rel_type_text == "ownership" {
308
+ return Err("Ownership relationships should be modeled as Instances, not Simple relationships".to_string());
309
+ }
310
+ if rel_type_text == "association" {
311
+ // Map association relationships into the Graph. We use the
312
+ // Graph::add_association helper which stores associations as an attribute
313
+ // on the source entity for simplicity.
314
+ let (source_id, dest_id) = match &relationship.parties {
315
+ Parties::SourceDestination {
316
+ source,
317
+ destination,
318
+ } => (source, destination),
319
+ _ => {
320
+ return Err(
321
+ "Association relationship must have source/destination parties"
322
+ .to_string(),
323
+ )
324
+ }
325
+ };
326
+ let source_uuid = id_map
327
+ .get(source_id)
328
+ .ok_or_else(|| format!("Unknown source ID: {}", source_id))?;
329
+
330
+ let dest_uuid = id_map
331
+ .get(dest_id)
332
+ .ok_or_else(|| format!("Unknown destination ID: {}", dest_id))?;
333
+
334
+ graph.add_association(source_uuid, dest_uuid, "association")?;
335
+ return Ok(());
336
+ }
337
+ log::warn!(
338
+ "Skipping unsupported Simple relationship '{}' in CALM import",
339
+ rel_type_text
340
+ );
341
+ return Ok(());
342
+ }
343
+ }
344
+
345
+ Ok(())
346
+ }
347
+
348
+ #[cfg(test)]
349
+ mod tests {
350
+ use super::*;
351
+ use serde_json::json;
352
+
353
+ #[test]
354
+ fn test_import_empty_model() {
355
+ let calm_json = json!({
356
+ "version": "2.0",
357
+ "metadata": {
358
+ "sea:exported": true,
359
+ "sea:version": crate::VERSION
360
+ },
361
+ "nodes": [],
362
+ "relationships": []
363
+ });
364
+
365
+ let result = import(calm_json);
366
+ assert!(result.is_ok());
367
+
368
+ let graph = result.unwrap();
369
+ assert_eq!(graph.entity_count(), 0);
370
+ assert_eq!(graph.resource_count(), 0);
371
+ }
372
+
373
+ #[test]
374
+ fn test_import_entity() {
375
+ let calm_json = json!({
376
+ "version": "2.0",
377
+ "metadata": {
378
+ "sea:exported": true,
379
+ "sea:version": crate::VERSION
380
+ },
381
+ "nodes": [
382
+ {
383
+ "unique-id": "entity-1",
384
+ "node-type": "actor",
385
+ "name": "Warehouse",
386
+ "namespace": "logistics",
387
+ "metadata": {
388
+ "sea:primitive": "Entity",
389
+ "sea:attributes": {
390
+ "capacity": 10000
391
+ }
392
+ }
393
+ }
394
+ ],
395
+ "relationships": []
396
+ });
397
+
398
+ let result = import(calm_json);
399
+ assert!(result.is_ok());
400
+
401
+ let graph = result.unwrap();
402
+ assert_eq!(graph.entity_count(), 1);
403
+
404
+ let entity = graph.all_entities()[0];
405
+ assert_eq!(entity.name(), "Warehouse");
406
+ assert_eq!(entity.namespace(), "logistics");
407
+ }
408
+
409
+ #[test]
410
+ fn test_import_resource() {
411
+ let calm_json = json!({
412
+ "version": "2.0",
413
+ "metadata": {
414
+ "sea:exported": true,
415
+ "sea:version": crate::VERSION
416
+ },
417
+ "nodes": [
418
+ {
419
+ "unique-id": "resource-1",
420
+ "node-type": "resource",
421
+ "name": "Cameras",
422
+ "metadata": {
423
+ "sea:primitive": "Resource",
424
+ "sea:unit": "units"
425
+ }
426
+ }
427
+ ],
428
+ "relationships": []
429
+ });
430
+
431
+ let result = import(calm_json);
432
+ assert!(result.is_ok());
433
+
434
+ let graph = result.unwrap();
435
+ assert_eq!(graph.resource_count(), 1);
436
+
437
+ let resource = graph.all_resources()[0];
438
+ assert_eq!(resource.name(), "Cameras");
439
+ assert_eq!(resource.unit().symbol(), "units");
440
+ }
441
+
442
+ #[test]
443
+ fn test_import_flow() {
444
+ let calm_json = json!({
445
+ "version": "2.0",
446
+ "metadata": {
447
+ "sea:exported": true,
448
+ "sea:version": crate::VERSION
449
+ },
450
+ "nodes": [
451
+ {
452
+ "unique-id": "entity-1",
453
+ "node-type": "actor",
454
+ "name": "Warehouse",
455
+ "metadata": {
456
+ "sea:primitive": "Entity"
457
+ }
458
+ },
459
+ {
460
+ "unique-id": "entity-2",
461
+ "node-type": "actor",
462
+ "name": "Factory",
463
+ "metadata": {
464
+ "sea:primitive": "Entity"
465
+ }
466
+ },
467
+ {
468
+ "unique-id": "resource-1",
469
+ "node-type": "resource",
470
+ "name": "Cameras",
471
+ "metadata": {
472
+ "sea:primitive": "Resource",
473
+ "sea:unit": "units"
474
+ }
475
+ }
476
+ ],
477
+ "relationships": [
478
+ {
479
+ "unique-id": "flow-1",
480
+ "relationship-type": {
481
+ "flow": {
482
+ "resource": "resource-1",
483
+ "quantity": "100"
484
+ }
485
+ },
486
+ "parties": {
487
+ "source": "entity-1",
488
+ "destination": "entity-2"
489
+ }
490
+ }
491
+ ]
492
+ });
493
+
494
+ let result = import(calm_json);
495
+ assert!(result.is_ok());
496
+
497
+ let graph = result.unwrap();
498
+ assert_eq!(graph.flow_count(), 1);
499
+
500
+ let flow = graph.all_flows()[0];
501
+ assert_eq!(flow.quantity().to_string(), "100");
502
+ }
503
+
504
+ #[test]
505
+ fn test_import_instance() {
506
+ let calm_json = json!({
507
+ "version": "2.0",
508
+ "metadata": {
509
+ "sea:exported": true,
510
+ "sea:version": crate::VERSION
511
+ },
512
+ "nodes": [
513
+ {
514
+ "unique-id": "entity-1",
515
+ "node-type": "actor",
516
+ "name": "Warehouse",
517
+ "metadata": {
518
+ "sea:primitive": "Entity"
519
+ }
520
+ },
521
+ {
522
+ "unique-id": "resource-1",
523
+ "node-type": "resource",
524
+ "name": "Cameras",
525
+ "metadata": {
526
+ "sea:primitive": "Resource",
527
+ "sea:unit": "units"
528
+ }
529
+ },
530
+ {
531
+ "unique-id": "instance-1",
532
+ "node-type": "instance",
533
+ "name": "Camera-001",
534
+ "metadata": {
535
+ "sea:primitive": "Instance",
536
+ "sea:entity_id": "entity-1",
537
+ "sea:resource_id": "resource-1"
538
+ }
539
+ }
540
+ ],
541
+ "relationships": []
542
+ });
543
+
544
+ let result = import(calm_json);
545
+ assert!(result.is_ok());
546
+
547
+ let graph = result.unwrap();
548
+ assert_eq!(graph.instance_count(), 1);
549
+
550
+ let instance = graph.all_instances()[0];
551
+ // Verify the instance references the correct entities and resources
552
+ assert_eq!(
553
+ graph.get_entity(instance.entity_id()).unwrap().name(),
554
+ "Warehouse"
555
+ );
556
+ assert_eq!(
557
+ graph.get_resource(instance.resource_id()).unwrap().name(),
558
+ "Cameras"
559
+ );
560
+ }
561
+
562
+ #[test]
563
+ fn test_import_instance_with_namespace() {
564
+ let calm_json = json!({
565
+ "version": "2.0",
566
+ "metadata": {
567
+ "sea:exported": true,
568
+ "sea:version": crate::VERSION
569
+ },
570
+ "nodes": [
571
+ {
572
+ "unique-id": "entity-1",
573
+ "node-type": "actor",
574
+ "name": "Warehouse",
575
+ "namespace": "logistics",
576
+ "metadata": {
577
+ "sea:primitive": "Entity"
578
+ }
579
+ },
580
+ {
581
+ "unique-id": "resource-1",
582
+ "node-type": "resource",
583
+ "name": "Cameras",
584
+ "namespace": "security",
585
+ "metadata": {
586
+ "sea:primitive": "Resource",
587
+ "sea:unit": "units"
588
+ }
589
+ },
590
+ {
591
+ "unique-id": "instance-1",
592
+ "node-type": "instance",
593
+ "name": "Camera-001",
594
+ "namespace": "monitoring",
595
+ "metadata": {
596
+ "sea:primitive": "Instance",
597
+ "sea:entity_id": "entity-1",
598
+ "sea:resource_id": "resource-1"
599
+ }
600
+ }
601
+ ],
602
+ "relationships": []
603
+ });
604
+
605
+ let result = import(calm_json);
606
+ assert!(result.is_ok());
607
+
608
+ let graph = result.unwrap();
609
+ assert_eq!(graph.instance_count(), 1);
610
+
611
+ let instance = graph.all_instances()[0];
612
+ // Verify the instance references the correct entities and resources
613
+ assert_eq!(
614
+ graph.get_entity(instance.entity_id()).unwrap().name(),
615
+ "Warehouse"
616
+ );
617
+ assert_eq!(
618
+ graph.get_resource(instance.resource_id()).unwrap().name(),
619
+ "Cameras"
620
+ );
621
+ assert_eq!(instance.namespace(), "monitoring");
622
+ }
623
+
624
+ #[test]
625
+ fn test_import_instance_missing_entity_id() {
626
+ let calm_json = json!({
627
+ "version": "2.0",
628
+ "metadata": {
629
+ "sea:exported": true,
630
+ "sea:version": crate::VERSION
631
+ },
632
+ "nodes": [
633
+ {
634
+ "unique-id": "entity-1",
635
+ "node-type": "actor",
636
+ "name": "Warehouse",
637
+ "metadata": {
638
+ "sea:primitive": "Entity"
639
+ }
640
+ },
641
+ {
642
+ "unique-id": "resource-1",
643
+ "node-type": "resource",
644
+ "name": "Cameras",
645
+ "metadata": {
646
+ "sea:primitive": "Resource",
647
+ "sea:unit": "units"
648
+ }
649
+ },
650
+ {
651
+ "unique-id": "instance-1",
652
+ "node-type": "instance",
653
+ "name": "Camera-001",
654
+ "metadata": {
655
+ "sea:primitive": "Instance",
656
+ "sea:resource_id": "resource-1"
657
+ // Missing sea:entity_id
658
+ }
659
+ }
660
+ ],
661
+ "relationships": []
662
+ });
663
+
664
+ let result = import(calm_json);
665
+ assert!(result.is_err());
666
+ assert!(result.unwrap_err().contains("Missing sea:entity_id"));
667
+ }
668
+
669
+ #[test]
670
+ fn test_import_instance_missing_resource_id() {
671
+ let calm_json = json!({
672
+ "version": "2.0",
673
+ "metadata": {
674
+ "sea:exported": true,
675
+ "sea:version": crate::VERSION
676
+ },
677
+ "nodes": [
678
+ {
679
+ "unique-id": "entity-1",
680
+ "node-type": "actor",
681
+ "name": "Warehouse",
682
+ "metadata": {
683
+ "sea:primitive": "Entity"
684
+ }
685
+ },
686
+ {
687
+ "unique-id": "resource-1",
688
+ "node-type": "resource",
689
+ "name": "Cameras",
690
+ "metadata": {
691
+ "sea:primitive": "Resource",
692
+ "sea:unit": "units"
693
+ }
694
+ },
695
+ {
696
+ "unique-id": "instance-1",
697
+ "node-type": "instance",
698
+ "name": "Camera-001",
699
+ "metadata": {
700
+ "sea:primitive": "Instance",
701
+ "sea:entity_id": "entity-1"
702
+ // Missing sea:resource_id
703
+ }
704
+ }
705
+ ],
706
+ "relationships": []
707
+ });
708
+
709
+ let result = import(calm_json);
710
+ assert!(result.is_err());
711
+ assert!(result.unwrap_err().contains("Missing sea:resource_id"));
712
+ }
713
+
714
+ #[test]
715
+ fn test_import_instance_unknown_entity_id() {
716
+ let calm_json = json!({
717
+ "version": "2.0",
718
+ "metadata": {
719
+ "sea:exported": true,
720
+ "sea:version": crate::VERSION
721
+ },
722
+ "nodes": [
723
+ {
724
+ "unique-id": "entity-1",
725
+ "node-type": "actor",
726
+ "name": "Warehouse",
727
+ "metadata": {
728
+ "sea:primitive": "Entity"
729
+ }
730
+ },
731
+ {
732
+ "unique-id": "resource-1",
733
+ "node-type": "resource",
734
+ "name": "Cameras",
735
+ "metadata": {
736
+ "sea:primitive": "Resource",
737
+ "sea:unit": "units"
738
+ }
739
+ },
740
+ {
741
+ "unique-id": "instance-1",
742
+ "node-type": "instance",
743
+ "name": "Camera-001",
744
+ "metadata": {
745
+ "sea:primitive": "Instance",
746
+ "sea:entity_id": "nonexistent-entity",
747
+ "sea:resource_id": "resource-1"
748
+ }
749
+ }
750
+ ],
751
+ "relationships": []
752
+ });
753
+
754
+ let result = import(calm_json);
755
+ assert!(result.is_err());
756
+ assert!(result
757
+ .unwrap_err()
758
+ .contains("Unknown entity ID: nonexistent-entity"));
759
+ }
760
+
761
+ #[test]
762
+ fn test_import_instance_unknown_resource_id() {
763
+ let calm_json = json!({
764
+ "version": "2.0",
765
+ "metadata": {
766
+ "sea:exported": true,
767
+ "sea:version": crate::VERSION
768
+ },
769
+ "nodes": [
770
+ {
771
+ "unique-id": "entity-1",
772
+ "node-type": "actor",
773
+ "name": "Warehouse",
774
+ "metadata": {
775
+ "sea:primitive": "Entity"
776
+ }
777
+ },
778
+ {
779
+ "unique-id": "resource-1",
780
+ "node-type": "resource",
781
+ "name": "Cameras",
782
+ "metadata": {
783
+ "sea:primitive": "Resource",
784
+ "sea:unit": "units"
785
+ }
786
+ },
787
+ {
788
+ "unique-id": "instance-1",
789
+ "node-type": "instance",
790
+ "name": "Camera-001",
791
+ "metadata": {
792
+ "sea:primitive": "Instance",
793
+ "sea:entity_id": "entity-1",
794
+ "sea:resource_id": "nonexistent-resource"
795
+ }
796
+ }
797
+ ],
798
+ "relationships": []
799
+ });
800
+
801
+ let result = import(calm_json);
802
+ assert!(result.is_err());
803
+ assert!(result
804
+ .unwrap_err()
805
+ .contains("Unknown resource ID: nonexistent-resource"));
806
+ }
807
+
808
+ #[test]
809
+ fn test_import_flow_invalid_quantity() {
810
+ let calm_json = json!({
811
+ "version": "2.0",
812
+ "metadata": {
813
+ "sea:exported": true,
814
+ "sea:version": crate::VERSION
815
+ },
816
+ "nodes": [
817
+ {
818
+ "unique-id": "entity-1",
819
+ "node-type": "actor",
820
+ "name": "Warehouse",
821
+ "metadata": {
822
+ "sea:primitive": "Entity"
823
+ }
824
+ },
825
+ {
826
+ "unique-id": "entity-2",
827
+ "node-type": "actor",
828
+ "name": "Factory",
829
+ "metadata": {
830
+ "sea:primitive": "Entity"
831
+ }
832
+ },
833
+ {
834
+ "unique-id": "resource-1",
835
+ "node-type": "resource",
836
+ "name": "Cameras",
837
+ "metadata": {
838
+ "sea:primitive": "Resource",
839
+ "sea:unit": "units"
840
+ }
841
+ }
842
+ ],
843
+ "relationships": [
844
+ {
845
+ "unique-id": "flow-1",
846
+ "relationship-type": {
847
+ "flow": {
848
+ "resource": "resource-1",
849
+ "quantity": "not_a_number"
850
+ }
851
+ },
852
+ "parties": {
853
+ "source": "entity-1",
854
+ "destination": "entity-2"
855
+ }
856
+ }
857
+ ]
858
+ });
859
+
860
+ let result = import(calm_json);
861
+ assert!(result.is_err());
862
+ assert!(result.unwrap_err().contains("Invalid quantity"));
863
+ }
864
+
865
+ #[test]
866
+ fn test_import_flow_unknown_source() {
867
+ let calm_json = json!({
868
+ "version": "2.0",
869
+ "metadata": {
870
+ "sea:exported": true,
871
+ "sea:version": crate::VERSION
872
+ },
873
+ "nodes": [
874
+ {
875
+ "unique-id": "entity-1",
876
+ "node-type": "actor",
877
+ "name": "Warehouse",
878
+ "metadata": {
879
+ "sea:primitive": "Entity"
880
+ }
881
+ },
882
+ {
883
+ "unique-id": "resource-1",
884
+ "node-type": "resource",
885
+ "name": "Cameras",
886
+ "metadata": {
887
+ "sea:primitive": "Resource",
888
+ "sea:unit": "units"
889
+ }
890
+ }
891
+ ],
892
+ "relationships": [
893
+ {
894
+ "unique-id": "flow-1",
895
+ "relationship-type": {
896
+ "flow": {
897
+ "resource": "resource-1",
898
+ "quantity": "100"
899
+ }
900
+ },
901
+ "parties": {
902
+ "source": "nonexistent-entity",
903
+ "destination": "entity-1"
904
+ }
905
+ }
906
+ ]
907
+ });
908
+
909
+ let result = import(calm_json);
910
+ assert!(result.is_err());
911
+ assert!(result
912
+ .unwrap_err()
913
+ .contains("Unknown source ID: nonexistent-entity"));
914
+ }
915
+
916
+ #[test]
917
+ fn test_import_flow_unknown_destination() {
918
+ let calm_json = json!({
919
+ "version": "2.0",
920
+ "metadata": {
921
+ "sea:exported": true,
922
+ "sea:version": crate::VERSION
923
+ },
924
+ "nodes": [
925
+ {
926
+ "unique-id": "entity-1",
927
+ "node-type": "actor",
928
+ "name": "Warehouse",
929
+ "metadata": {
930
+ "sea:primitive": "Entity"
931
+ }
932
+ },
933
+ {
934
+ "unique-id": "resource-1",
935
+ "node-type": "resource",
936
+ "name": "Cameras",
937
+ "metadata": {
938
+ "sea:primitive": "Resource",
939
+ "sea:unit": "units"
940
+ }
941
+ }
942
+ ],
943
+ "relationships": [
944
+ {
945
+ "unique-id": "flow-1",
946
+ "relationship-type": {
947
+ "flow": {
948
+ "resource": "resource-1",
949
+ "quantity": "100"
950
+ }
951
+ },
952
+ "parties": {
953
+ "source": "entity-1",
954
+ "destination": "nonexistent-entity"
955
+ }
956
+ }
957
+ ]
958
+ });
959
+
960
+ let result = import(calm_json);
961
+ assert!(result.is_err());
962
+ assert!(result
963
+ .unwrap_err()
964
+ .contains("Unknown destination ID: nonexistent-entity"));
965
+ }
966
+
967
+ #[test]
968
+ fn test_import_entity_without_namespace() {
969
+ let calm_json = json!({
970
+ "version": "2.0",
971
+ "metadata": {
972
+ "sea:exported": true,
973
+ "sea:version": crate::VERSION
974
+ },
975
+ "nodes": [
976
+ {
977
+ "unique-id": "entity-1",
978
+ "node-type": "actor",
979
+ "name": "Warehouse",
980
+ // No namespace field
981
+ "metadata": {
982
+ "sea:primitive": "Entity"
983
+ }
984
+ }
985
+ ],
986
+ "relationships": []
987
+ });
988
+
989
+ let result = import(calm_json);
990
+ assert!(result.is_ok());
991
+
992
+ let graph = result.unwrap();
993
+ assert_eq!(graph.entity_count(), 1);
994
+
995
+ let entity = graph.all_entities()[0];
996
+ assert_eq!(entity.name(), "Warehouse");
997
+ assert_eq!(entity.namespace(), "default");
998
+ }
999
+
1000
+ #[test]
1001
+ fn test_import_resource_without_namespace() {
1002
+ let calm_json = json!({
1003
+ "version": "2.0",
1004
+ "metadata": {
1005
+ "sea:exported": true,
1006
+ "sea:version": crate::VERSION
1007
+ },
1008
+ "nodes": [
1009
+ {
1010
+ "unique-id": "resource-1",
1011
+ "node-type": "resource",
1012
+ "name": "Cameras",
1013
+ // No namespace field
1014
+ "metadata": {
1015
+ "sea:primitive": "Resource",
1016
+ "sea:unit": "units"
1017
+ }
1018
+ }
1019
+ ],
1020
+ "relationships": []
1021
+ });
1022
+
1023
+ let result = import(calm_json);
1024
+ assert!(result.is_ok());
1025
+
1026
+ let graph = result.unwrap();
1027
+ assert_eq!(graph.resource_count(), 1);
1028
+
1029
+ let resource = graph.all_resources()[0];
1030
+ assert_eq!(resource.name(), "Cameras");
1031
+ assert_eq!(resource.namespace(), "default");
1032
+ }
1033
+
1034
+ #[test]
1035
+ fn test_import_flow_same_source_destination() {
1036
+ let calm_json = json!({
1037
+ "version": "2.0",
1038
+ "metadata": {
1039
+ "sea:exported": true,
1040
+ "sea:version": crate::VERSION
1041
+ },
1042
+ "nodes": [
1043
+ {
1044
+ "unique-id": "entity-1",
1045
+ "node-type": "actor",
1046
+ "name": "Warehouse",
1047
+ "metadata": {
1048
+ "sea:primitive": "Entity"
1049
+ }
1050
+ },
1051
+ {
1052
+ "unique-id": "resource-1",
1053
+ "node-type": "resource",
1054
+ "name": "Cameras",
1055
+ "metadata": {
1056
+ "sea:primitive": "Resource",
1057
+ "sea:unit": "units"
1058
+ }
1059
+ }
1060
+ ],
1061
+ "relationships": [
1062
+ {
1063
+ "unique-id": "flow-1",
1064
+ "relationship-type": {
1065
+ "flow": {
1066
+ "resource": "resource-1",
1067
+ "quantity": "100"
1068
+ }
1069
+ },
1070
+ "parties": {
1071
+ "source": "entity-1",
1072
+ "destination": "entity-1"
1073
+ }
1074
+ }
1075
+ ]
1076
+ });
1077
+
1078
+ let result = import(calm_json);
1079
+ assert!(result.is_ok());
1080
+
1081
+ let graph = result.unwrap();
1082
+ assert_eq!(graph.flow_count(), 1);
1083
+
1084
+ let flow = graph.all_flows()[0];
1085
+ assert_eq!(flow.from_id(), flow.to_id());
1086
+ }
1087
+
1088
+ #[test]
1089
+ fn test_import_relationship_invalid_parties() {
1090
+ let calm_json = json!({
1091
+ "version": "2.0",
1092
+ "metadata": {
1093
+ "sea:exported": true,
1094
+ "sea:version": crate::VERSION
1095
+ },
1096
+ "nodes": [
1097
+ {
1098
+ "unique-id": "entity-1",
1099
+ "node-type": "actor",
1100
+ "name": "Warehouse",
1101
+ "metadata": {
1102
+ "sea:primitive": "Entity"
1103
+ }
1104
+ },
1105
+ {
1106
+ "unique-id": "resource-1",
1107
+ "node-type": "resource",
1108
+ "name": "Cameras",
1109
+ "metadata": {
1110
+ "sea:primitive": "Resource",
1111
+ "sea:unit": "units"
1112
+ }
1113
+ }
1114
+ ],
1115
+ "relationships": [
1116
+ {
1117
+ "unique-id": "flow-1",
1118
+ "relationship-type": {
1119
+ "flow": {
1120
+ "resource": "resource-1",
1121
+ "quantity": "100"
1122
+ }
1123
+ },
1124
+ "parties": {
1125
+ "owner": "entity-1",
1126
+ "owned": "entity-1"
1127
+ }
1128
+ }
1129
+ ]
1130
+ });
1131
+
1132
+ let result = import(calm_json);
1133
+ assert!(result.is_err());
1134
+ assert!(result
1135
+ .unwrap_err()
1136
+ .contains("Flow relationship must have source/destination parties"));
1137
+ }
1138
+
1139
+ #[test]
1140
+ fn test_import_policy_node() {
1141
+ let calm_json = json!({
1142
+ "version": "2.0",
1143
+ "metadata": {"sea:exported": true, "sea:version": crate::VERSION},
1144
+ "nodes": [
1145
+ {
1146
+ "unique-id": "entity-1",
1147
+ "node-type": "actor",
1148
+ "name": "Warehouse",
1149
+ "metadata": {"sea:primitive": "Entity"}
1150
+ },
1151
+ {
1152
+ "unique-id": "policy-1",
1153
+ "node-type": "constraint",
1154
+ "name": "MustHavePositiveQuantity",
1155
+ "metadata": {
1156
+ "sea:primitive": "Policy",
1157
+ "sea:expression": "forall f in flows: (f.quantity > 0)",
1158
+ "sea:expression_type": "SEA"
1159
+ }
1160
+ }
1161
+ ],
1162
+ "relationships": []
1163
+ });
1164
+
1165
+ let result = import(calm_json);
1166
+ assert!(result.is_ok());
1167
+ let graph = result.unwrap();
1168
+ assert_eq!(graph.policy_count(), 1);
1169
+ let policy = graph.all_policies()[0];
1170
+ assert_eq!(policy.name, "MustHavePositiveQuantity");
1171
+ }
1172
+
1173
+ #[test]
1174
+ fn test_import_association_relationship() {
1175
+ let calm_json = json!({
1176
+ "version": "2.0",
1177
+ "metadata": {"sea:exported": true, "sea:version": crate::VERSION},
1178
+ "nodes": [
1179
+ {
1180
+ "unique-id": "entity-1",
1181
+ "node-type": "actor",
1182
+ "name": "A",
1183
+ "metadata": {"sea:primitive": "Entity"}
1184
+ },
1185
+ {
1186
+ "unique-id": "entity-2",
1187
+ "node-type": "actor",
1188
+ "name": "B",
1189
+ "metadata": {"sea:primitive": "Entity"}
1190
+ }
1191
+ ],
1192
+ "relationships": [
1193
+ {
1194
+ "unique-id": "assoc-1",
1195
+ "relationship-type": "association",
1196
+ "parties": {
1197
+ "source": "entity-1",
1198
+ "destination": "entity-2"
1199
+ }
1200
+ }
1201
+ ]
1202
+ });
1203
+
1204
+ let result = import(calm_json);
1205
+ assert!(result.is_ok());
1206
+ let graph = result.unwrap();
1207
+ assert_eq!(graph.entity_count(), 2);
1208
+ let _entities = graph.all_entities();
1209
+ // Get the first entity and check associations attribute
1210
+ let e1 = graph.find_entity_by_name("A").unwrap();
1211
+ let e1_ref = graph.get_entity(&e1).unwrap();
1212
+ let associations = e1_ref.get_attribute("associations").unwrap();
1213
+ assert!(associations.is_array());
1214
+ let arr = associations.as_array().unwrap();
1215
+ assert_eq!(
1216
+ arr[0]["target"],
1217
+ Value::String(graph.find_entity_by_name("B").unwrap().to_string())
1218
+ );
1219
+ }
1220
+ }