@oimlsmart/primmel-packages 0.1.0

package/AGENTS.md

@@ -0,0 +1,60 @@
+# AGENTS.md — oimlsmart/primmel-packages
+
+Guidance for agent sessions working in this repository.
+
+## What this repo is
+
+The OIML SMART platform's authoritative model CONTENT (extracted from
+`oimlsmart/smart` in TODO.repos/02, history intact): every OIML
+Recommendation model, the OIML-CS scheme, the ISO/IEC CASCO foundation
+packages, the shared modules, and the product/program reference
+packages — all as Primmel (`.prl`) packages, published as
+`@oimlsmart/primmel-packages` on npm.
+
+This repo is the **single source of truth**. The smart monorepo's
+`data/<rec>/` YAML trees and `browser/src/data/generated/**` are
+DOWNSTREAM GENERATED ARTIFACTS of this content at a pinned version.
+Content is authored HERE, never in the consumer.
+
+## The doctrines (carried over from smart's AGENTS.d, binding here)
+
+- **Authoring discipline.** Edit `.prl` sources; never hand-edit a
+  downstream artifact. YAML-side drafts migrate INTO packages via the
+  consumer's authoring aid (`browser/scripts/build-prl-package.ts` in
+  the smart repo), then the consumer regenerates
+  (`npm run gen:data`).
+- **Clause-URN provenance.** Normative content carries
+  `source: { doc: urn:oiml:pub:r:60-1:2021, clause: "..." }` — a content
+  change without its clause provenance is incomplete.
+- **The freeze cadence.** Releases version on the content's rhythm, not
+  the platform's. Land content on `main` with CI green; a release is a
+  deliberate act: bump `version` in `package.json`, tag `v*`, the
+  release workflow publishes via npm trusted publishing. Consumers move
+  ONLY by a deliberate pin bump — never float a range that pulls
+  content silently.
+- **The allowlists are content.** Per-package `.primmel-allowlist.prl`
+  KNOWN entries travel with the package; an unexplained allowlist entry
+  is an error, a stale one equally.
+
+## The gates (all must stay green)
+
+```
+npm ci && npm test   # check-all: primmel check --strict --audit on
+                     # every package (KNOWN printed, 0 errors)
+                     # round-trip: every package loads through
+                     # @primmel/primmel and the serializer fixpoint holds
+```
+
+The kernel is the published `@primmel/primmel` package (devDependency;
+the language grammar, parser, linter and codecs live in
+`primmel/primmel-ts`). A construct the language does not carry yet is a
+KERNEL wave first — never a content-side workaround.
+
+## Rules
+
+- Do not commit or perform other git mutations unless explicitly asked.
+- A version bump + tag is a release act (the freeze cadence) — never
+  tag without the owner.
+- The consumer's pin (`browser/package.json` in oimlsmart/smart) is the
+  contract; breaking content changes ride a deliberate major/minor bump
+  with the consumer wave staged.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OIML SMART project contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,68 @@
+# oimlsmart/primmel-packages — the single source of truth
+
+Every normative model in the OIML SMART platform — standards,
+instruments, products, programs — is a `.prl` package in this
+repository. **Everything downstream regenerates from these files.** You
+never edit a generated artifact; you edit a package here, release a
+version, and the platform regenerates at the new pin
+(`cd browser && npm run gen:data` in `oimlsmart/smart`).
+
+This repo carries the authoritative model CONTENT with its own
+governance cadence (the PRL freeze discipline) and its own release
+line (`@oimlsmart/primmel-packages` on npm, tagged `v*` on the
+content's freeze rhythm). The platform consumes it at a pinned version —
+a content change reaches the platform ONLY by a deliberate bump here
+plus a pin bump there (TODO.repos/02, the extraction record).
+
+## The packages, in six families
+
+- **Recommendations**: `oiml-r60` (load cells), `oiml-r91` (radar speed
+  meters), `oiml-r129` (multi-dimensional instruments), `oiml-r144`
+  (gas analyzers).
+- **Core**: `oiml-smart-core` — the shared metamodel (workflow
+  entities, state machines, process skeletons).
+- **Modules** (`oiml-smart-module-*`): shared test/form skeletons —
+  emc-disturbances, env-iec60068, software-d31, reference-materials,
+  specimen-governance, report-headers, examination-docs.
+- **CASCO foundations**: `iso-iec-17000`, `-17025`, `-17065`, `-17067`.
+- **OIML-CS**: `oiml-cs` — the B 18:2025 framework + the documents
+  corpus; `oiml-cs-dataspace` — the dataspace definition.
+- **Products & programs**: `acme-lc500`, `acme-cgm-200`, `acme-rs180`,
+  `acme-md3xx`, `acme-cgm-system` (fictional product reference
+  packages), `quarry-belt-scale` (the consumer), `oiml-twin-cert` (the
+  certification program), `oiml-integrated-ref` (the multi-standard
+  integrated reference), `ims-demo` + `qms-ref` + `isms-ref`
+  (view/lens fixtures).
+
+## Prove it works
+
+```bash
+npm ci
+npm test   # primmel check --strict --audit over every package
+           # (KNOWN allowlists printed) + the serializer-fixpoint
+           # codec leg — the content standalone, no app
+```
+
+The integration proofs live with the consumer: the smart monorepo's
+`npm run test:ssot` (packages ≡ data trees, byte-clean across the repo
+boundary at the pinned version) and `npm run test:from-packages` (the
+release proof — the platform builds from these packages alone).
+
+## The conventions that matter
+
+- Provenance: normative content carries `source: { doc, clause }` to a
+  published OIML clause (the clause-URN rule).
+- Product packages map to their Recommendation (C21 aliases; C82 —
+  every block-form promise mapped).
+- The packages are the SSOT; the smart repo's `data/` and
+  `browser/src/data/generated/` trees are generated artifacts, guarded
+  byte-clean against this repo at the pinned version.
+- Releases follow the content's freeze cadence: land content on `main`,
+  bump `version` in `package.json`, tag `v*` — the release workflow
+  publishes to npm via trusted publishing.
+
+## Read next
+
+- The consumer side: `oimlsmart/smart` — `AGENTS.d/05-data-conventions.md`,
+  `AGENTS.d/10-primmel-prl-packages.md`,
+  [docs/architecture/03-the-packages.md](https://github.com/oimlsmart/smart/blob/v2/docs/architecture/03-the-packages.md)

package/acme-cgm-200/model/cgm200.prl

@@ -0,0 +1,284 @@
+# ─────────────────────────────────────────────────────────────────────
+# ACME CGM-200 — the product model (TODO.v2/08's R 144 phase;
+# TODO.roadmap/36; doctrine ch. 15 §15.2). A manufacturer authors their
+# product model exactly as any subject model — the full IS/HAS/DOES
+# anatomy:
+#   IS   design parameters, promises, the endpoint declaration, metadata,
+#        provenance (the type-evaluation certificate — the promises-
+#        as-verified provenance, §15.2);
+#   HAS  exhibited attributes, the characteristics the standard's tests
+#        compute, the operational state, the serve bindings;
+#   DOES the response behaviors (drift, step response, warm-up, cross-
+#        sensitivity), the adjustment procedures and the self-check.
+#
+# FICTIONAL DEMONSTRATION PRODUCT (the acme-lc500 demo spirit): ACME
+# Analytics GmbH is a fictional demo manufacturer; the certificate and
+# report identifiers below are demo values, deliberately marked.
+#
+# The CGM-200 is a continuous gas monitor for stationary source
+# emissions: CO and NOx (the sum channel, NO + NO2), NDIR for CO,
+# chemiluminescence for NO/NOx, extractive sampling, semi-automatic
+# adjustment, AC mains — the manufacturer's OWN model, mapped to R 144's
+# vocabulary in model/r144-map.prl (map, never re-model).
+#
+# Quantity-typed design parameters carry their literal as the qualifier
+# string "<value> <unit>" — the design-time vocabulary a consumer's
+# abstract import validates against (§15.3 mode 1, computed by the
+# platform's product-coverage gate). The parameter ids are R 144's own
+# attribute ids (co_range_max, response_time, warm_up_time, …): "our
+# x is your x" is the mapping's whole point.
+# ─────────────────────────────────────────────────────────────────────
+
+quantity_register si {
+  kind volume-fraction { si_unit "1" description "Volume fraction (ISO 80000-9, 9.15) — R 144's measurand kind." }
+  unit ppm { symbol "ppm" label "part per million (volume fraction)" kind volume-fraction factor 0.000001 }
+  kind temperature { dimensions { Θ 1 } si_unit K description "Thermodynamic temperature." }
+  unit degC { symbol "°C" label "degree Celsius" kind temperature offset 273.15 }
+  kind pressure { dimensions { L -1 M 1 T -2 } si_unit Pa description "Pressure." }
+  unit kPa { symbol "kPa" label "kilopascal" kind pressure factor 1000 }
+  kind volume-flow-rate { dimensions { L 3 T -1 } si_unit "m³/s" description "Volume flow rate." }
+  unit L/min { symbol "L/min" label "litre per minute" kind volume-flow-rate factor 0.0000166667 }
+  kind time { dimensions { T 1 } si_unit s description "Time." }
+  unit s { symbol "s" label "second" kind time factor 1 }
+  unit min { symbol "min" label "minute" kind time factor 60 }
+  kind relative-humidity { si_unit "1" }
+  unit pctRH { symbol "%RH" label "percent relative humidity" kind relative-humidity factor 0.01 }
+  kind voltage { dimensions { I -1 L 2 M 1 T -3 } si_unit V description "Electric voltage." }
+  unit V { symbol "V" label "volt" kind voltage factor 1 }
+  kind frequency { dimensions { T -1 } si_unit Hz description "Frequency." }
+  unit Hz { symbol "Hz" label "hertz" kind frequency factor 1 }
+  kind dimensionless { si_unit "1" }
+  unit dimensionless { label "dimensionless" kind dimensionless }
+}
+
+attribute_definition indication_co {
+  symbol "x_CO"
+  name "CO indication"
+  definition "The served live CO volume-fraction reading of the gas analyzer, reduced to the reference conditions (273.15 K, 101.325 kPa) — R 144-1, 4.1."
+  quantity_kind volume-fraction
+  unit "ppm"
+  value_type QuantityValue
+  origin measured
+  scope sample
+  category metrological
+}
+
+attribute_definition indication_nox {
+  symbol "x_NOx"
+  name "NOx indication"
+  definition "The served live NOx volume-fraction reading of the gas analyzer (the sum channel, NO + NO2), reduced to the reference conditions (273.15 K, 101.325 kPa) — R 144-1, 4.1 with the 1.1/2.4 NOTE."
+  quantity_kind volume-fraction
+  unit "ppm"
+  value_type QuantityValue
+  origin measured
+  scope sample
+  category metrological
+}
+
+state_machine cgm_operational {
+  kind operational
+  initial off
+  states { off warming_up ready measuring calibrating fault }
+  transition off -> warming_up action power_on
+  transition warming_up -> ready action warmed
+  transition ready -> measuring action start_measurement
+  transition measuring -> ready action stop_measurement
+  transition ready -> calibrating action start_adjustment
+  transition calibrating -> ready action adjustment_done
+  transition [off, warming_up, ready, measuring, calibrating] -> fault action fault_detected
+  transition fault -> off action power_off
+}
+
+behavior drift {
+  kind temporal
+  stimulus time
+  response "Change in the indication over time at a given CGM concentration — the manufacturer's own drift behavior (answers R 144-1, 2.23/4.8)."
+}
+
+behavior step_response {
+  kind dynamic
+  stimulus gas-concentration
+  response "Time for the signal to reach 90 % of its stable value after a 0 % to 100 % stepwise concentration change of the measured component (answers R 144-1, 2.12/4.6)."
+}
+
+behavior warm_up {
+  kind temporal
+  stimulus time
+  response "Period from applying power to attaining the operating mode at which the instrument operates within the maximum permissible errors (answers R 144-1, 2.11/4.7)."
+}
+
+behavior cross_sensitivity {
+  kind influence-response
+  stimulus interfering-gas-components
+  response "Variation of the indication caused by gas components of the emissions other than the measurand, up to their maximum permissible volume fractions (answers R 144-1, 4.5.2)."
+}
+
+behavior reference_reduction {
+  kind static
+  stimulus gas-concentration
+  response "Reduction of measurement results to the reference conditions (273.15 K, 101.325 kPa) — every served indication is expressed in ppm, reduced (answers R 144-1, 4.1)."
+}
+
+behavior zero_adjustment {
+  kind procedural
+  stimulus invoke
+  response "Zero-setting against zero gas — the reading is brought to zero without affecting the span (R 144-1, 5.6.1 zero-setting adjustment facility); access-protected (R 144-1, 5.7.1)."
+}
+
+behavior span_adjustment {
+  kind procedural
+  stimulus invoke
+  response "Span adjustment against a certified calibration gas mixture (CGM) — the readings are brought into conformity with the certified volume fraction of the component (R 144-1, 5.6.1/5.6.2); access-protected (R 144-1, 5.7.1)."
+}
+
+behavior self_check {
+  kind procedural
+  stimulus invoke
+  response "The checking facilities run: gas-flow supervision against the declared flow window (R 144-1, 5.5.2), readiness and fault detection (R 144-1, 4.5.4) — a detected significant fault is annunciated: the operational state drives to fault and measurement is refused."
+}
+
+subject CGM200 {
+  is {
+    metadata {
+      name "CGM-200 continuous gas monitor model"
+      designation "CGM-200 extractive CO + NOx continuous gas monitor (NDIR / chemiluminescence)"
+    }
+    provenance {
+      manufacturer "ACME Analytics GmbH (fictional demonstration manufacturer)"
+      certificate "R144/2026-DEMO-0001 (FICTIONAL — demo value)"
+      type_evaluation_report "ACME-TE-DEMO-2026-001 (FICTIONAL — demo value)"
+      promises_as_verified "CO 10–5000 ppm and NOx (NO 10–2000 ppm + NO2 10–400 ppm) within the R 144 intrinsic MPE over the rated 5…40 °C envelope (the demo certificate's content — the claims as verified, distinct from the claims as declared, §15.2)"
+    }
+    design_parameters {
+      co_range_min : "10 ppm"
+      co_range_max : "5000 ppm"
+      no_range_min : "10 ppm"
+      no_range_max : "2000 ppm"
+      no2_range_min : "10 ppm"
+      no2_range_max : "400 ppm"
+      response_time : "180 s"
+      warm_up_time : "30 min"
+      gas_flow_rate_nominal : "1.5 L/min"
+      gas_flow_rate_min : "0.5 L/min"
+      gas_flow_rate_max : "3.0 L/min"
+      t_min : "5 degC"
+      t_max : "40 degC"
+      rh_max : "90 pctRH"
+      p_atm_min : "86 kPa"
+      p_atm_max : "106 kPa"
+      supply_voltage : "230 V"
+      supply_frequency : "50 Hz"
+    }
+    promises {
+      mpe_within_co {
+        target error_hold_co
+        conditions "under the reference conditions (R 144-1, clause 8)"
+        statement "The CO channel's intrinsic error stays within max(2 ppm, 5 % of the measured value) across the 10–5000 ppm range."
+        verified_by { oiml-r144#/req/metrological/mpe-intrinsic }
+      }
+      mpe_within_nox {
+        target error_hold_nox
+        conditions "under the reference conditions (R 144-1, clause 8)"
+        statement "The NOx channel's intrinsic error stays within max(2 ppm, 5 % of the measured value) across the 20–2400 ppm sum range (NO 10–2000 ppm + NO2 10–400 ppm)."
+        verified_by { oiml-r144#/req/metrological/mpe-intrinsic }
+      }
+      repeatability_co {
+        target error_hold_co
+        statement "CO repeatability (the estimated standard deviation of 20 runs) stays within one third of the intrinsic MPE at every test point."
+        verified_by { oiml-r144#/req/metrological/repeatability }
+      }
+      repeatability_nox {
+        target error_hold_nox
+        statement "NOx repeatability (the estimated standard deviation of 20 runs) stays within one third of the intrinsic MPE at every test point."
+        verified_by { oiml-r144#/req/metrological/repeatability }
+      }
+      response_time_within {
+        target step_response
+        level range { min 0 max 240 unit s }
+        statement "The 0 % to 100 % step response reaches 90 % within four minutes on every measured component (declared t_90 = 180 s)."
+        verified_by { oiml-r144#/req/metrological/response-time }
+      }
+      warm_up_declared {
+        target warm_up
+        statement "After the manufacturer-specified warm-up time (30 min) the system meets the metrological requirements — the four post-warm-up indications agree within the verification MPE."
+        verified_by { oiml-r144#/req/metrological/warm-up-time }
+      }
+      drift_within {
+        target drift
+        conditions "semi-automatic adjustment means; stable environmental conditions"
+        statement "The error stays within the intrinsic MPE for at least seven days from adjustment on every measured component."
+        verified_by { oiml-r144#/req/metrological/drift }
+      }
+      cross_sensitivity_within {
+        target cross_sensitivity
+        statement "Interferents up to their declared maximum permissible volume fractions shift the indication by no more than half the intrinsic MPE."
+        verified_by { oiml-r144#/req/metrological/cross-sensitivity }
+      }
+      rated_envelope {
+        target error_hold_co
+        level range { min 5 max 40 unit degC }
+        conditions "over the rated operating conditions (5…40 °C, ≤ 90 %RH at 25 °C, 86–106 kPa, 230 V −15 %/+10 %, 50 Hz ±2 %)"
+        statement "Both channels hold the verification MPE across the whole rated operating envelope."
+        verified_by { oiml-r144#/req/metrological/rated-conditions }
+      }
+      fault_annunciation {
+        target self_check
+        statement "Under a disturbance the error stays within limits or the failure is detected by the checking facilities — a detected significant fault drives the operational state to fault and measurement is refused."
+        verified_by { oiml-r144#/req/metrological/disturbances }
+      }
+      flow_supervision {
+        target self_check
+        statement "Gas flow outside the declared 0.5–3.0 L/min window (or unavailable) is signalled by the flow monitoring device."
+        verified_by { oiml-r144#/req/technical/gas-flow-monitoring }
+      }
+      adjustment_access {
+        target span_adjustment
+        statement "Zero-setting and CGM adjustment are provided and are inaccessible to the operator — access by code only; the twin endpoint binds the same protection (the calibration operations are authority-scope)."
+        verified_by { oiml-r144#/req/technical/adjustment-security }
+      }
+      ppm_presentation {
+        target reference_reduction
+        statement "Every measurement result is expressed in ppm, reduced to the reference conditions 273.15 K / 101.325 kPa — the twin serves ppm only."
+        verified_by { oiml-r144#/req/metrological/measurement-units }
+      }
+    }
+    endpoint cgm_api {
+      operation get_indication_co { kind query serves { indication_co } payload { quantity_kind volume-fraction unit ppm timestamp true } }
+      operation get_indication_nox { kind query serves { indication_nox } payload { quantity_kind volume-fraction unit ppm timestamp true } }
+      operation watch_op_state { kind subscribe serves { state environmental_context } payload { quantity_kind state unit dimensionless timestamp true } }
+      operation zero_calibration { kind invoke does { zero_adjustment } payload { quantity_kind adjustment_report unit dimensionless timestamp true } }
+      operation span_calibration { kind invoke does { span_adjustment } payload { quantity_kind adjustment_report unit dimensionless timestamp true } }
+      operation run_self_check { kind invoke does { self_check } payload { quantity_kind diagnostic_report unit dimensionless timestamp true } }
+      access { public { get_indication_co get_indication_nox } registered { watch_op_state } authority { zero_calibration span_calibration run_self_check } }
+      profile rest_json
+    }
+  }
+  has {
+    attributes {
+      indication_co : volume-fraction test_dependent
+      indication_nox : volume-fraction test_dependent
+      ref_cgm_co : volume-fraction test_dependent
+      ref_cgm_nox : volume-fraction test_dependent
+    }
+    dimensions { measurand_components in {co,nox} measuring_principle in {ir,chemiluminescence} sampling_approach in {extractive} adjustment_means in {semi-automatic} power_supply in {ac-mains} }
+    characteristics {
+      error_hold_co e_co = ocl{self.indication_co - self.ref_cgm_co}
+      error_hold_nox e_nox = ocl{self.indication_nox - self.ref_cgm_nox}
+    }
+    state cgm_operational
+    serve sample.indication_co via get_indication_co { fresh_within 5s }
+    serve sample.indication_nox via get_indication_nox { fresh_within 5s }
+    serve sample.state via watch_op_state { fresh_within 1s }
+    serve sample.environmental_context via watch_op_state { fresh_within 1s }
+  }
+  does {
+    behavior drift
+    behavior step_response
+    behavior warm_up
+    behavior cross_sensitivity
+    behavior reference_reduction
+    behavior zero_adjustment
+    behavior span_adjustment
+    behavior self_check
+  }
+}