@memoarchitect/ontology 0.20.3 → 0.22.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 (115) hide show
  1. package/README.md +1 -1
  2. package/examples/functional-logical-physical/model/catalog/functional_logical_physical.sysml +2 -3
  3. package/examples/gpca-pump/memo.identity.yaml +14 -13
  4. package/examples/gpca-pump/model/catalog/gpca_behavior_actions.sysml +44 -63
  5. package/examples/gpca-pump/model/catalog/gpca_context.sysml +4 -0
  6. package/examples/gpca-pump/model/catalog/gpca_operational.sysml +8 -0
  7. package/examples/gpca-pump/model/catalog/gpca_system.sysml +2 -0
  8. package/examples/gpca-pump/model/catalog/gpca_verification.sysml +2 -2
  9. package/examples/gpca-pump/model/catalog/viewpoints/logical/views/behavior_action_flow_view.sysml +1 -1
  10. package/examples/reusable-instrument/model/catalog/reusable_instrument.sysml +6 -0
  11. package/examples/surgical-closure-workflow/model/catalog/surgical_closure_workflow.sysml +8 -0
  12. package/examples/temperature-alarm/model/catalog/temperature_alarm.sysml +2 -0
  13. package/extensions/aadl/memo.package.yaml +1 -1
  14. package/extensions/aadl/src/runtime/memo_aadl_runtime.sysml +4 -0
  15. package/extensions/anatomy/memo.package.yaml +1 -1
  16. package/extensions/anatomy/src/selector/memo_extension_anatomy_selector.sysml +1 -0
  17. package/extensions/anatomy/src/vocabulary/memo_extension_anatomy_vocabulary.sysml +1 -0
  18. package/extensions/clinical/memo.package.yaml +1 -1
  19. package/extensions/clinical/src/procedures/memo_clinical_procedures.sysml +1 -0
  20. package/extensions/cloud/memo.package.yaml +1 -1
  21. package/extensions/cloud/src/cloud_extension.sysml +3 -0
  22. package/extensions/container/memo.package.yaml +1 -1
  23. package/extensions/container/src/container_extension.sysml +3 -0
  24. package/extensions/messaging/memo.package.yaml +1 -1
  25. package/extensions/messaging/src/messaging_extension.sysml +5 -0
  26. package/extensions/ros/memo.package.yaml +1 -1
  27. package/extensions/ros/src/ros_extension.sysml +58 -15
  28. package/methodologies/default/memo.package.yaml +1 -1
  29. package/methodologies/gpca/memo.package.yaml +1 -1
  30. package/ontology/memo.package.yaml +1 -1
  31. package/package.json +1 -1
  32. package/profile/memo.package.yaml +1 -1
  33. package/src/architecture/decisions/memo_decisions.sysml +9 -2
  34. package/src/architecture/functional/behavior/memo_behavior.sysml +21 -26
  35. package/src/architecture/functional/functions/memo_functions.sysml +10 -2
  36. package/src/architecture/implementation/hardware/common/memo_hardware_common.sysml +15 -4
  37. package/src/architecture/implementation/hardware/electrical/memo_hardware_electrical.sysml +8 -0
  38. package/src/architecture/implementation/hardware/fluidic/memo_hardware_fluidic.sysml +3 -0
  39. package/src/architecture/implementation/hardware/mechanical/memo_hardware_mechanical.sysml +3 -0
  40. package/src/architecture/implementation/hardware/optical/memo_hardware_optical.sysml +2 -0
  41. package/src/architecture/implementation/hardware/sensing/memo_hardware_sensing.sysml +3 -0
  42. package/src/architecture/implementation/software/runtime/memo_software_runtime.sysml +2 -0
  43. package/src/architecture/implementation/software/structure/memo_software_structure.sysml +12 -0
  44. package/src/architecture/implementation/ui/memo_ui.sysml +14 -0
  45. package/src/architecture/logical/interfaces/memo_interfaces.sysml +11 -2
  46. package/src/architecture/logical/structure/memo_logical_structure.sysml +16 -1
  47. package/src/architecture/operational/activities/memo_activities.sysml +3 -0
  48. package/src/architecture/operational/context/actors/memo_actors.sysml +5 -1
  49. package/src/architecture/operational/context/stakeholders/memo_stakeholders.sysml +4 -0
  50. package/src/architecture/operational/context/use_context/memo_use_context.sysml +5 -0
  51. package/src/architecture/operational/scenarios/memo_scenarios.sysml +1 -0
  52. package/src/architecture/operational/structure/memo_operational.sysml +5 -0
  53. package/src/architecture/operational/use_cases/memo_use_cases.sysml +4 -0
  54. package/src/architecture/operational/workflows/memo_workflows.sysml +5 -0
  55. package/src/architecture/realization/deployment/memo_deployment.sysml +12 -0
  56. package/src/architecture/realization/physical/memo_physical_architecture.sysml +6 -0
  57. package/src/architecture/variability/memo_variability.sysml +6 -0
  58. package/src/artifacts/configuration_management/memo_configuration_management.sysml +16 -0
  59. package/src/artifacts/core/memo_controlled_artifacts.sysml +16 -6
  60. package/src/artifacts/definitions/memo_artifact_definitions.sysml +1 -0
  61. package/src/artifacts/documents/risk_management/memo_risk_management.sysml +2 -0
  62. package/src/artifacts/standards/memo_artifacts_standards_traceability.sysml +4 -0
  63. package/src/assurance/cybersecurity/memo_cybersecurity.sysml +36 -0
  64. package/src/assurance/human_factors/memo_human_factors.sysml +4 -0
  65. package/src/assurance/requirements/memo_requirements.sysml +5 -1
  66. package/src/assurance/requirements/needs/memo_needs.sysml +2 -0
  67. package/src/assurance/safety_risk/analysis/memo_fmea.sysml +19 -0
  68. package/src/assurance/safety_risk/memo_risk.sysml +25 -1
  69. package/src/assurance/safety_risk/postmarket_surveillance/memo_postmarket_surveillance.sysml +2 -0
  70. package/src/assurance/verification_validation/clinical_evaluation/memo_clinical_evaluation.sysml +1 -0
  71. package/src/assurance/verification_validation/memo_assurance.sysml +5 -0
  72. package/src/core/annotations/memo_annotations.sysml +7 -0
  73. package/src/core/common/memo_common.sysml +28 -4
  74. package/src/core/consistency_rules/consistency_rules.sysml +5 -0
  75. package/src/core/enumerations/memo_enumerations.sysml +0 -5
  76. package/src/core/methodology_scope/methodology_scope.sysml +1 -0
  77. package/src/core/relationships/memo_relationships.sysml +9 -0
  78. package/src/core/relationships/memo_workspace_membership.sysml +1 -0
  79. package/src/methodology/core/memo_core.sysml +9 -0
  80. package/src/methodology/gates/memo_gates.sysml +1 -0
  81. package/src/methodology/patterns/memo_patterns.sysml +1 -0
  82. package/src/methodology/profiles/memo_profiles.sysml +2 -2
  83. package/src/methodology/rules/memo_rules.sysml +2 -0
  84. package/src/methodology/workflow/memo_workflow.sysml +3 -0
  85. package/src/rules/ontology/ontology_invariants.sysml +16 -2
  86. package/src/viewpoints/catalog/memo_viewpoint_catalog.sysml +1 -0
  87. package/src/viewpoints/clinical/clinical_viewpoint.sysml +1 -1
  88. package/src/viewpoints/clinical/views/clinical_evidence_view/clinical_evidence_view.sysml +2 -0
  89. package/src/viewpoints/clinical_workflow/clinical_workflow_viewpoint.sysml +1 -1
  90. package/src/viewpoints/context/context_viewpoint.sysml +1 -1
  91. package/src/viewpoints/cybersecurity/cybersecurity_viewpoint.sysml +1 -1
  92. package/src/viewpoints/cybersecurity/views/cybersecurity_assessment_view/cybersecurity_assessment_view.sysml +2 -0
  93. package/src/viewpoints/cybersecurity/views/threat_model_view/threat_model_view.sysml +2 -0
  94. package/src/viewpoints/definitions/memo_viewpoint_definitions.sysml +10 -0
  95. package/src/viewpoints/functional/functional_viewpoint.sysml +1 -1
  96. package/src/viewpoints/logical/logical_viewpoint.sysml +1 -1
  97. package/src/viewpoints/matrix/memo_matrix_views.sysml +4 -2
  98. package/src/viewpoints/operational/operational_viewpoint.sysml +1 -1
  99. package/src/viewpoints/physical/physical_viewpoint.sysml +1 -1
  100. package/src/viewpoints/rendering/memo_rendering.sysml +3 -0
  101. package/src/viewpoints/requirements/requirements_viewpoint.sysml +1 -1
  102. package/src/viewpoints/risk/risk_viewpoint.sysml +1 -1
  103. package/src/viewpoints/software/software_viewpoint.sysml +1 -1
  104. package/src/viewpoints/stakeholders_concerns/memo_stakeholders_concerns.sysml +30 -35
  105. package/src/viewpoints/ui_layout/ui_layout_viewpoint.sysml +1 -1
  106. package/src/viewpoints/ui_layout/views/screen_layout_view/screen_layout_view.sysml +1 -1
  107. package/src/viewpoints/usability/usability_viewpoint.sysml +1 -1
  108. package/src/viewpoints/usability/views/usability_engineering_view/usability_engineering_view.sysml +2 -0
  109. package/src/viewpoints/verification/verification_viewpoint.sysml +1 -1
  110. package/stage1/opensysml-38b58af8f1ce330053e05f1e.json.gz +0 -0
  111. package/stage1/syside-ca5c563522d5f99a57a61152.ids.gz +0 -0
  112. package/stage1/syside-ca5c563522d5f99a57a61152.json.gz +0 -0
  113. package/stage1/opensysml-7c0d12db5d05ad61e9477e5f.json.gz +0 -0
  114. package/stage1/syside-7ec66db3391721ce52f5c658.ids.gz +0 -0
  115. package/stage1/syside-7ec66db3391721ce52f5c658.json.gz +0 -0
