kapps-semantic-middleware 0.2.2__tar.gz → 0.2.4__tar.gz
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.
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/AGENTS.md +4 -3
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/CHANGELOG.md +62 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/PKG-INFO +5 -1
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/README.md +4 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/CONTEXT.md +1 -2
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/README.md +6 -3
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/algorithm.py +49 -14
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/control_station.py +1 -1
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/controller.py +21 -21
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/factory.ttl +3 -3
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/index.py +1 -1
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/launcher.py +2 -2
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/seed.py +17 -11
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/station_board.py +10 -6
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/templates/station_board.html +34 -4
- {kapps_semantic_middleware-0.2.2/examples → kapps_semantic_middleware-0.2.4/demo/transferunits}/transferunit.ttl +4 -4
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/mechanics/01-instantiation-and-lifecycle.md +7 -7
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/mechanics/02-workflow-registration.md +6 -6
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/mechanics/04-connector-binding.md +1 -1
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/mechanics/05-operation-coordination.md +15 -4
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/mechanics/07-writing-to-the-graph-and-to-devices.md +7 -7
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/mechanics/08-provisioning-and-seeding.md +20 -10
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/mechanics/09-the-state-dashboard.md +5 -4
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/concepts.md +3 -3
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/guide/01-instantiation-and-lifecycle.md +7 -7
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/guide/02-workflow-registration.md +6 -6
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/guide/04-connector-binding.md +1 -1
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/guide/05-operation-coordination.md +15 -4
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/guide/07-writing-to-the-graph-and-to-devices.md +7 -7
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/guide/08-provisioning-and-seeding.md +25 -10
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/guide/09-the-state-dashboard.md +3 -3
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/guide/index.md +2 -2
- kapps_semantic_middleware-0.2.4/docs/site/reference/seeding.md +10 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/scenarios/factory.md +5 -2
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/examples/demo_handover.ttl +2 -2
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/examples/demo_scenario1.ttl +3 -3
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/examples/demo_scenario2.ttl +3 -3
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/examples/scenario1_hello_world.ipynb +19 -19
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/examples/scenario1_hello_world.py +15 -15
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/examples/scenario2_door.ipynb +11 -11
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/examples/scenario2_door.py +11 -11
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/examples/seed.py +19 -12
- {kapps_semantic_middleware-0.2.2/demo/transferunits → kapps_semantic_middleware-0.2.4/examples}/transferunit.ttl +4 -4
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/pyproject.toml +1 -1
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/CONTEXT.md +18 -13
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/activity.py +0 -1
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/connectors/mqtt_binding.py +2 -2
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/connectors/rest_binding.py +3 -3
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/connectors/semantic.py +4 -4
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/connectors/wiring.py +8 -8
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/dashboard.py +9 -9
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/dashboard_boxes.py +2 -5
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/middleware.py +20 -20
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/ontology/core.ttl +73 -73
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/ontology/mes.ttl +3 -3
- kapps_semantic_middleware-0.2.4/src/kapps_semantic_middleware/ontology/service-shapes.ttl +26 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/ontology/service.ttl +27 -27
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/operation.py +2 -2
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/possession.py +2 -2
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/registration.py +52 -52
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/seeding.py +61 -5
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/shacl_interop/CONTEXT.md +2 -2
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/shacl_interop/shape_from_typehints.py +2 -2
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/vocabulary.py +24 -22
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/README.md +12 -3
- kapps_semantic_middleware-0.2.4/tests/_shapes.py +29 -0
- kapps_semantic_middleware-0.2.4/tests/_text_files.py +63 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/conftest.py +19 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/reports/complete-without-releasing.nq +26 -26
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/reports/skip-reserve.nq +9 -9
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_activity_feed.py +11 -1
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_activity_feed_stop.py +1 -1
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_capability_link.py +3 -2
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_commit_integration.py +39 -34
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_commit_unit.py +21 -21
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_controller_discovery.py +13 -13
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_controller_rebuild_view.py +4 -4
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_controller_view.py +7 -7
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_create_integration.py +39 -36
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_create_unit.py +38 -38
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_dashboard.py +52 -29
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_dashboard_name_integration.py +1 -1
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_dashboard_observation.py +1 -1
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_dashboard_tabs_in_a_browser.py +2 -2
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_deregistration_names_by_iri.py +2 -2
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_error_actions.py +5 -5
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_event_trigger_integration.py +19 -19
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_examples_serve_their_middlewares.py +2 -2
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_factory_deregistration.py +6 -6
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_factory_smoke.py +3 -4
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_failure_dump_unit.py +1 -1
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_generic_modules.py +2 -2
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_handover_integration.py +19 -14
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_intake.py +18 -18
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_intake_integration.py +39 -35
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_issued_operation.py +157 -158
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_launcher_seeding.py +11 -11
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_liveness_integration.py +11 -11
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_liveness_loops.py +6 -6
- kapps_semantic_middleware-0.2.2/tests/test_middleware_connector_flavours.py → kapps_semantic_middleware-0.2.4/tests/test_middleware_connector_wiring.py +4 -4
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_multiline_records_in_a_browser.py +1 -1
- kapps_semantic_middleware-0.2.4/tests/test_names_no_consumer.py +258 -0
- kapps_semantic_middleware-0.2.4/tests/test_names_no_https_ontology_namespace.py +105 -0
- kapps_semantic_middleware-0.2.4/tests/test_names_no_old_property_names.py +123 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_names_no_vendor.py +3 -2
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_no_direct_writes.py +2 -2
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_notification_integration.py +6 -5
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_notify.py +3 -3
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_observation.py +1 -1
- kapps_semantic_middleware-0.2.4/tests/test_operation_status_shape.py +119 -0
- kapps_semantic_middleware-0.2.4/tests/test_operation_status_shape_integration.py +149 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_pages_under_a_prefix.py +5 -5
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_possession_handover.py +1 -1
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_queue_durability_integration.py +1 -1
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_recursive_rest_router.py +21 -21
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_refused_writes.py +5 -5
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_refused_writes_integration.py +25 -21
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_request_claim_integration.py +30 -25
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_request_claim_unit.py +24 -24
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_reregistration.py +4 -4
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_rest_binding.py +8 -8
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_scenario1_integration.py +8 -8
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_scenario2_integration.py +5 -5
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_scenario3_roundtrip_integration.py +1 -1
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_scenario3_wiring_integration.py +16 -16
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_seeding.py +17 -1
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_semantic_connectors.py +12 -12
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_service_identity.py +8 -8
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_shape_from_typehints.py +8 -8
- kapps_semantic_middleware-0.2.4/tests/test_shapes_join.py +50 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_shipped_stack_validates_shapes.py +1 -1
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_station_board_guard.py +2 -2
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_station_board_state_route.py +9 -9
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_stranded_operations.py +12 -12
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_typed_identity.py +1 -1
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_validation_report.py +22 -21
- kapps_semantic_middleware-0.2.4/tests/test_view_query_presets.py +41 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_vocabulary.py +10 -10
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_writers_scope_covers_data.py +2 -2
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/uv.lock +1 -1
- kapps_semantic_middleware-0.2.2/docs/site/reference/seeding.md +0 -9
- kapps_semantic_middleware-0.2.2/tests/test_names_no_consumer.py +0 -91
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/.env.example +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/.github/workflows/hygiene.yml +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/.github/workflows/publish.yml +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/.gitignore +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/.python-version +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/CLAUDE.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/CONTEXT-MAP.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/LICENSE +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/__init__.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/__init__.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/__main__.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/middleware.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/plc/__init__.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/plc/__main__.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/plc/panel.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/plc/static/transferunit.svg +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/plc/templates/panel.html +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/plc/transfer_unit.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/templates/index.html +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/watchdog.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/mechanics/03-state-and-parameters.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/mechanics/06-views-and-projection.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/_static/custom.css +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/_static/sfb-logo.png +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/_static/switcher.json +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/conf.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/errors.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/guide/03-state-and-parameters.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/guide/06-views-and-projection.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/index.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/reference/activity.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/reference/connectors/mqtt_binding.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/reference/connectors/rest_binding.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/reference/connectors/semantic.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/reference/connectors/wiring.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/reference/index.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/reference/middleware.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/reference/modes.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/reference/observation.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/reference/possession.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/reference/projection.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/reference/registration.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/reference/rest_router.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/reference/shacl_interop/shape_from_typehints.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/reference/validation_report.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/reference/vocabulary.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/requirements.txt +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/docs/site/scenarios/index.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/examples/CONTEXT.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/examples/__init__.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/examples/docker/docker-compose.yml +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/examples/docker/graphdb-repo-config.ttl +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/examples/handlers.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/scripts/release_checks.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/__init__.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/_deprecation.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/commit.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/connectors/__init__.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/credentials.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/dashboard_logs.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/docs/mqtt-payloads.md +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/errors.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/examples_cli.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/modes.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/observation.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/projection.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/py.typed +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/rest_router.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/shacl_interop/__init__.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/static/htmx-2.0.4.min.js +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/static/json-enc.js +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/src/kapps_semantic_middleware/validation_report.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/_browser.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/_explicit.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/_hello_process.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/_refusal_view.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/_sse.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_algorithm_loop.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_children_take_the_fixture_dataset.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_core_names_no_possession.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_credentials.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_dashboard_guard.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_dashboard_logs.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_demo_activity_feed_wiring.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_demo_broker_transport.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_docs_footer_from_license.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_docs_landing_page.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_examples_cli.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_favicon_routes.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_heartbeat_phase.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_launcher_factory.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_launcher_index_guard.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_launcher_index_links.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_modes.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_no_deletion_of_individuals.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_no_pseudo_graph_in_queries.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_northbound_sync_integration.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_notification_handler.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_optional_transport_stacks.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_panel_convergence.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_persistence_factory_warning.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_plc_guard.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_public_errors.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_recursive_rest_router_integration.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_route_docstrings.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_scenario3_seed_integration.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_shipped_ontologies_declare_their_classes.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_southbound_echo_integration.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_station_board_read_view.py +0 -0
- {kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/tests/test_transfer_unit_plc.py +0 -0
|
@@ -36,7 +36,7 @@ without forward references.
|
|
|
36
36
|
| [`docs/mechanics/05-operation-coordination.md`](docs/mechanics/05-operation-coordination.md) | Dispatch, the issuer and the Issued Operation, the event trigger, notifications and the intake, pull-and-run, the status lifecycle, handover, recovery |
|
|
37
37
|
| [`docs/mechanics/06-views-and-projection.md`](docs/mechanics/06-views-and-projection.md) | Defining a ClassScope, what a view cannot select, what the northbound projection removes |
|
|
38
38
|
| [`docs/mechanics/07-writing-to-the-graph-and-to-devices.md`](docs/mechanics/07-writing-to-the-graph-and-to-devices.md) | Every path that causes a write, creating an instance and the predefined scopes, naming the field that moved, northbound vs. southbound, IRI handling |
|
|
39
|
-
| [`docs/mechanics/08-provisioning-and-seeding.md`](docs/mechanics/08-provisioning-and-seeding.md) | **Read first if `ogm=` is a mystery.** The bootstrap order, loading the shared ontologies, authoring the domain TBox, and seeding the instance data a Parameter needs |
|
|
39
|
+
| [`docs/mechanics/08-provisioning-and-seeding.md`](docs/mechanics/08-provisioning-and-seeding.md) | **Read first if `ogm=` is a mystery.** The bootstrap order, loading the shared ontologies, authoring the domain TBox, and seeding the instance data a Parameter needs (for a demonstration or test; a productive store already holds them) |
|
|
40
40
|
| [`docs/mechanics/09-the-state-dashboard.md`](docs/mechanics/09-the-state-dashboard.md) | The page an instance serves about itself, the box registry a subproject extends, hiding a box, posting to its own workflow, and the Logs tab with a logger's level set at run time |
|
|
41
41
|
|
|
42
42
|
### Where the reasoning lives
|
|
@@ -88,7 +88,8 @@ Binding internals, if you are adding a protocol, live under
|
|
|
88
88
|
`wiring`.
|
|
89
89
|
|
|
90
90
|
> `kapps_semantic_middleware/ontology/` is **not** a Python module. It is the directory holding the
|
|
91
|
-
> three vocabulary files (`core.ttl`, `mes.ttl`, `service.ttl`)
|
|
91
|
+
> three vocabulary files (`core.ttl`, `mes.ttl`, `service.ttl`) and the service ontology's SHACL
|
|
92
|
+
> shapes (`service-shapes.ttl`). Importing from it fails.
|
|
92
93
|
|
|
93
94
|
## Generic and circular-factory-specific modules
|
|
94
95
|
|
|
@@ -201,7 +202,7 @@ error on materialization merely because its restriction declares `owl:someValues
|
|
|
201
202
|
triple means *unknown*, never *false*.
|
|
202
203
|
|
|
203
204
|
**Any prettified or shortened IRI is display only.** Production code carries fully back-resolvable
|
|
204
|
-
IRIs in their mangled form — REST path segments, datamodel field names, `svc:
|
|
205
|
+
IRIs in their mangled form — REST path segments, datamodel field names, `svc:hasEndpoint` triples. A
|
|
205
206
|
consumer that parses a displayed IRI, or round-trips one back into a query, gets a wrong answer
|
|
206
207
|
with no exception raised.
|
|
207
208
|
|
|
@@ -12,6 +12,68 @@ work lands, not at release time.
|
|
|
12
12
|
finding exactly one of it, and prose naming it is a second occurrence — which stopped a release
|
|
13
13
|
the first time this file was written.)
|
|
14
14
|
|
|
15
|
+
## 0.2.4 — 2026-10-23
|
|
16
|
+
|
|
17
|
+
### Changed
|
|
18
|
+
|
|
19
|
+
- The dashboard's title and heading read "<instance> Dashboard" (was "<instance> — dashboard").
|
|
20
|
+
- The dashboard's subtitle reads "Visualization of the middleware state".
|
|
21
|
+
- The activity page no longer has a subtitle; its heading stays.
|
|
22
|
+
- The library's own boxes no longer show the shortening note: an IRI cell shows its local name and
|
|
23
|
+
keeps the full IRI on hover. `SHORTENING_NOTE` stays importable with the same value for one
|
|
24
|
+
release; a later release removes it.
|
|
25
|
+
- The provisioning-and-seeding page, the README, the tests README and the docstrings of the seeding
|
|
26
|
+
helpers and the vocabulary say that the shipped ontologies and shapes seed demonstrations and
|
|
27
|
+
tests: a productive circular factory already holds them in its knowledge graph, and the
|
|
28
|
+
middleware never calls the seeding helpers. Documentation only; no behaviour changes.
|
|
29
|
+
- **Breaking: the service ontology's status property is renamed.** `svc:operationStatus` is now
|
|
30
|
+
`svc:hasOperationStatus`, so that a triple reads as a sentence ("op hasOperationStatus
|
|
31
|
+
queued"). There is no alias and no equivalence: stored data that carries the old name is not
|
|
32
|
+
read. Reload the shared graphs (`load_shared_ontologies(db, reload=True)`) before you run on
|
|
33
|
+
the new version; the seeds and the demonstrations do it now. The `OperationStatus` enum keeps
|
|
34
|
+
its name.
|
|
35
|
+
- **Breaking: eight more service-ontology properties are named as predicates.**
|
|
36
|
+
`svc:precondition`, `svc:outcome`, `svc:address`, `svc:endpoint`, `svc:lastHeartbeat`,
|
|
37
|
+
`svc:executionTimestamp`, `svc:executionResult` and `svc:failureState` are now
|
|
38
|
+
`svc:hasPrecondition`, `svc:hasOutcome`, `svc:hasAddress`, `svc:hasEndpoint`,
|
|
39
|
+
`svc:hasLastHeartbeat`, `svc:hasExecutionTimestamp`, `svc:hasExecutionResult` and
|
|
40
|
+
`svc:hasFailureState`. The vocabulary terms (`SVC.hasAddress` and so on) follow. There is no
|
|
41
|
+
alias and no equivalence: stored data that carries an old name is not read. Reload the shared
|
|
42
|
+
graphs (`load_shared_ontologies(db, reload=True)`) before you run on the new version; the
|
|
43
|
+
seeds and the demonstrations do it now. Names that already read as predicates stay.
|
|
44
|
+
- **Breaking: every ontology namespace uses `http://`.** The copied Core ontology, the service
|
|
45
|
+
and MES ontologies, the transfer-unit demo's CRC namespaces and the example namespaces change
|
|
46
|
+
their scheme from `https` to `http`, in step with the Core ontology. The shared named graphs
|
|
47
|
+
are named by these IRIs, so a reload writes new graphs and leaves the old `https` Core,
|
|
48
|
+
Service and MES graphs on the dataset: drop them once after you upgrade. Stored data that
|
|
49
|
+
carries the old namespaces is not read.
|
|
50
|
+
|
|
51
|
+
### Added
|
|
52
|
+
|
|
53
|
+
- **Every Operation has exactly one status, and a shipped shape states it.** The service ontology
|
|
54
|
+
now ships `service-shapes.ttl` (an interim name) beside `service.ttl`: one SHACL node shape that targets Core's
|
|
55
|
+
Operation class, so every subclass, with a property shape on `svc:hasOperationStatus`: at least
|
|
56
|
+
one, at most one, and one of `queued`, `running`, `done` and `failed`. A store that validates it
|
|
57
|
+
refuses at commit an Operation without a status, with two, or with another value; a refused
|
|
58
|
+
middleware commit shows in `mw.refused_writes` and in the log. A productive store already holds
|
|
59
|
+
its ontologies and shapes; the file is for seeding a demonstration or test store, and as
|
|
60
|
+
documentation. `seeding.read_service_shapes()` returns it and `seeding.set_service_shapes(db)`
|
|
61
|
+
sets it (both interim names); on a dataset without SHACL validation the second logs one line and
|
|
62
|
+
returns `False`. The examples' seeds and the transfer-unit demo's seed set it now, after they
|
|
63
|
+
clear the dataset. `shapes_set` replaces every shape: a caller with shapes of its own sends them
|
|
64
|
+
joined with these. The live tests run with it set for the session.
|
|
65
|
+
- **The factory demo's station board has a prewritten-query dropdown.** It fills the view
|
|
66
|
+
heuristic with All, Even-indexed or Odd-indexed TransferUnits, or a Custom starter. The default
|
|
67
|
+
view, and what "reset" restores, is now all live TransferUnits rather than the even-indexed
|
|
68
|
+
ones. `build_view_query` takes a `parity` argument ("all", "even", "odd").
|
|
69
|
+
|
|
70
|
+
### Changed
|
|
71
|
+
|
|
72
|
+
- **The shipped text and tests use the middleware's own vocabulary only.** Examples, test data and
|
|
73
|
+
recorded store reports that named another project's resources and operations now name neutral
|
|
74
|
+
ones (a drill, a planner, a transport line); the check that bans those names scans every
|
|
75
|
+
shipped file, and the changelog's unreleased section.
|
|
76
|
+
|
|
15
77
|
## 0.2.2 — 2026-10-21
|
|
16
78
|
|
|
17
79
|
- **kapps_semantic_middleware requires kapps-ogm 0.3.2 and kapps-triplestore-interface 2.2.2 or
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: kapps-semantic-middleware
|
|
3
|
-
Version: 0.2.
|
|
3
|
+
Version: 0.2.4
|
|
4
4
|
Summary: Semantic middleware for industrial data integration, built on transitional-sync-middleware
|
|
5
5
|
Author-email: Etienne Hoffmann <etienne.hoffmann@kit.edu>, Sören Weindel <soeren.weindel@kit.edu>
|
|
6
6
|
Maintainer-email: Etienne Hoffmann <etienne.hoffmann@kit.edu>, Sören Weindel <soeren.weindel@kit.edu>
|
|
@@ -61,6 +61,10 @@ You now have scenario 1 and scenario 2 (each as a `.py` and a `.ipynb`), the see
|
|
|
61
61
|
and a `docker/` directory. Add the `[notebooks]` extra if you want to open the `.ipynb` files in
|
|
62
62
|
Jupyter; the `.py` versions run with `[examples]` alone.
|
|
63
63
|
|
|
64
|
+
A productive circular factory already holds the shared ontologies and shapes in its knowledge graph;
|
|
65
|
+
the files shipped with the middleware seed the demonstrations and tests, and document the vocabulary. The examples
|
|
66
|
+
seed them into the throwaway store below.
|
|
67
|
+
|
|
64
68
|
<!-- vendor-check: off -- the local Docker store -->
|
|
65
69
|
### Start a GraphDB
|
|
66
70
|
|
|
@@ -36,6 +36,10 @@ You now have scenario 1 and scenario 2 (each as a `.py` and a `.ipynb`), the see
|
|
|
36
36
|
and a `docker/` directory. Add the `[notebooks]` extra if you want to open the `.ipynb` files in
|
|
37
37
|
Jupyter; the `.py` versions run with `[examples]` alone.
|
|
38
38
|
|
|
39
|
+
A productive circular factory already holds the shared ontologies and shapes in its knowledge graph;
|
|
40
|
+
the files shipped with the middleware seed the demonstrations and tests, and document the vocabulary. The examples
|
|
41
|
+
seed them into the throwaway store below.
|
|
42
|
+
|
|
39
43
|
<!-- vendor-check: off -- the local Docker store -->
|
|
40
44
|
### Start a GraphDB
|
|
41
45
|
|
{kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/CONTEXT.md
RENAMED
|
@@ -7,8 +7,7 @@ controller, and a person watches it from a browser. Each participant is a separa
|
|
|
7
7
|
|
|
8
8
|
**The demo observes.** In KAPPS a device changes only through a workflow of its service. This demo
|
|
9
9
|
has no unit workflows yet, so nothing in it writes to a device through a unit's served data model:
|
|
10
|
-
the controller reads, and the station board shows what it reads.
|
|
11
|
-
workflows after the paper.
|
|
10
|
+
the controller reads, and the station board shows what it reads.
|
|
12
11
|
|
|
13
12
|
Its decisions are development-repository material and do not ship; what they decided is
|
|
14
13
|
described, without the deliberation, in `docs/mechanics/`.
|
{kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/README.md
RENAMED
|
@@ -4,8 +4,7 @@ This demo builds a very small factory on your computer and lets you watch it fro
|
|
|
4
4
|
|
|
5
5
|
**The demo observes.** In KAPPS a machine changes only through a workflow of its service. This
|
|
6
6
|
demo has no machine workflows yet, so the control station reads the machines and changes none.
|
|
7
|
-
|
|
8
|
-
itself, on its own panel page.
|
|
7
|
+
You can still move a belt at the machine itself, on its own panel page.
|
|
9
8
|
|
|
10
9
|
Nothing here is real hardware. Every machine is a Python program that pretends to be one. But the
|
|
11
10
|
parts talk to each other the same way real ones would, so what you see is the real behaviour.
|
|
@@ -33,6 +32,10 @@ machine and it disappears from the screen. Nothing is hardcoded.
|
|
|
33
32
|
|
|
34
33
|
## Before you start
|
|
35
34
|
|
|
35
|
+
A productive circular factory already holds the shared ontologies and shapes in its knowledge graph;
|
|
36
|
+
the files shipped with the middleware seed the demonstrations and tests, and document the
|
|
37
|
+
vocabulary. The launcher seeds the shipped ontologies and shapes for this demonstration.
|
|
38
|
+
|
|
36
39
|
You need three things.
|
|
37
40
|
|
|
38
41
|
### 1. Python and `uv`
|
|
@@ -184,7 +187,7 @@ The sweep also settles that machine's operations. Each machine has exactly one s
|
|
|
184
187
|
middleware, so when it is swept every operation of that machine that is still **queued** or
|
|
185
188
|
**running** is marked failed: nothing is left to run it. The control station is not affected: it
|
|
186
189
|
registers a service but no workflow, so it never has operations queued to it. The failed operations
|
|
187
|
-
are visible in the graph, as `svc:
|
|
190
|
+
are visible in the graph, as `svc:hasOperationStatus "failed"`, and the issuer of each is notified. The launcher page's
|
|
188
191
|
**watchdog** box shows only that the process is live; its output (click it if it turns red) and the
|
|
189
192
|
terminal show what it ran.
|
|
190
193
|
|
{kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/algorithm.py
RENAMED
|
@@ -17,7 +17,7 @@ The algorithm itself is deliberately meaningless -- it demonstrates reach, not r
|
|
|
17
17
|
control. When a light barrier's reading changes, it reads a barrier on one unit and the
|
|
18
18
|
conveyor speed of another, and logs both. **It observes and writes nothing.** In KAPPS a
|
|
19
19
|
device changes only through a workflow of its service; this demo has no unit workflows
|
|
20
|
-
yet, so it has no control to exercise.
|
|
20
|
+
yet, so it has no control to exercise.
|
|
21
21
|
A real material flow controller would route
|
|
22
22
|
parcels across units by reading barriers and deciding which unit to trigger; building one
|
|
23
23
|
is domain work, not middleware work. The graph carries no plant layout, so nothing here
|
|
@@ -113,23 +113,27 @@ def _barrier_snapshot(controller: Controller) -> Dict[str, Tuple[bool, ...]]:
|
|
|
113
113
|
return snapshot
|
|
114
114
|
|
|
115
115
|
|
|
116
|
-
def build_view_query() -> str:
|
|
117
|
-
"""Build the SPARQL SELECT query that finds live,
|
|
116
|
+
def build_view_query(parity: str = "all") -> str:
|
|
117
|
+
"""Build the SPARQL SELECT query that finds live TransferUnits, optionally by parity.
|
|
118
|
+
|
|
119
|
+
``parity`` is "all" (the default: every live unit, no parity filter), "even" or "odd".
|
|
120
|
+
The station board's prewritten-query dropdown reaches this through
|
|
121
|
+
:func:`named_view_queries`, and "All TransferUnits" is the board's default view.
|
|
118
122
|
|
|
119
123
|
This realizes the Control Expert's step 1: the view is the query, and the query text supplies
|
|
120
124
|
the domain class and any heuristic. ``Controller.view()`` runs this verbatim and
|
|
121
125
|
returns every IRI it binds to ``?resource``. Nothing in ``controller.py`` assumes
|
|
122
126
|
a domain class or a column beyond ``?resource`` itself.
|
|
123
127
|
|
|
124
|
-
The
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
+
The parity heuristics are deliberately arbitrary. "even" and "odd" each visibly return
|
|
129
|
+
roughly half the factory when N units are seeded, making the demo's behavior easy to
|
|
130
|
+
verify by inspection. A real algorithm would narrow by area of the plant, topology, or
|
|
131
|
+
workload instead.
|
|
128
132
|
|
|
129
|
-
Live means the resource's Service carries ``svc:
|
|
133
|
+
Live means the resource's Service carries ``svc:hasAddress``. The query joins from
|
|
130
134
|
``?resource`` to its Service via ``svc:isServiceOf``, then requires ``?addr`` to be
|
|
131
|
-
bound.
|
|
132
|
-
``...#TransferUnit4`` -> ``4``) and tested for
|
|
135
|
+
bound. For "even" and "odd" the unit index is extracted from the IRI's local name (e.g.
|
|
136
|
+
``...#TransferUnit4`` -> ``4``) and tested for parity arithmetically: SPARQL 1.1
|
|
133
137
|
has no ``%`` modulo operator, so this computes
|
|
134
138
|
``xsd:integer(?suffix) - 2 * FLOOR(xsd:integer(?suffix) / 2)``, which is 0 for an
|
|
135
139
|
even suffix and 1 for an odd one.
|
|
@@ -137,19 +141,50 @@ def build_view_query() -> str:
|
|
|
137
141
|
Returns:
|
|
138
142
|
A SPARQL ``SELECT ?resource`` query string.
|
|
139
143
|
"""
|
|
144
|
+
if parity == "all":
|
|
145
|
+
heuristic = ""
|
|
146
|
+
elif parity in ("even", "odd"):
|
|
147
|
+
target = "0" if parity == "even" else "1"
|
|
148
|
+
heuristic = (
|
|
149
|
+
'BIND(STRAFTER(STR(?resource), "#TransferUnit") AS ?suffix)\n'
|
|
150
|
+
' FILTER(?suffix != "" &&\n'
|
|
151
|
+
f" (xsd:integer(?suffix) - 2 * FLOOR(xsd:integer(?suffix) / 2)) = {target})"
|
|
152
|
+
)
|
|
153
|
+
else:
|
|
154
|
+
raise ValueError(f"parity must be 'all', 'even' or 'odd', got {parity!r}")
|
|
155
|
+
return _live_units_query(heuristic)
|
|
156
|
+
|
|
157
|
+
|
|
158
|
+
def _live_units_query(heuristic: str) -> str:
|
|
159
|
+
"""The fixed frame -- class plus liveness join -- around a heuristic clause."""
|
|
140
160
|
return f"""
|
|
141
161
|
PREFIX xsd: <http://www.w3.org/2001/XMLSchema#>
|
|
142
162
|
SELECT ?resource WHERE {{
|
|
143
163
|
?resource a <{seed.TRANSFER_UNIT_CLASS}> .
|
|
144
164
|
?svc <{SVC.isServiceOf}> ?resource .
|
|
145
|
-
?svc <{SVC.
|
|
146
|
-
|
|
147
|
-
FILTER(?suffix != "" &&
|
|
148
|
-
(xsd:integer(?suffix) - 2 * FLOOR(xsd:integer(?suffix) / 2)) = 0)
|
|
165
|
+
?svc <{SVC.hasAddress}> ?addr .
|
|
166
|
+
{heuristic}
|
|
149
167
|
}}
|
|
150
168
|
"""
|
|
151
169
|
|
|
152
170
|
|
|
171
|
+
def named_view_queries() -> list[dict[str, str]]:
|
|
172
|
+
"""Prewritten view heuristics for the station board's dropdown.
|
|
173
|
+
|
|
174
|
+
"All TransferUnits" first (the board's default and the target of "reset"), then the
|
|
175
|
+
even/odd parity pair, then a "Custom" starter the Control Expert edits into their own
|
|
176
|
+
heuristic. Each entry is a display name and a full ``SELECT ?resource`` query the board
|
|
177
|
+
drops verbatim into its query field.
|
|
178
|
+
"""
|
|
179
|
+
custom_starter = _live_units_query("# Add your own FILTER here.")
|
|
180
|
+
return [
|
|
181
|
+
{"name": "All TransferUnits", "query": build_view_query("all")},
|
|
182
|
+
{"name": "Even-indexed TransferUnits", "query": build_view_query("even")},
|
|
183
|
+
{"name": "Odd-indexed TransferUnits", "query": build_view_query("odd")},
|
|
184
|
+
{"name": "Custom — edit your own", "query": custom_starter},
|
|
185
|
+
]
|
|
186
|
+
|
|
187
|
+
|
|
153
188
|
def unit_class_scope() -> ClassScope:
|
|
154
189
|
"""Return the ClassScope that roots at tu:TransferUnit and reaches belt/barrier parameters.
|
|
155
190
|
|
|
@@ -149,7 +149,7 @@ async def main() -> None:
|
|
|
149
149
|
# the app's lifespan connecting everything (Controller.wire_view's own docstring).
|
|
150
150
|
default_query = algorithm.build_view_query()
|
|
151
151
|
hits = controller.view(default_query)
|
|
152
|
-
logger.info("The view found %d live
|
|
152
|
+
logger.info("The view found %d live unit(s)", len(hits))
|
|
153
153
|
controller.wire_view(hits, class_scope=algorithm.unit_class_scope())
|
|
154
154
|
|
|
155
155
|
state = algorithm.AlgorithmState()
|
{kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/controller.py
RENAMED
|
@@ -9,7 +9,7 @@ Control Expert's steps (``CONTEXT.md``):
|
|
|
9
9
|
|
|
10
10
|
1. ``view()`` runs the caller's own SPARQL query -- the view -- and returns every IRI it
|
|
11
11
|
binds to ``?resource``. The query is the whole view: which class, which liveness join
|
|
12
|
-
(a live resource's Service carries ``svc:
|
|
12
|
+
(a live resource's Service carries ``svc:hasAddress``), and any heuristic that narrows it
|
|
13
13
|
further are authored by the caller. Nothing here assumes a domain class.
|
|
14
14
|
2. ``wire_view()`` runs ``ogm.fetch`` per hit and recognizes its interface-accessible
|
|
15
15
|
parameters, exactly like ``SemanticMiddleware.__init__`` does for its own resource --
|
|
@@ -23,7 +23,7 @@ Control Expert's steps (``CONTEXT.md``):
|
|
|
23
23
|
after construction and before the app's lifespan starts (before ``run_server``).
|
|
24
24
|
Connectors must exist before the lifespan connects them, so wiring cannot
|
|
25
25
|
wait for an async hook. Every connector it registers is a read leg: the controller's
|
|
26
|
-
connector
|
|
26
|
+
connector sync direction is ``TO_PERSISTENCE``, so recognition never builds a write leg, and
|
|
27
27
|
nothing here can send a PUT to a unit's served data model.
|
|
28
28
|
|
|
29
29
|
The controller still discovers resources by class IRI via ``discover_resources``,
|
|
@@ -80,8 +80,8 @@ class ResourceInfo:
|
|
|
80
80
|
resource_iri: The individual's IRI.
|
|
81
81
|
resource_type: The class IRI (e.g. tu:TransferUnit).
|
|
82
82
|
label: Human-readable label, if present.
|
|
83
|
-
address: The service's svc:
|
|
84
|
-
last_heartbeat: The service's svc:
|
|
83
|
+
address: The service's svc:hasAddress — presence means live, absence means offline.
|
|
84
|
+
last_heartbeat: The service's svc:hasLastHeartbeat timestamp, if present.
|
|
85
85
|
"""
|
|
86
86
|
|
|
87
87
|
resource_iri: IRI
|
|
@@ -94,14 +94,14 @@ class ResourceInfo:
|
|
|
94
94
|
"""Human-readable label, if present."""
|
|
95
95
|
|
|
96
96
|
address: Optional[str]
|
|
97
|
-
"""The service's svc:
|
|
97
|
+
"""The service's svc:hasAddress. Presence means live. Absence means offline."""
|
|
98
98
|
|
|
99
99
|
last_heartbeat: Optional[str]
|
|
100
|
-
"""The service's svc:
|
|
100
|
+
"""The service's svc:hasLastHeartbeat timestamp, if present."""
|
|
101
101
|
|
|
102
102
|
@property
|
|
103
103
|
def is_live(self) -> bool:
|
|
104
|
-
"""Live iff svc:
|
|
104
|
+
"""Live iff svc:hasAddress is present (MVP liveness)."""
|
|
105
105
|
return self.address is not None
|
|
106
106
|
|
|
107
107
|
|
|
@@ -135,7 +135,7 @@ class Controller(SemanticMiddleware):
|
|
|
135
135
|
``view()`` runs the caller's SPARQL query and returns the resource IRIs it binds.
|
|
136
136
|
``wire_view()`` recognizes each hit's interface-accessible parameters and registers
|
|
137
137
|
a reading REST connector for every one it finds -- reached over REST, never MQTT
|
|
138
|
-
(``_VIEW_REGISTRY`` excludes it), and never a write leg (the connector
|
|
138
|
+
(``_VIEW_REGISTRY`` excludes it), and never a write leg (the connector sync direction is
|
|
139
139
|
``TO_PERSISTENCE``). Loading happens on startup: each hit's pruned datamodel
|
|
140
140
|
materializes into ``self.units``, keyed by resource IRI string, and each read leg's
|
|
141
141
|
poll keeps it current. An algorithm reads those loaded objects directly.
|
|
@@ -226,7 +226,7 @@ class Controller(SemanticMiddleware):
|
|
|
226
226
|
# Its connectors come from the view, which does not exist yet at this point.
|
|
227
227
|
autoregister_connectors=False,
|
|
228
228
|
# Read legs only. `resolve_direction` takes the most restrictive of a
|
|
229
|
-
# parameter's access mode and this
|
|
229
|
+
# parameter's access mode and this sync direction, so even a read-write belt speed
|
|
230
230
|
# gets no write leg: the controller observes, and a device changes only
|
|
231
231
|
# through a workflow of its service.
|
|
232
232
|
connector_sync_direction=SyncDirection.TO_PERSISTENCE,
|
|
@@ -262,7 +262,7 @@ class Controller(SemanticMiddleware):
|
|
|
262
262
|
every IRI it binds to ``?resource``, in result order, deduplicated.
|
|
263
263
|
|
|
264
264
|
The query is the whole view. Which class, the liveness join (a live resource's
|
|
265
|
-
Service carries ``svc:
|
|
265
|
+
Service carries ``svc:hasAddress``), and any heuristic that narrows the result
|
|
266
266
|
further are all authored by the caller, in the query text. Nothing here assumes
|
|
267
267
|
a domain class or a column beyond ``?resource`` itself, so no rework here can
|
|
268
268
|
ever compile a domain class into the controller.
|
|
@@ -353,7 +353,7 @@ class Controller(SemanticMiddleware):
|
|
|
353
353
|
class_scope=class_scope,
|
|
354
354
|
resource_class=IRI(str(resource_class)) if resource_class is not None else None,
|
|
355
355
|
registry=registry,
|
|
356
|
-
|
|
356
|
+
sync_direction=self.connector_sync_direction,
|
|
357
357
|
autoregister=True,
|
|
358
358
|
ensure_transport=self.ensure_transport,
|
|
359
359
|
)
|
|
@@ -602,7 +602,7 @@ class Controller(SemanticMiddleware):
|
|
|
602
602
|
"""Whether a still-selected view hit is reachable, and the age of its last
|
|
603
603
|
heartbeat in seconds.
|
|
604
604
|
|
|
605
|
-
A cleanly stopped unit deregisters and drops its ``svc:
|
|
605
|
+
A cleanly stopped unit deregisters and drops its ``svc:hasAddress`` entirely, so
|
|
606
606
|
``view()`` stops selecting it -- ``rebuild_view`` sees it as a leaver, and its
|
|
607
607
|
card leaves within one poll. A ``kill -9``'d unit keeps its address: ``view()``
|
|
608
608
|
keeps selecting it, so it stays in ``self.units`` ("leave the unchanged alone"),
|
|
@@ -615,7 +615,7 @@ class Controller(SemanticMiddleware):
|
|
|
615
615
|
was ever recorded (unreachable is then ``True``).
|
|
616
616
|
"""
|
|
617
617
|
info = self._get_service_info(IRI(str(resource_iri)))
|
|
618
|
-
last_heartbeat = info.get("
|
|
618
|
+
last_heartbeat = info.get("hasLastHeartbeat")
|
|
619
619
|
if not last_heartbeat:
|
|
620
620
|
return True, None
|
|
621
621
|
try:
|
|
@@ -650,8 +650,8 @@ class Controller(SemanticMiddleware):
|
|
|
650
650
|
SELECT ?resource ?label ?svc ?addr ?hb WHERE {{
|
|
651
651
|
?resource a <{resource_class_iri}> .
|
|
652
652
|
OPTIONAL {{ ?svc <{SVC.isServiceOf}> ?resource . }}
|
|
653
|
-
OPTIONAL {{ ?svc <{SVC.
|
|
654
|
-
OPTIONAL {{ ?svc <{SVC.
|
|
653
|
+
OPTIONAL {{ ?svc <{SVC.hasAddress}> ?addr . }}
|
|
654
|
+
OPTIONAL {{ ?svc <{SVC.hasLastHeartbeat}> ?hb . }}
|
|
655
655
|
OPTIONAL {{ ?resource <{RDFS.label}> ?label . }}
|
|
656
656
|
}}
|
|
657
657
|
"""
|
|
@@ -694,23 +694,23 @@ class Controller(SemanticMiddleware):
|
|
|
694
694
|
"""Get the service metadata for a resource.
|
|
695
695
|
|
|
696
696
|
Queries the graph for the Service linked to this resource via svc:isServiceOf,
|
|
697
|
-
returning address and
|
|
697
|
+
returning address and hasLastHeartbeat.
|
|
698
698
|
|
|
699
699
|
Args:
|
|
700
700
|
resource_iri: The resource's IRI.
|
|
701
701
|
|
|
702
702
|
Returns:
|
|
703
|
-
Dict with 'address' and '
|
|
703
|
+
Dict with 'address' and 'hasLastHeartbeat' keys, both possibly None.
|
|
704
704
|
"""
|
|
705
|
-
result: Dict[str, Optional[str]] = {"address": None, "
|
|
705
|
+
result: Dict[str, Optional[str]] = {"address": None, "hasLastHeartbeat": None}
|
|
706
706
|
|
|
707
707
|
try:
|
|
708
708
|
# Query for the Service linked to this resource via svc:isServiceOf.
|
|
709
709
|
sparql = f"""
|
|
710
710
|
SELECT ?svc ?addr ?hb WHERE {{
|
|
711
711
|
?svc <{SVC.isServiceOf}> <{resource_iri}> .
|
|
712
|
-
OPTIONAL {{ ?svc <{SVC.
|
|
713
|
-
OPTIONAL {{ ?svc <{SVC.
|
|
712
|
+
OPTIONAL {{ ?svc <{SVC.hasAddress}> ?addr . }}
|
|
713
|
+
OPTIONAL {{ ?svc <{SVC.hasLastHeartbeat}> ?hb . }}
|
|
714
714
|
}}
|
|
715
715
|
"""
|
|
716
716
|
db_result = self.ogm.db.query(sparql, convert_bindings=True)
|
|
@@ -727,7 +727,7 @@ class Controller(SemanticMiddleware):
|
|
|
727
727
|
if addr_val is not None:
|
|
728
728
|
result["address"] = str(addr_val)
|
|
729
729
|
if hb_val is not None:
|
|
730
|
-
result["
|
|
730
|
+
result["hasLastHeartbeat"] = str(hb_val)
|
|
731
731
|
|
|
732
732
|
except Exception as e:
|
|
733
733
|
logger.debug("Failed to get service info for %s: %s", resource_iri, e)
|
{kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/factory.ttl
RENAMED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
@prefix owl: <http://www.w3.org/2002/07/owl#> .
|
|
2
2
|
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
|
|
3
3
|
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
|
|
4
|
-
@prefix cfc: <
|
|
5
|
-
@prefix svc: <
|
|
6
|
-
@prefix fac: <
|
|
4
|
+
@prefix cfc: <http://w3id.org/circularfactory/Core#> .
|
|
5
|
+
@prefix svc: <http://w3id.org/circularfactory/Service#> .
|
|
6
|
+
@prefix fac: <http://www.sfb1574.kit.edu/ontologies/Factory#> .
|
|
7
7
|
|
|
8
8
|
fac:ControlStation rdf:type owl:Class ;
|
|
9
9
|
rdfs:subClassOf cfc:Resource ;
|
{kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/index.py
RENAMED
|
@@ -124,7 +124,7 @@ TEACH = {
|
|
|
124
124
|
SOURCES = {
|
|
125
125
|
"pipe": "The Launcher read this address from one line of the process stdout. A PLC holds "
|
|
126
126
|
"no graph credentials, so it cannot announce itself any other way.",
|
|
127
|
-
"graph": "The Launcher read this address from svc:
|
|
127
|
+
"graph": "The Launcher read this address from svc:hasAddress in the knowledge graph. The "
|
|
128
128
|
"process wrote it there itself, when it registered its Service.",
|
|
129
129
|
"flag": "The Launcher chose this address, and it passed the address as a command-line "
|
|
130
130
|
"flag.",
|
{kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/launcher.py
RENAMED
|
@@ -403,11 +403,11 @@ def _spawn_watchdog(dataset: str) -> ChildHandle:
|
|
|
403
403
|
|
|
404
404
|
|
|
405
405
|
def _check_service_address(db: TripleStore, resource_iri: str) -> Optional[str]:
|
|
406
|
-
"""One-shot check of the graph for the svc:
|
|
406
|
+
"""One-shot check of the graph for the svc:hasAddress of a resource. No wait, no loop."""
|
|
407
407
|
sparql = f"""
|
|
408
408
|
SELECT ?addr WHERE {{
|
|
409
409
|
?svc <{SVC.isServiceOf}> <{resource_iri}> .
|
|
410
|
-
?svc <{SVC.
|
|
410
|
+
?svc <{SVC.hasAddress}> ?addr .
|
|
411
411
|
}}
|
|
412
412
|
"""
|
|
413
413
|
result = db.query(sparql, convert_bindings=True)
|
{kapps_semantic_middleware-0.2.2 → kapps_semantic_middleware-0.2.4}/demo/transferunits/seed.py
RENAMED
|
@@ -17,16 +17,20 @@ from kapps_ogm.utils.class_scope import ClassScope
|
|
|
17
17
|
from rdflib import Literal
|
|
18
18
|
from rdflib.namespace import RDF, RDFS
|
|
19
19
|
|
|
20
|
-
from kapps_semantic_middleware.seeding import
|
|
20
|
+
from kapps_semantic_middleware.seeding import (
|
|
21
|
+
clear_dataset,
|
|
22
|
+
load_shared_ontologies,
|
|
23
|
+
set_service_shapes,
|
|
24
|
+
)
|
|
21
25
|
from kapps_semantic_middleware.vocabulary import INF, SVC
|
|
22
26
|
|
|
23
27
|
|
|
24
28
|
# --- Namespaces ------------------------------------------------------------- #
|
|
25
29
|
|
|
26
|
-
TU_NS = "
|
|
27
|
-
TUI_NS = "
|
|
28
|
-
FAC_NS = "
|
|
29
|
-
FACI_NS = "
|
|
30
|
+
TU_NS = "http://www.sfb1574.kit.edu/ontologies/TransferUnit#"
|
|
31
|
+
TUI_NS = "http://www.sfb1574.kit.edu/ontologies/TransferUnitInstances#"
|
|
32
|
+
FAC_NS = "http://www.sfb1574.kit.edu/ontologies/Factory#"
|
|
33
|
+
FACI_NS = "http://www.sfb1574.kit.edu/ontologies/FactoryInstances#"
|
|
30
34
|
|
|
31
35
|
# --- Domain class and property IRIs (tu:) ------------------------------------ #
|
|
32
36
|
|
|
@@ -207,7 +211,8 @@ def _load_demo_ontologies(db) -> None:
|
|
|
207
211
|
|
|
208
212
|
|
|
209
213
|
def seed_factory(db, ogm, units: int) -> None:
|
|
210
|
-
"""Seed the factory: clear the default graph, load ontologies,
|
|
214
|
+
"""Seed the factory: clear the default graph, load ontologies, set the service ontology's
|
|
215
|
+
shapes, create N units plus one control station.
|
|
211
216
|
|
|
212
217
|
Args:
|
|
213
218
|
db: The store.
|
|
@@ -215,8 +220,9 @@ def seed_factory(db, ogm, units: int) -> None:
|
|
|
215
220
|
units: Number of TransferUnits to create (indices 1..units).
|
|
216
221
|
"""
|
|
217
222
|
clear_dataset(db)
|
|
218
|
-
load_shared_ontologies(db)
|
|
223
|
+
load_shared_ontologies(db, reload=True)
|
|
219
224
|
_load_demo_ontologies(db)
|
|
225
|
+
set_service_shapes(db)
|
|
220
226
|
|
|
221
227
|
for n in range(1, units + 1):
|
|
222
228
|
_create_transfer_unit(ogm, n)
|
|
@@ -230,8 +236,8 @@ def seed_factory(db, ogm, units: int) -> None:
|
|
|
230
236
|
def factory_is_live(db, max_age_seconds: float = 90.0) -> list[IRI]:
|
|
231
237
|
"""Check whether a factory is currently live in the graph.
|
|
232
238
|
|
|
233
|
-
A factory is live when any Service node carries both svc:
|
|
234
|
-
svc:
|
|
239
|
+
A factory is live when any Service node carries both svc:hasAddress and a
|
|
240
|
+
svc:hasLastHeartbeat within the staleness window. This inverts the query
|
|
235
241
|
shape from registration.find_stale_services (live is bound(?hb) and
|
|
236
242
|
fresh, not stale or absent).
|
|
237
243
|
|
|
@@ -247,8 +253,8 @@ def factory_is_live(db, max_age_seconds: float = 90.0) -> list[IRI]:
|
|
|
247
253
|
|
|
248
254
|
sparql = f"""
|
|
249
255
|
SELECT DISTINCT ?s WHERE {{
|
|
250
|
-
?s <{SVC.
|
|
251
|
-
?s <{SVC.
|
|
256
|
+
?s <{SVC.hasAddress}> ?addr .
|
|
257
|
+
?s <{SVC.hasLastHeartbeat}> ?hb .
|
|
252
258
|
FILTER (?hb >= "{cutoff_iso}"^^<http://www.w3.org/2001/XMLSchema#dateTime>)
|
|
253
259
|
}}
|
|
254
260
|
"""
|
|
@@ -7,8 +7,8 @@ panel.py onto a PLC's). The board reads controller.units and calls
|
|
|
7
7
|
controller.rebuild_view() in-process — no second server, no second event loop.
|
|
8
8
|
|
|
9
9
|
The board is a read-only view. It sends nothing to a unit: in KAPPS a device changes only
|
|
10
|
-
through a workflow of its service, and this demo has no unit workflows yet.
|
|
11
|
-
|
|
10
|
+
through a workflow of its service, and this demo has no unit workflows yet.
|
|
11
|
+
``tests/test_station_board_guard.py`` pins that no
|
|
12
12
|
demo file sends a write to a unit's served data model.
|
|
13
13
|
|
|
14
14
|
The split between this file (routes + template) and control_station.py (runner: argparse,
|
|
@@ -75,8 +75,10 @@ TEACH: Dict[str, Dict[str, str]] = {
|
|
|
75
75
|
"view-box": {
|
|
76
76
|
"title": "The editable view heuristic",
|
|
77
77
|
"what": "The frame (class and the ?resource/liveness join) is fixed; the "
|
|
78
|
-
"textarea is the Control Expert's own heuristic. \"
|
|
79
|
-
"
|
|
78
|
+
"textarea is the Control Expert's own heuristic. The \"Prewritten query\" dropdown "
|
|
79
|
+
"fills it with All, Even-indexed, Odd-indexed or a Custom starter; the \"All\" "
|
|
80
|
+
"entry is the default. \"run\" rebuilds immediately; "
|
|
81
|
+
"\"reset\" restores that default. A malformed query or a zero-hit "
|
|
80
82
|
"one is reported here, in place -- neither ever 500s the page.",
|
|
81
83
|
"file": "demo/transferunits/controller.py",
|
|
82
84
|
},
|
|
@@ -263,7 +265,9 @@ def mount_onto(
|
|
|
263
265
|
index.py's boxes, so it carries its own dict rather than importing that one)."""
|
|
264
266
|
template_path = Path(__file__).parent / "templates" / "station_board.html"
|
|
265
267
|
page = template_path.read_text(encoding="utf-8")
|
|
266
|
-
|
|
268
|
+
page = page.replace("__TEACH__", json.dumps(TEACH))
|
|
269
|
+
page = page.replace("__QUERIES__", json.dumps(algorithm.named_view_queries()))
|
|
270
|
+
return HTMLResponse(page)
|
|
267
271
|
|
|
268
272
|
# Reset OpenAPI schema so /docs and /openapi.json describe the routes that actually exist.
|
|
269
273
|
app.openapi_schema = None
|
|
@@ -373,7 +377,7 @@ def mount_onto(
|
|
|
373
377
|
# still has the peer's broker address in `ParameterBinding.metadata` for
|
|
374
378
|
# the life of the process. Fixing that needs kapps_ogm to fetch a
|
|
375
379
|
# parameter node partially, which it cannot do yet; accepted until it can.
|
|
376
|
-
rendered_elsewhere = {str(INF.accessMode), str(SVC.
|
|
380
|
+
rendered_elsewhere = {str(INF.accessMode), str(SVC.hasAddress)}
|
|
377
381
|
facets: Dict[str, Any] = {}
|
|
378
382
|
for key, val in binding.metadata.items():
|
|
379
383
|
if key in rendered_elsewhere or key in pruned_set:
|