package/README.md CHANGED
@@ -25,7 +25,7 @@ pin an exact release; the package has no repository or runtime dependency on Mem
25
25
  Tools or Memo Architect.
26
26
 
27
27
  ```bash
28
- pnpm add @memoarchitect/ontology@0.20.3
28
+ pnpm add @memoarchitect/ontology@0.22.0
29
29
  ```
30
30
 
31
31
  > **Pre-1.0 notice:** ontology names, relationships, and package layout may
@@ -5,7 +5,6 @@
5
5
  package memo_examples_functional_logical_physical {
6
6
  private import memo::*;
7
7
  private import ScalarValues::*;
8
- private import ModelingMetadata::*;
9
8
 
10
9
 
11
10
  part def FunctionalLogicalPhysicalSystem specializes memo_architecture_logical_structure::System {
@@ -42,8 +41,8 @@ package memo_examples_functional_logical_physical {
42
41
  attribute :>> mechanicalFunction = "vents line pressure above mechanical set point, independent of software";
43
42
  attribute :>> patientContact = false;
44
43
  }
45
- #refinement dependency swPressureSupervisor to lcPressureProtection;
46
- #refinement dependency mechReliefValve to lcPressureProtection;
44
+ allocation : RealizedBy allocate lcPressureProtection to swPressureSupervisor;
45
+ allocation : RealizedBy allocate lcPressureProtection to mechReliefValve;
47
46
  // Illustrative: authored for this example, not the record of a real evaluation.
48
47
  verification vcAuthoredSwPressureSupervisor : VerificationCase {
49
48
  @MemoIdentity { :>> providedId = "FLP-VC-A01"; :>> label = "Verify pressure supervisor"; }
@@ -721,32 +721,33 @@ elements:
721
721
  shortId: "ACT-15"
722
722
  uuid: "c614903b-3ee1-53b9-b1eb-3642cdb47490"
723
723
  "memo_examples_gpca_pump_gpca_behavior_actions::infusionDeliveryFlow":
724
- shortId: "ACT-16"
724
+ shortId: "FNC-24"
725
725
  uuid: "a3c8d1c2-9b05-5f68-9853-3150571a55b0"
726
+ retired: "ACT-16"
726
727
  "memo_examples_gpca_pump_gpca_behavior_actions::infusionDeliveryFlow::acquireSensors":
727
- shortId: "FNC-17:1"
728
+ shortId: "ACT-40"
728
729
  uuid: "ca87ba1e-a66f-5ada-bb20-162099acdc1c"
729
- retired: "ACT-2"
730
+ retired: "ACT-2,FNC-17:1"
730
731
  "memo_examples_gpca_pump_gpca_behavior_actions::infusionDeliveryFlow::actuateMotor":
731
- shortId: "FNC-18:1"
732
+ shortId: "ACT-41"
732
733
  uuid: "7c5e0fbd-2c4a-530e-b1d7-f081e968d97e"
733
- retired: "ACT-3"
734
+ retired: "ACT-3,FNC-18:1"
734
735
  "memo_examples_gpca_pump_gpca_behavior_actions::infusionDeliveryFlow::computeFlow":
735
- shortId: "FNC-19:1"
736
+ shortId: "ACT-42"
736
737
  uuid: "30378bcd-5e3a-5c8b-b3b4-c161dc9e1d05"
737
- retired: "ACT-8"
738
+ retired: "ACT-8,FNC-19:1"
738
739
  "memo_examples_gpca_pump_gpca_behavior_actions::infusionDeliveryFlow::enforceLimits":
739
- shortId: "FNC-20:1"
740
+ shortId: "ACT-43"
740
741
  uuid: "069e53f7-6c9e-5320-8d58-46a100dbbb49"
741
- retired: "ACT-13"
742
+ retired: "ACT-13,FNC-20:1"
742
743
  "memo_examples_gpca_pump_gpca_behavior_actions::infusionDeliveryFlow::evaluateAlarms":
743
- shortId: "FNC-21:1"
744
+ shortId: "ACT-44"
744
745
  uuid: "c614903b-3ee1-53b9-b1eb-3642cdb47490"
745
- retired: "ACT-15"
746
+ retired: "ACT-15,FNC-21:1"
746
747
  "memo_examples_gpca_pump_gpca_behavior_actions::infusionDeliveryFlow::logEvent":
747
- shortId: "FNC-22:1"
748
+ shortId: "ACT-45"
748
749
  uuid: "7028388e-e31d-51c2-946f-44cf088f5fdd"
749
- retired: "ACT-17"
750
+ retired: "ACT-17,FNC-22:1"
750
751
  "memo_examples_gpca_pump_gpca_behavior_actions::logEvent":
751
752
  shortId: "ACT-17"
752
753
  uuid: "7028388e-e31d-51c2-946f-44cf088f5fdd"
@@ -6,71 +6,52 @@ package memo_examples_gpca_pump_gpca_behavior_actions {
6
6
  private import memo_examples_gpca_pump_gpca_behavior_subsystems::*;
7
7
 
8
8
  // ═════════════════════════════════════════════════════════════
9
- // GPCA infusion delivery action flow (KK-4 exemplar).
10
- // The 20 ms execution-step pipeline from sensor acquisition
11
- // through alarm evaluation and dose limiting to pump actuation
12
- // and event logging — the behavioral realization of FC-001/
13
- // FC-002 over FUNC-001..008. Item types reference the exchange
14
- // item definitions in gpca_behavior_subsystems (DD-002/DD-003,
15
- // CD-001/CD-002, DD-004).
9
+ // GPCA infusion delivery chain: the 20 ms execution-step pipeline from
10
+ // sensor acquisition through alarm evaluation and dose limiting to pump
11
+ // actuation and event logging. Written like the chains in gpca_system: each
12
+ // step is its function performed at one position (`action <step> :>
13
+ // <function>`), each item it handles is a step-local parameter subsetting
14
+ // the exchange item in gpca_behavior_subsystems, and a `flow` joins two
15
+ // steps where one's output is the next one's input. A step's parameters
16
+ // redefine its function's in declaration order.
16
17
  // ═════════════════════════════════════════════════════════════
18
+ action infusionDeliveryFlow : FunctionalFlow {
19
+ @MemoIdentity { :>> providedId = "FC-004"; :>> label = "Infusion delivery chain"; }
20
+ attribute :>> flowCategory = FunctionalFlowKind::nominal;
21
+ attribute :>> endToEndLatencyBudgetMs = 20 [milli*s];
22
+ attribute :>> safetyRelevant = true;
23
+ attribute :>> securityRelevant = false;
24
+ doc /* One 20 ms execution step: sensors to alarm evaluation and dose limiting, then the flow command, pump actuation and the event log. */
25
+ action acquireSensors :> fnAcquireSensors {
26
+ out item sensorVector :> ddSensorVector;
27
+ }
28
+ action evaluateAlarms :> fnMonitorAlarm {
29
+ in item sensorVector :> ddSensorVector;
30
+ out item alarmSignal :> cdAlarmSignal;
31
+ }
32
+ action enforceLimits :> fnEnforceLimits {
33
+ in item bolusRequest :> ddBolusRequest;
34
+ out item authorizedBolus :> ddBolusRequest;
35
+ }
36
+ action computeFlow :> fnManageInfusion {
37
+ out item flowCommand :> cdFlowCommand;
38
+ in item alarmSignal :> cdAlarmSignal;
39
+ in item authorizedBolus :> ddBolusRequest;
40
+ }
41
+ action actuateMotor :> fnCommandPump {
42
+ in item flowCommand :> cdFlowCommand;
43
+ out item actuation :> cdFlowCommand;
44
+ }
45
+ action logEvent :> fnLogEvents {
46
+ in item actuation :> cdFlowCommand;
47
+ out item eventRecord :> ddEventRecord;
48
+ }
17
49
 
18
- // ── Action definitions (typed steps with parameters) ────────
19
- item def SensorStatusVector specializes InterfaceItem {
20
- attribute :>> itemKind = InterfaceItemKind::data;
21
- }
22
- item def AlarmSignal specializes InterfaceItem {
23
- attribute :>> itemKind = InterfaceItemKind::signal;
24
- }
25
- item def BolusRequestSignal specializes InterfaceItem {
26
- attribute :>> itemKind = InterfaceItemKind::signal;
27
- }
28
- item def FlowCommand specializes InterfaceItem {
29
- attribute :>> itemKind = InterfaceItemKind::command;
30
- }
31
- item def TherapyEventRecord specializes InterfaceItem {
32
- attribute :>> itemKind = InterfaceItemKind::'event';
33
- }
34
-
35
- action def AcquireSensorData :> FunctionalAction {
36
- out sensorStatus : SensorStatusVector;
37
- }
38
- action def EvaluateAlarmConditions :> FunctionalAction {
39
- in sensorStatus : SensorStatusVector;
40
- out alarmSignal : AlarmSignal;
41
- }
42
- action def EnforceDoseLimits :> FunctionalAction {
43
- in bolusRequest : BolusRequestSignal;
44
- out authorizedBolus : BolusRequestSignal;
45
- }
46
- action def ComputeFlowCommand :> FunctionalAction {
47
- in alarmSignal : AlarmSignal;
48
- in authorizedBolus : BolusRequestSignal;
49
- out flowCommand : FlowCommand;
50
- }
51
- action def ActuatePumpMotor :> FunctionalAction {
52
- in flowCommand : FlowCommand;
53
- out actuation : FlowCommand;
54
- }
55
- action def LogTherapyEvent :> FunctionalAction {
56
- in actuation : FlowCommand;
57
- out eventRecord : TherapyEventRecord;
58
- }
59
-
60
- // ── Infusion delivery flow (composite action) ───────────────
61
- action infusionDeliveryFlow {
62
- action acquireSensors : AcquireSensorData;
63
- action evaluateAlarms : EvaluateAlarmConditions;
64
- action enforceLimits : EnforceDoseLimits;
65
- action computeFlow : ComputeFlowCommand;
66
- action actuateMotor : ActuatePumpMotor;
67
- action logEvent : LogTherapyEvent;
68
-
69
- flow sensorStatusVectorFlow of SensorStatusVector from acquireSensors.sensorStatus to evaluateAlarms.sensorStatus;
70
- flow alarmSignalFlow of AlarmSignal from evaluateAlarms.alarmSignal to computeFlow.alarmSignal;
71
- flow bolusRequestSignalFlow of BolusRequestSignal from enforceLimits.authorizedBolus to computeFlow.authorizedBolus;
72
- flow flowCommandToActuateMotor of FlowCommand from computeFlow.flowCommand to actuateMotor.flowCommand;
73
- flow flowCommandToLogEvent of FlowCommand from actuateMotor.actuation to logEvent.actuation;
50
+ flow from acquireSensors.sensorVector to evaluateAlarms.sensorVector;
51
+ flow from evaluateAlarms.alarmSignal to computeFlow.alarmSignal;
52
+ flow from enforceLimits.authorizedBolus to computeFlow.authorizedBolus;
53
+ flow from computeFlow.flowCommand to actuateMotor.flowCommand;
54
+ flow from actuateMotor.actuation to logEvent.actuation;
74
55
 
75
56
  first start then acquireSensors;
76
57
  first acquireSensors then evaluateAlarms;
@@ -5,6 +5,7 @@ package memo_examples_gpca_pump_gpca_context {
5
5
  private import memo_examples_gpca_pump_gpca_operational::*;
6
6
 
7
7
  // ── Intended use (ISO 14971 §5.2, IEC 62366-1) ──────────────
8
+ // --8<-- [start:intended-use]
8
9
  requirement gpcaIntendedUse : IntendedUse {
9
10
  @MemoIdentity { :>> providedId = "IU-001"; :>> shortDescription = "Patient-controlled analgesia infusion of prescribed opioid analgesics."; }
10
11
  doc /* The GPCA pump delivers a prescribed analgesic drug intravenously at a programmed basal rate, supplemented by square boluses delivered automatically at programmed intervals and by patient-requested bolus doses, subject to lockout intervals and maximum-dose limits. */
@@ -18,6 +19,8 @@ package memo_examples_gpca_pump_gpca_context {
18
19
  attribute :>> operationalContext = "Acute-care hospital ward, fixed (non-ambulatory) location (UC-001).";
19
20
  @MemoIdentity { :>> sourceReference = "CITE-001: CriSys GPCA System Requirements (2013), §2.1-2.3 (GPCA overview, system functions, user characteristics)"; }
20
21
  }
22
+ // --8<-- [end:intended-use]
23
+ // --8<-- [start:misuse]
21
24
  part bolusByProxyMisuse : ReasonablyForeseeableMisuse {
22
25
  @MemoIdentity { :>> providedId = "RFM-001"; :>> label = "Bolus request by someone other than patient"; :>> shortDescription = "A caregiver or visitor presses the patient bolus control."; }
23
26
  doc /* A person other than the patient activates the bolus request control, bypassing the intended patient self-limiting behavior. */
@@ -26,6 +29,7 @@ package memo_examples_gpca_pump_gpca_context {
26
29
  attribute :>> affectedUseContext = "UC-001";
27
30
  @MemoIdentity { :>> sourceReference = "CITE-004: GIP Hazard Analysis v1.0 (2009), §2.4.8; CITE-005: Open PCA ISO 14971 risk analysis, bolus-by-proxy event"; }
28
31
  }
32
+ // --8<-- [end:misuse]
29
33
 
30
34
  // ── Use contexts ────────────────────────────────────────────
31
35
  part hospitalWardContext : UseContext {
@@ -135,6 +135,7 @@ package memo_examples_gpca_pump_gpca_operational {
135
135
  // ── Scenario-driven operational model ──────────────────────
136
136
  // The use case is the patient and clinician goal. It is supported by
137
137
  // several workflows, each of which owns multiple selected scenarios.
138
+ // --8<-- [start:use-case]
138
139
  use case ucDeliverPcaTherapy : SystemUseCase {
139
140
  attribute :>> useCaseKind = UseCaseKind::care;
140
141
  @MemoIdentity { :>> providedId = "UC-001"; :>> label = "Deliver patient controlled analgesia"; }
@@ -148,6 +149,7 @@ package memo_examples_gpca_pump_gpca_operational {
148
149
  actor prescriberActor = actorPrescriber;
149
150
  actor pharmacistActor = actorPharmacist;
150
151
  }
152
+ // --8<-- [end:use-case]
151
153
 
152
154
  part wfPrepareAndStartTherapy : SystemWorkflow {
153
155
  @MemoIdentity { :>> label = "Prepare and start therapy"; }
@@ -172,6 +174,7 @@ package memo_examples_gpca_pump_gpca_operational {
172
174
  first start then deliverWithinLimits; first deliverWithinLimits then recordTherapyEvent; first recordTherapyEvent then done;
173
175
  }
174
176
  }
177
+ // --8<-- [start:lockout-scenario]
175
178
  action osLockoutBolus : OperativeScenario {
176
179
  attribute :>> scenarioKind = ScenarioKind::alternate;
177
180
  @MemoIdentity { :>> providedId = "OS-002"; :>> label = "Bolus request during lockout"; }
@@ -186,6 +189,7 @@ package memo_examples_gpca_pump_gpca_operational {
186
189
  first start then checkLockout; first checkLockout then rejectAndLog; first rejectAndLog then done;
187
190
  }
188
191
  }
192
+ // --8<-- [end:lockout-scenario]
189
193
  }
190
194
  part wfRespondToTherapyAlarm : SystemWorkflow {
191
195
  @MemoIdentity { :>> label = "Respond to therapy alarm"; }
@@ -267,16 +271,20 @@ package memo_examples_gpca_pump_gpca_operational {
267
271
 
268
272
  // ── Operational scenarios ───────────────────────────────────
269
273
  #refinement dependency wfManageActiveTherapy::osNominalTherapy to ucDeliverPcaTherapy;
274
+ // --8<-- [start:lockout-refines]
270
275
  #refinement dependency wfManageActiveTherapy::osLockoutBolus to ucDeliverPcaTherapy;
276
+ // --8<-- [end:lockout-refines]
271
277
  #refinement dependency wfRespondToTherapyAlarm::osOcclusionAlarm to ucDeliverPcaTherapy;
272
278
  #refinement dependency wfRespondToTherapyAlarm::osAirInLine to ucDeliverPcaTherapy;
273
279
  #refinement dependency wfRespondToTherapyAlarm::osEmptyReservoir to ucDeliverPcaTherapy;
274
280
  #refinement dependency wfRespondToTherapyAlarm::osPowerLoss to ucDeliverPcaTherapy;
275
281
 
276
282
  // ── Operational trace relations ─────────────────────────────
283
+ // --8<-- [start:realizes-use-case]
277
284
  connection : RealizesUseCase connect wfPrepareAndStartTherapy to ucDeliverPcaTherapy;
278
285
  connection : RealizesUseCase connect wfManageActiveTherapy to ucDeliverPcaTherapy;
279
286
  connection : RealizesUseCase connect wfRespondToTherapyAlarm to ucDeliverPcaTherapy;
287
+ // --8<-- [end:realizes-use-case]
280
288
  connection : EnablesUseCase connect ocTitratedAnalgesia to ucDeliverPcaTherapy;
281
289
  connection : EnablesUseCase connect ocFailSafeTherapy to ucDeliverPcaTherapy;
282
290
  connection : RequiresCapability connect gpcaIntendedUse to ocTitratedAnalgesia;
@@ -16,6 +16,7 @@ package memo_examples_gpca_pump_gpca_system {
16
16
  // one's output is the next one's input. A step's parameters redefine its
17
17
  // function's in declaration order, whatever their names, so each narrows
18
18
  // the function's parameter at that position to this step's item.
19
+ // --8<-- [start:patient-bolus-chain]
19
20
  action fcPatientBolus : FunctionalFlow {
20
21
  @MemoIdentity { :>> providedId = "FC-001"; :>> label = "Patient bolus chain"; }
21
22
  attribute :>> flowCategory = FunctionalFlowKind::nominal;
@@ -49,6 +50,7 @@ package memo_examples_gpca_pump_gpca_system {
49
50
  first fcsBolusActuate then fcsBolusLog;
50
51
  flow from fcsBolusCommand.flowCommand to fcsBolusActuate.flowCommand;
51
52
  }
53
+ // --8<-- [end:patient-bolus-chain]
52
54
 
53
55
  action fcAlarmStop : FunctionalFlow {
54
56
  @MemoIdentity { :>> providedId = "FC-002"; :>> label = "Alarm detection to safe state chain"; }
@@ -15,8 +15,8 @@ package memo_examples_gpca_pump_gpca_verification {
15
15
  // (CR-ONT-040), which is not the same as the requirement it satisfies being
16
16
  // verified or the module it is allocated to being tested. Each function is
17
17
  // named as a subject of the case whose acceptance criteria exercise the
18
- // output its `outputDescription` describes. AcquireSensorData and
19
- // AggregateSensorStatus are not: no case here tests the debounced,
18
+ // output its `outputDescription` describes. Acquire sensor data (FUNC-001) and
19
+ // Aggregate sensor status (CFUN-003) are not: no case here tests the debounced,
20
20
  // range-checked status vector, and naming one would claim a test that
21
21
  // does not exist.
22
22
  verification vcModeRange : VerificationCase {
@@ -7,7 +7,7 @@ package memo_examples_gpca_pump_viewpoints_logical_views_behavior_action_flow_vi
7
7
  expose memo_examples_gpca_pump_viewpoints_logical_views_behavior_action_flow_view::*;
8
8
  attribute depth = 2;
9
9
  @MemoIdentity { :>> providedId = "VIEW-BHV-003"; :>> label = "GPCA_InfusionDeliveryActionFlowView"; :>> shortDescription = "The 20 ms execution-step pipeline from sensor acquisition through alarm evaluation and dose limiting to pump actuation and event logging."; }
10
- doc /* Action flow over the infusionDeliveryFlow composite action: typed action steps with in/out parameters, item flows carrying the DD/CD exchange items, succession ordering from start to done, and swimlane allocation onto the logical architecture (sensors, alarm, infusion manager, pump motor, logging). */
10
+ doc /* Action flow over the infusion delivery chain (FC-004): each step performs a system function at one position, item flows carry the DD/CD exchange items, succession ordering from start to done, and swimlane allocation onto the logical architecture (sensors, alarm, infusion manager, pump motor, logging). */
11
11
  attribute :>> outputKind = (ViewOutputKind::diagram);
12
12
  attribute :>> presentationKind = (PresentationKind::activityDiagram);
13
13
  attribute :>> viewKind = DiagramViewKind::actionflow;
@@ -15,6 +15,7 @@ package memo_examples_reusable_instrument {
15
15
  attribute :>> serviceScope = "central sterile services department";
16
16
  }
17
17
 
18
+ // --8<-- [start:use-case]
18
19
  use case ucSterilize : ClinicalUseCase {
19
20
  attribute :>> useCaseKind = UseCaseKind::care;
20
21
  @MemoIdentity { :>> providedId = "RI-UC-001"; :>> label = "Sterilize reusable instrument"; }
@@ -24,8 +25,10 @@ package memo_examples_reusable_instrument {
24
25
  subject supportingSystem;
25
26
  actor sterileProcessingTechActor = sterileProcessingTech;
26
27
  }
28
+ // --8<-- [end:use-case]
27
29
 
28
30
  // Reprocessing workflow: exists independently of any single instrument.
31
+ // --8<-- [start:workflow]
29
32
  part wfReprocess : ClinicalWorkflow {
30
33
  @MemoIdentity { :>> providedId = "RI-WF-001"; :>> label = "Instrument reprocessing workflow"; }
31
34
  attribute :>> entryCondition = "used instrument received in decontamination";
@@ -40,6 +43,7 @@ package memo_examples_reusable_instrument {
40
43
  first actInspect then actSterilizeLoad;
41
44
  }
42
45
  }
46
+ // --8<-- [end:workflow]
43
47
  action actClean : OperativeAction {
44
48
  @MemoIdentity { :>> providedId = "RI-ACT-001"; :>> label = "Clean and disinfect"; }
45
49
  attribute :>> criticality = CriticalityKind::high;
@@ -54,7 +58,9 @@ package memo_examples_reusable_instrument {
54
58
  }
55
59
 
56
60
 
61
+ // --8<-- [start:realizes]
57
62
  connection : RealizesUseCase connect wfReprocess to ucSterilize;
63
+ // --8<-- [end:realizes]
58
64
 
59
65
 
60
66
  // Illustrative: authored for this example, not the record of a real evaluation.
@@ -38,6 +38,7 @@ package memo_examples_surgical_closure_workflow {
38
38
  @MemoIdentity { :>> providedId = "LSG-N-001"; }
39
39
  doc /* The surgical team needs to perform gastric resection with controlled anatomy, haemostasis, and a checked staple line. */
40
40
  }
41
+ // --8<-- [start:use-case]
41
42
  use case ucPerformSleeveGastrectomy : ClinicalUseCase {
42
43
  attribute :>> useCaseKind = UseCaseKind::care;
43
44
  @MemoIdentity { :>> providedId = "LSG-UC-001"; :>> label = "Perform laparoscopic sleeve gastrectomy"; }
@@ -51,12 +52,14 @@ package memo_examples_surgical_closure_workflow {
51
52
  actor scrubNurseActor = scrubNurse;
52
53
  actor anesthetistActor = anesthetist;
53
54
  }
55
+ // --8<-- [end:use-case]
54
56
  connection : Motivates connect needControlledGastricResection to ucPerformSleeveGastrectomy;
55
57
 
56
58
  // ── Procedure workflow ──────────────────────────────────────
57
59
  action actTimeOutAndPosition : OperativeAction { @MemoIdentity { :>> providedId = "LSG-ACT-001"; :>> label = "Confirm time out and position"; } }
58
60
  action actEstablishAccess : OperativeAction { @MemoIdentity { :>> providedId = "LSG-ACT-002"; :>> label = "Establish laparoscopic access"; } }
59
61
  action actMobilizeStomach : OperativeAction { @MemoIdentity { :>> providedId = "LSG-ACT-003"; :>> label = "Mobilize stomach"; } }
62
+ // --8<-- [start:critical-task]
60
63
  action actSizeAndCreateSleeve : OperativeAction {
61
64
  @MemoIdentity { :>> providedId = "LSG-ACT-004"; :>> label = "Size and create sleeve"; } attribute :>> criticality = CriticalityKind::high;
62
65
 
@@ -76,10 +79,12 @@ package memo_examples_surgical_closure_workflow {
76
79
  first stInspectBleeding then stAssessIntegrity;
77
80
  }
78
81
  }
82
+ // --8<-- [end:critical-task]
79
83
  action actAssessStapleLine : OperativeAction { @MemoIdentity { :>> providedId = "LSG-ACT-005"; :>> label = "Assess staple line"; } attribute :>> criticality = CriticalityKind::high; }
80
84
  action actExtractSpecimenAndClose : OperativeAction { @MemoIdentity { :>> providedId = "LSG-ACT-006"; :>> label = "Extract specimen and close ports"; } }
81
85
  action actHandover : OperativeAction { @MemoIdentity { :>> providedId = "LSG-ACT-007"; :>> label = "Complete postoperative handover"; } }
82
86
 
87
+ // --8<-- [start:workflow]
83
88
  part wfSleeveGastrectomy : ClinicalProcedureWorkflow {
84
89
  @MemoIdentity { :>> providedId = "LSG-WF-001"; :>> label = "Laparoscopic sleeve gastrectomy workflow"; }
85
90
  attribute :>> entryCondition = "patient prepared; time-out ready";
@@ -115,12 +120,15 @@ package memo_examples_surgical_closure_workflow {
115
120
  }
116
121
  }
117
122
  }
123
+ // --8<-- [end:workflow]
118
124
 
119
125
  // ── Scenario paths, each with its own activity/action flow ──
126
+ // --8<-- [start:refines]
120
127
  #refinement dependency wfSleeveGastrectomy::scNominalSleeveProcedure to ucPerformSleeveGastrectomy;
121
128
  #refinement dependency wfSleeveGastrectomy::scStapleLineBleeding to ucPerformSleeveGastrectomy;
122
129
 
123
130
  connection : RealizesUseCase connect wfSleeveGastrectomy to ucPerformSleeveGastrectomy;
131
+ // --8<-- [end:refines]
124
132
 
125
133
 
126
134
 
@@ -86,6 +86,7 @@ package memo_examples_temperature_alarm {
86
86
  // --8<-- [end:implementation]
87
87
 
88
88
  // ── Risk chain with use error ───────────────────────────────
89
+ // --8<-- [start:risk-chain]
89
90
  // --8<-- [start:human-factors]
90
91
  part ueSilenceAndForget : UseError {
91
92
  @MemoIdentity { :>> providedId = "TA-UE-001"; :>> label = "Silence without assessment"; }
@@ -110,6 +111,7 @@ package memo_examples_temperature_alarm {
110
111
  connection : Mitigates connect rcReAnnunciate to hzUndetectedDeviation { attribute :>> mitigationKind = MitigationKind::hazard; }
111
112
  connection : ControlImplementedBy connect rcReAnnunciate to elAlarmBanner;
112
113
  // --8<-- [end:safety-risk]
114
+ // --8<-- [end:risk-chain]
113
115
 
114
116
  // ── Verification, validation, evidence ──────────────────────
115
117
  // --8<-- [start:verification-validation]
@@ -7,7 +7,7 @@
7
7
  # (`type`, `extends`, `usage`, `ontologies`, `methodology`, `modules`) were
8
8
  # removed at the native semantic flip and are now rejected if present.
9
9
  name: '@memoarchitect/extension-aadl'
10
- version: 0.20.3
10
+ version: 0.22.0
11
11
  description: AADL (SAE AS5506) correspondence profile and runtime component families
12
12
  license: MIT
13
13
  tags:
@@ -14,6 +14,7 @@
14
14
  // checked, and a required attribute on a type can.
15
15
  package memo_extension_aadl_runtime {
16
16
  private import memo_core_stdlib_quantities::*;
17
+ private import memo_core_common::MemoIdentity;
17
18
  private import ScalarValues::*;
18
19
 
19
20
  private import memo_core_enumerations::*;
@@ -23,6 +24,7 @@ package memo_extension_aadl_runtime {
23
24
  // the process itself is the fault-containment and memory-protection
24
25
  // boundary, which is why safety arguments quote it.
25
26
  part def AadlProcess specializes SoftwareComponent {
27
+ @MemoIdentity { :>> label = "AADL process"; }
26
28
  attribute :>> runtimeKind = RuntimeKind::process;
27
29
  // Whether the runtime enforces memory protection at this boundary.
28
30
  // A process without address-space isolation is a scheduling unit, not
@@ -34,6 +36,7 @@ package memo_extension_aadl_runtime {
34
36
  // exactly one process. The base's period / deadline / WCET / priority are
35
37
  // AADL thread properties already; this adds the containing process.
36
38
  part def AadlThread specializes SoftwareComponent {
39
+ @MemoIdentity { :>> label = "AADL thread"; }
37
40
  attribute :>> runtimeKind = RuntimeKind::thread;
38
41
  attribute owningProcessName : String;
39
42
  }
@@ -42,6 +45,7 @@ package memo_extension_aadl_runtime {
42
45
  // guaranteed budget. This is how an ARINC 653 partition is modelled, and
43
46
  // the budget is what a temporal-partitioning argument is made of.
44
47
  part def AadlVirtualProcessor specializes SoftwareComponent {
48
+ @MemoIdentity { :>> label = "AADL virtual processor"; }
45
49
  attribute :>> runtimeKind = RuntimeKind::partition;
46
50
  // Time and memory guaranteed to the partition, e.g. "2 ms window per
47
51
  // 10 ms major frame; 4 MB".
@@ -7,7 +7,7 @@
7
7
  # (`type`, `extends`, `usage`, `ontologies`, `methodology`, `modules`) were
8
8
  # removed at the native semantic flip and are now rejected if present.
9
9
  name: '@memoarchitect/extension-anatomy'
10
- version: 0.20.3
10
+ version: 0.22.0
11
11
  description: Human anatomy from the Foundational Model of Anatomy (FMA), selected per project
12
12
  license: MIT AND CC-BY-4.0
13
13
  tags:
@@ -11,6 +11,7 @@ package memo_extension_anatomy_selector {
11
11
  // ancestor of one, is included as well, so nothing FMA states about a
12
12
  // selected class is lost.
13
13
  part def AnatomySelector specializes MemoPart {
14
+ @MemoIdentity { :>> label = "Anatomy selector"; }
14
15
  attribute fmaSeeds : String[1..*];
15
16
  attribute partDepth : Integer default 2;
16
17
  }
@@ -11,6 +11,7 @@ package memo_extension_anatomy_vocabulary {
11
11
  private import memo_core_common::*;
12
12
 
13
13
  abstract part def AnatomyEntity specializes MemoPart {
14
+ @MemoIdentity { :>> label = "Anatomy entity"; }
14
15
  abstract ref part adheresToFeatures : AnatomyEntity[0..*] :> connectedToFeatures;
15
16
  abstract ref part adjacentToFeatures : AnatomyEntity[0..*];
16
17
  abstract ref part afferentToFeatures : AnatomyEntity[0..*] :> connectedToFeatures;
@@ -7,7 +7,7 @@
7
7
  # (`type`, `extends`, `usage`, `ontologies`, `methodology`, `modules`) were
8
8
  # removed at the native semantic flip and are now rejected if present.
9
9
  name: '@memoarchitect/example-extension-clinical'
10
- version: 0.20.3
10
+ version: 0.22.0
11
11
  description: Example methodology extension for clinical-procedure vocabulary
12
12
  license: MIT
13
13
  tags:
@@ -18,6 +18,7 @@ package memo_extension_clinical_procedures {
18
18
  private import memo_core_common::MemoIdentity;
19
19
 
20
20
  part def ClinicalProcedureWorkflow specializes ClinicalWorkflow {
21
+ @MemoIdentity { :>> label = "Clinical procedure workflow"; }
21
22
  attribute procedureCode : TerminologyCode[0..1];
22
23
  attribute clinicalObjective : String;
23
24
  attribute anesthesiaRequirement : String;
@@ -7,7 +7,7 @@
7
7
  # (`type`, `extends`, `usage`, `ontologies`, `methodology`, `modules`) were
8
8
  # removed at the native semantic flip and are now rejected if present.
9
9
  name: '@memoarchitect/extension-cloud'
10
- version: 0.20.3
10
+ version: 0.22.0
11
11
  description: Networked services and managed data stores
12
12
  license: MIT
13
13
  tags:
@@ -6,6 +6,7 @@
6
6
  // are here because each is unconditional on the type that owns it.
7
7
  package memo_extension_cloud {
8
8
  private import ScalarValues::*;
9
+ private import memo_core_common::MemoIdentity;
9
10
 
10
11
  private import memo_core_enumerations::*;
11
12
  private import memo_architecture_implementation_software_runtime::*;
@@ -23,6 +24,7 @@ package memo_extension_cloud {
23
24
  }
24
25
 
25
26
  part def CloudService specializes SoftwareComponent {
27
+ @MemoIdentity { :>> label = "Cloud service"; }
26
28
  attribute :>> runtimeKind = RuntimeKind::service;
27
29
  // The externally visible contract: protocol, endpoint, request and
28
30
  // response. This is the boundary a verification case exercises.
@@ -32,6 +34,7 @@ package memo_extension_cloud {
32
34
  }
33
35
 
34
36
  part def CloudDataStore specializes SoftwareComponent {
37
+ @MemoIdentity { :>> label = "Cloud data store"; }
35
38
  attribute :>> runtimeKind = RuntimeKind::dataStore;
36
39
  attribute storageKind : CloudStorageKind;
37
40
  // How long records are kept and what ends them. Regulated content:
@@ -7,7 +7,7 @@
7
7
  # (`type`, `extends`, `usage`, `ontologies`, `methodology`, `modules`) were
8
8
  # removed at the native semantic flip and are now rejected if present.
9
9
  name: '@memoarchitect/extension-container'
10
- version: 0.20.3
10
+ version: 0.22.0
11
11
  description: OCI container images and container runtimes as deployment content
12
12
  license: MIT
13
13
  tags:
@@ -6,6 +6,7 @@
6
6
  // they are unconditional, which is what makes them checkable.
7
7
  package memo_extension_container {
8
8
  private import ScalarValues::*;
9
+ private import memo_core_common::MemoIdentity;
9
10
 
10
11
  private import memo_architecture_realization_deployment::*;
11
12
 
@@ -14,6 +15,7 @@ package memo_extension_container {
14
15
  // correctly: a whole packaging technology lands without touching a base
15
16
  // relation.
16
17
  part def ContainerImage specializes SoftwareDeploymentUnit {
18
+ @MemoIdentity { :>> label = "Container image"; }
17
19
  // The pullable reference, e.g. "registry.example.com/screening:1.4.0".
18
20
  attribute imageReference : String;
19
21
  attribute registry : String;
@@ -26,6 +28,7 @@ package memo_extension_container {
26
28
  // The environment a node provides. `ProvidesEnvironment` (ProcessingNode
27
29
  // -> RuntimeEnvironment) reaches it unchanged.
28
30
  part def ContainerRuntime specializes RuntimeEnvironment {
31
+ @MemoIdentity { :>> label = "Container runtime"; }
29
32
  // Kubernetes, Nomad, Docker Compose, systemd-nspawn, none.
30
33
  attribute orchestrationPlatform : String;
31
34
  // The engine below the orchestrator — containerd, CRI-O, Docker.
@@ -7,7 +7,7 @@
7
7
  # (`type`, `extends`, `usage`, `ontologies`, `methodology`, `modules`) were
8
8
  # removed at the native semantic flip and are now rejected if present.
9
9
  name: '@memoarchitect/extension-messaging'
10
- version: 0.20.3
10
+ version: 0.22.0
11
11
  description: Publish/subscribe messaging — topics, brokers, and delivery semantics
12
12
  license: MIT
13
13
  tags:
@@ -29,6 +29,7 @@ package memo_extension_messaging {
29
29
  // message definition; the definition states the schema, while the usage
30
30
  // supplies the deployed topic identity.
31
31
  item def MessagingMessage specializes DataItem {
32
+ @MemoIdentity { :>> label = "Messaging message"; }
32
33
  attribute messageSchema : String;
33
34
  }
34
35
 
@@ -36,6 +37,7 @@ package memo_extension_messaging {
36
37
  // and the port usage placed on a component. The shared `topic` reference
37
38
  // points every endpoint at the same named item usage.
38
39
  port def MessagingPublisher specializes SoftwarePort {
40
+ @MemoIdentity { :>> label = "Messaging publisher"; }
39
41
  out item payload : MessagingMessage;
40
42
  ref item topic : MessagingMessage;
41
43
  attribute deliverySemantics : MessagingDeliveryKind;
@@ -43,6 +45,7 @@ package memo_extension_messaging {
43
45
  }
44
46
 
45
47
  port def MessagingSubscriber specializes SoftwarePort {
48
+ @MemoIdentity { :>> label = "Messaging subscriber"; }
46
49
  in item payload : MessagingMessage;
47
50
  ref item topic : MessagingMessage;
48
51
  attribute deliverySemantics : MessagingDeliveryKind;
@@ -50,12 +53,14 @@ package memo_extension_messaging {
50
53
  }
51
54
 
52
55
  interface def MessagingTopicInterface specializes SoftwareInterface {
56
+ @MemoIdentity { :>> label = "Messaging topic interface"; }
53
57
  end publisher : MessagingPublisher :>> source;
54
58
  end subscriber : MessagingSubscriber :>> target;
55
59
  flow messagingMessageFlow of MessagingMessage from publisher.payload to subscriber.payload;
56
60
  }
57
61
 
58
62
  part def MessagingBroker specializes SoftwareComponent {
63
+ @MemoIdentity { :>> label = "Messaging broker"; }
59
64
  attribute :>> runtimeKind = RuntimeKind::messageBroker;
60
65
  attribute brokerProduct : String;
61
66
  attribute persistenceEnabled : Boolean;
@@ -7,7 +7,7 @@
7
7
  # (`type`, `extends`, `usage`, `ontologies`, `methodology`, `modules`) were
8
8
  # removed at the native semantic flip and are now rejected if present.
9
9
  name: '@memoarchitect/extension-ros'
10
- version: 0.20.3
10
+ version: 0.22.0
11
11
  description: ROS 2 nodes, messages, topic/service/action interfaces, QoS, and containerized deployment
12
12
  license: MIT
13
13
  tags: