@oimlsmart/primmel-packages 0.2.1 → 0.3.0

package/oiml-cs/framework/declarations.prl

@@ -0,0 +1,145 @@
+# OIML-CS FRAMEWORK — THE DECLARATION MODEL (B 18:2025 §5.5–5.6; PD-08)
+# -----------------------------------------------------------------------------
+# The OIML-CS Declaration as a first-class model (TODO.roadmap/40): the
+# participation register of the scheme (PD-08 clause 4 — every IA, Utilizer
+# and Associate shall sign a Declaration; the Executive Secretary records
+# them). Three declaration kinds, their content slots, the status model
+# (PD-08 cl. 5: a Declaration is initiated, signed, kept current through
+# scope extensions/reductions and periodic-review changes, and recorded by
+# the Executive Secretary), and the SIGNING-GATE invariant (PD-08 clause 5):
+# an OIML Issuing Authority must have signed its Declaration before issuing
+# any OIML certificate or OIML type evaluation report.
+#
+# This file closes the §4.6.7 documented exclusion of
+# specification/requirements/cs.prl: the scheme-governance constraint
+# (who may certify what, and only after a signed Declaration) now has its
+# model home here — the gate references the abstract processes it blocks
+# (the consumer's evaluation/abstract-processes.yaml, still YAML-only).
+#
+# Declaration semantics (PD-08, verified against the corpus audit
+# analysis/oiml-cs-corpus-audit-2026-07.md, corpus C):
+#   - IA Declaration scope = instrument categories × Schemes (certificates
+#     and type evaluation reports under Scheme A and/or B — PD-08 cl. 4 a);
+#   - Utilizer/Associate Declaration scope = acceptance per Scheme PLUS any
+#     additional national requirements (3.2) deviating from the
+#     Recommendation (PD-08 cl. 4 b; B 18:2025 §5.6.1–5.6.2);
+#   - Utilizers/Associates specify from which IAs and TLs they accept
+#     reports/test data and whether they accept MTL-based reports
+#     (§5.6.3 — MTL acceptance is voluntary and need not be justified);
+#   - acceptance of legacy MAA certificates + conditions SHALL be detailed
+#     in the Declaration (PD-08 cl. 6; B 18:2025 §15.10), Basic-certificate
+#     acceptance is voluntary (§15.11).
+#
+# Numbering: official published PDF (reference-docs/cs/docs/b018-e25.pdf).
+#
+# This file is the single source of truth; the consumer's
+# data/oiml-cs/framework/declarations.yaml is its GENERATED YAML twin
+# (cd browser && npm run gen:data; schema data/schemas/framework-declarations.yaml).
+# Cross-references (holder kinds, the gate's declaration edge) are checked
+# package-side by the kernel's C120 framework-references-resolve; the
+# consumer's linker R25 still guards the regenerated YAML (incl. the
+# signing-gate's blocks against the abstract-process ids). The gate
+# calculus lives in browser/src/data/framework.ts; the seeded rejection
+# proof in browser/src/__tests__/cs-framework.test.ts.
+declaration_kind issuing_authority_declaration {
+  label "OIML Issuing Authority Declaration"
+  holder issuing_authority
+  clause "5.5.1"
+  procedure "PD-08"
+  definition "Declaration signed by an OIML Issuing Authority accepted for participation in the OIML-CS, indicating its scope for issuing OIML certificates and OIML type evaluation reports under Scheme A and/or Scheme B (§5.5.1)."
+  scope_model categories_x_schemes
+  scheme_a_obligation "When an OIML Issuing Authority is accepted under Scheme A, the OIML Member State shall designate at least one Utilizer for each instrument category concerned, unless the category is not regulated in that Member State (§5.5.1; PD-08 cl. 4 Note 2 — a written explanation to the Executive Secretary)."
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "5.5.1"
+  }
+}
+
+declaration_kind utilizer_declaration {
+  label "Utilizer Declaration"
+  holder utilizer
+  clause "5.6.1"
+  procedure "PD-08"
+  definition "Declaration signed by a Utilizer indicating its scope of acceptance of OIML certificates and/or OIML type evaluation reports issued under Scheme A and/or Scheme B (§5.6.1)."
+  scope_model categories_x_schemes
+  content additional_national_requirements {
+    clause "5.6.1"
+    description "Additional national requirements (3.2) deviating from the Recommendation — the Utilizer may specify them; acceptance of additional-national-requirement test data is at the Utilizer's discretion and must be stated in the Declaration (PD-09, 4.1)."
+  }
+  content accepted_participants {
+    clause "5.6.3"
+    description "The OIML Issuing Authorities and Test Laboratories from which the Utilizer accepts evaluation reports, test reports and test data for additional national requirements (§5.6.3)."
+  }
+  content mtl_acceptance_policy {
+    clause "5.6.3"
+    description "Whether the Utilizer accepts OIML certificates and/or type evaluation reports issued on the basis of test reports from a Manufacturer's Test Laboratory (§5.6.3) — acceptance is voluntary and requires no justification (PD-08 cl. 6)."
+  }
+  content maa_certificate_acceptance {
+    clause "15.10"
+    description "Conditions for the acceptance of legacy OIML MAA certificates — SHALL be detailed in the Declaration when accepted (PD-08 cl. 6; §15.10). Legacy OIML Basic certificates remain valid and their acceptance is voluntary (§15.11)."
+  }
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "5.6.1"
+  }
+}
+
+declaration_kind associate_declaration {
+  label "Associate Declaration"
+  holder associate
+  clause "5.6.2"
+  procedure "PD-08"
+  definition "Declaration signed by an Associate indicating its scope of acceptance of OIML certificates and/or OIML type evaluation reports issued under Scheme A and/or Scheme B (§5.6.2) — the same content slots as the Utilizer Declaration."
+  scope_model categories_x_schemes
+  content additional_national_requirements {
+    clause "5.6.2"
+    description "Additional national requirements (3.2), as for the Utilizer Declaration."
+  }
+  content accepted_participants {
+    clause "5.6.3"
+    description "The OIML Issuing Authorities and Test Laboratories from which the Associate accepts reports and test data (§5.6.3)."
+  }
+  content mtl_acceptance_policy {
+    clause "5.6.3"
+    description "Whether the Associate accepts MTL-based certificates/reports (§5.6.3) — voluntary, no justification needed (PD-08 cl. 6)."
+  }
+  content maa_certificate_acceptance {
+    clause "15.10"
+    description "Conditions for the acceptance of legacy OIML MAA certificates (PD-08 cl. 6; §15.10); Basic-certificate acceptance is voluntary (§15.11)."
+  }
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "5.6.2"
+  }
+}
+
+declaration_status draft {
+  description "Initiated, not yet signed by the participant."
+}
+
+declaration_status signed {
+  description "Signed by the participant and recorded by the Executive Secretary — the only status that discharges the signing gate."
+}
+
+declaration_status suspended {
+  description "The participant is suspended by the Management Committee (§11.4) — no new applications (PD-03 cl. 8)."
+}
+
+declaration_status withdrawn {
+  description "Participation withdrawn; the Declaration no longer grounds issuance or acceptance."
+}
+
+declaration_gate declaration-signed-before-issuance {
+  clause "PD-08 cl. 5"
+  statement "An OIML Issuing Authority shall not issue any OIML certificate or OIML type evaluation report before its Declaration covering the instrument category and Scheme is signed (PD-08 clause 5; B 18:2025 §5.5.1). Evaluation and testing for an application received beforehand may proceed only after the Review Committee has made a positive, unconditional recommendation to the Management Committee — but the certificate/report still cannot be issued until the Declaration is signed or updated (PD-08 clause 5)."
+  holder issuing_authority
+  declaration issuing_authority_declaration
+  blocks { issue evaluation }
+  blocks_note "The gated abstract processes of the scheme process model (evaluation/abstract-processes.yaml): issue (certificate issuance) and evaluation (the OIML type evaluation report — its compilation and release are part of the evaluation step)."
+  scope_checked { category scheme }
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "5.5.1"
+  }
+}
+

package/oiml-cs/framework/documents.prl

@@ -0,0 +1,118 @@
+# OIML-CS FRAMEWORK — GOVERNING-DOCUMENT HIERARCHY + AUTO-INCLUSION
+# -----------------------------------------------------------------------------
+# The governing-document hierarchy of the OIML-CS (B 18:2025, clause 6)
+# with its precedence rule, and the automatic-inclusion conditions of
+# clause 4 (§4.2): when a category of measuring instrument enters the
+# OIML-CS — the precondition the scheme lifecycle's automatic Scheme B
+# entry keys on (framework/schemes.prl, §15.1).
+#
+# The per-document models of the corpus (PD-01…PD-09, CID-01, OD-01/02)
+# are tasks 42–43; this file models the HIERARCHY and the entry conditions
+# only. PD-05 (the certification process) already has its model in this
+# package (specification/requirements/cs.prl + the consumer's
+# evaluation/abstract-processes.yaml + execution/test-report-checklist.yaml).
+#
+# Numbering: official published PDF (reference-docs/cs/docs/b018-e25.pdf).
+#
+# This file is the single source of truth; the consumer's
+# data/oiml-cs/framework/documents.yaml is its GENERATED YAML twin
+# (cd browser && npm run gen:data; schema data/schemas/framework-documents.yaml).
+# The approved_by organ edges are checked package-side by the kernel's
+# C120 framework-references-resolve; the consumer's linker R25 still
+# guards the regenerated YAML.
+framework_document b18 {
+  rank 1
+  doc "OIML B 18"
+  title "Framework for the OIML Certification System (OIML-CS)"
+  approved_by ciml
+  clause "6 a)"
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "6"
+  }
+}
+
+framework_document cid-01 {
+  rank 2
+  doc "OIML-CS CID-01"
+  title "Clarification and Interpretation Document"
+  approved_by management_committee
+  clause "6 b)"
+  note "Clarifications and interpretations of OIML-CS documents intended as guidance and additional information; they do not supersede the text of the current editions (CID-01, clause 2)."
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "6"
+  }
+}
+
+framework_document od {
+  rank 3
+  doc "OIML-CS OD-xx"
+  title "Operational Documents"
+  approved_by management_committee
+  clause "6 c)"
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "6"
+  }
+}
+
+framework_document pd {
+  rank 4
+  doc "OIML-CS PD-xx"
+  title "Procedural Documents"
+  approved_by management_committee
+  clause "6 d)"
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "6"
+  }
+}
+
+framework_document guidance {
+  rank 5
+  doc "OIML-CS Guidance, Forms and Templates"
+  title "Guidance, Forms and Templates"
+  approved_by management_committee
+  clause "6 e)"
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "6"
+  }
+}
+
+document_precedence higher_position_prevails {
+  clause "6"
+  statement "In the event of a conflict, contradiction or inconsistency between the provisions of one of the governing documents and the provisions of another, the provisions of the document listed in a higher position take precedence over the provisions of the document listed in a lower position (clause 6)."
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "6"
+  }
+}
+
+auto_inclusion auto_inclusion {
+  clause "4.2"
+  statement "Categories of measuring instruments (including families of instruments, modules, or families of modules) are automatically included in the OIML-CS when the relevant OIML Recommendation specifies all of the following (§4.2); the initial placement is Scheme B (§4.3, §15.1)."
+  condition metrological-technical-requirements {
+    clause "4.2 a)"
+    description "The Recommendation specifies the metrological and technical requirements for the category."
+  }
+  condition test-procedures {
+    clause "4.2 b)"
+    description "The Recommendation specifies the test procedures, including (where applicable) the selection of the instrument(s) or module(s) to be tested from the family (§4.4 — what counts as a family/module and the applicable requirements/test procedures for them)."
+  }
+  condition test-report-format {
+    clause "4.2 c)"
+    description "The Recommendation specifies the OIML test report format."
+  }
+  condition evaluation-report-format {
+    clause "4.2 d)"
+    description "The Recommendation specifies the OIML type evaluation report format."
+  }
+  note "The two report formats (conditions c and d) may be specified in separate Parts of a Recommendation or combined in one Part (§4.2 Note). The BIML maintains the list of the categories in the OIML-CS with references to the relevant Recommendations on the OIML website (§4.5)."
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "4.2"
+  }
+}
+

package/oiml-cs/framework/governance.prl

@@ -0,0 +1,124 @@
+# OIML-CS FRAMEWORK — ORGANS AND DECISION RULES (B 18:2025, clauses 9–16)
+# -----------------------------------------------------------------------------
+# The decision mechanics of the OIML-CS organs (TODO.roadmap/40): the MC's
+# 80 % participation decisions on RC recommendation, the TLF's advisory
+# tasks (incl. inter-laboratory comparisons), the BoA's appeal rulings, the
+# BIML's certificate registration with the REGISTERED-COPY VALIDITY
+# principle (§15.8), the legacy-certificate rules (§15.10/§15.11), and the
+# financing rule (§16.3 — no entrance fees).
+#
+# MECE: organ IDENTITY and mandates live in framework/participants.prl;
+# this file holds the decision rules that bind organs to outcomes.
+#
+# Numbering: official published PDF (reference-docs/cs/docs/b018-e25.pdf).
+#
+# This file is the single source of truth; the consumer's
+# data/oiml-cs/framework/governance.yaml is its GENERATED YAML twin
+# (cd browser && npm run gen:data; schema data/schemas/framework-governance.yaml).
+# Cross-references (organ ids, the no_entrance_fees_for participant kinds)
+# are checked package-side by the kernel's C120 framework-references-resolve;
+# the consumer's linker R25 still guards the regenerated YAML.
+decision_rule ia-tl-participation-decisions {
+  organ management_committee
+  kind participation
+  on_recommendation_of review_committee
+  clause "11.4.2"
+  decides { ia_approval ia_reapproval ia_suspension tl_approval tl_reapproval tl_suspension }
+  description "The Management Committee decides the participation of OIML Issuing Authorities and Test Laboratories — approval, re-approval and suspension (§11.5 f) — on a recommendation of the Review Committee (§11.6.2), by the qualified 80 % majority of §11.4.2/§11.4.3; all other proposals pass by simple majority in a meeting or two-thirds of the votes cast by correspondence."
+  voting {
+    in_meeting {
+      threshold 0.8
+      base mc_members_from_member_states
+      clause "11.4.2"
+      description "Approval, re-approval or suspension of an OIML Issuing Authority or a Test Laboratory requires the support of at least 80 % of the Management Committee Members from OIML Member States (§11.4.2)."
+    }
+    by_correspondence {
+      threshold 0.8
+      base mc_members_from_member_states
+      clause "11.4.3"
+      description "The same 80 % threshold applies to decisions taken outside a meeting, when the Chairperson decides that voting takes place by correspondence (§11.4.3)."
+    }
+    other_proposals {
+      in_meeting 0.5
+      by_correspondence two_thirds_of_votes_cast
+      description "All other proposals require at least half of the MC Members from OIML Member States in a meeting (§11.4.2), or two-thirds of the votes cast by correspondence (§11.4.3)."
+    }
+    proxies_max 2
+    abstentions not_voting
+    reason_on_against_or_abstain true
+  }
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "11.4"
+  }
+}
+
+decision_rule tlf-advisory-tasks {
+  organ test_laboratories_forum
+  kind advisory
+  clause "12.2"
+  description "The Test Laboratories Forum is the scheme's consensus platform of the Test Laboratories (one representative per TL, including MTLs, plus the Executive Secretary; no chairperson, no voting rule — its outputs are recommendations): it handles practical and technical questions on the test specifications, methods and equipment of the clause-7 standards (12.2 a), details how tests achieve the necessary reproducibility (12.2 b), draws up best-practice papers and proposes Recommendation amendments (12.2 c), and works towards the development of inter-laboratory comparison programs for the Test Laboratories (12.2 d)."
+  tasks { practical_testing_questions reproducibility_of_results best_practice_papers_and_amendments interlaboratory_comparisons }
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "12.2"
+  }
+}
+
+decision_rule boa-appeal-rulings {
+  organ board_of_appeal
+  kind appeal_ruling
+  clause "13.2"
+  description "The Board of Appeal manages appeals against decisions of the Management Committee relating to participation in the OIML-CS and to Legal Metrology Experts and Management System Experts (13.2 a), and recommends solutions to any other dispute referred to it with regard to the application of the rules of the OIML-CS (13.2 b); its rulings on appeals bind the contested MC decision (the appeals procedure is specified in PD-01)."
+  independent_of management_committee
+  scope { participation_decisions expert_decisions }
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "13.2"
+  }
+}
+
+decision_rule biml-certificate-registration {
+  organ biml
+  kind registration
+  clause "15.8"
+  description "The BIML registers and publishes OIML certificates (10.1). The only valid version of an OIML certificate is the printed or electronic version issued by an OIML Issuing Authority; the validity of any OIML certificate can be verified with the copy of the certificate registered and published on the OIML-CS pages of the OIML website by the BIML (§15.8) — the BIML-registered copy is the scheme's source of truth for validity (the platform's public register, /app/ register, is its implementation)."
+  principle registered_copy_validity
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "15.8"
+  }
+}
+
+decision_rule legacy-certificate-validity {
+  organ biml
+  kind legacy_validity
+  clause "15.10"
+  description "Certificates issued under the legacy OIML certificate systems (the MAA Certificate System and the Basic Certificate System) remain valid under the OIML-CS (§15.10/§15.11); their acceptance regimes differ — MAA acceptance conditions are declared by Utilizers and Associates, Basic acceptance is voluntary."
+  legacy_kind maa {
+    clause "15.10"
+    description "OIML MAA certificates issued under the OIML MAA Certificate System are considered to remain valid; Utilizers and Associates may establish conditions for their acceptance, detailed in their Declarations (§15.10; framework/declarations.yaml maa_certificate_acceptance)."
+  }
+  legacy_kind basic {
+    clause "15.11"
+    description "OIML Basic certificates issued under the OIML Basic Certificate System are considered to remain valid; their acceptance by Utilizers, Associates and users is voluntary (§15.11)."
+  }
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "15.10"
+  }
+}
+
+decision_rule scheme-financing {
+  organ biml
+  kind financing
+  clause "16.3"
+  description "The income of the OIML-CS consists of the fees from the registration of OIML certificates; no entrance fees are charged to OIML Issuing Authorities, Test Laboratories, Utilizers or Associates (§16.3). The BIML Director draws up the annual budget and accounts (§16.1), separately budgeted and consolidated into the OIML accounts (§16.2)."
+  income certificate_registration_fees
+  no_entrance_fees_for { issuing_authority test_laboratory utilizer associate }
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "16.3"
+  }
+}
+

package/oiml-cs/framework/participants.prl

@@ -0,0 +1,263 @@
+# OIML-CS FRAMEWORK — PARTICIPANT REGISTRY MODEL (B 18:2025, clause 5)
+# -----------------------------------------------------------------------------
+# The participant KINDS of the OIML Certification System (TODO.roadmap/40) —
+# the type-level registry: who may act in the scheme, on what competence
+# basis, admitted by whom. Instances (actual IAs, TLs, Utilizers) are app
+# data of the platform runtime (tasks 44–45), not modelled here.
+#
+# MECE: competence content is DELEGATED, never restated — B 18:2025 §5.2
+# delegates Issuing-Authority competence to ISO/IEC 17065 (the
+# iso-iec-17065 package, TODO.roadmap/39b) and §5.3 delegates
+# Test-Laboratory competence to ISO/IEC 17025 (the iso-iec-17025
+# package, TODO.roadmap/39c). The `delegates_to` facets below are
+# REFERENCES to those layer packages (composed via the manifest's `uses`);
+# no ISO provision text lives here. Organ IDENTITY and mandates live here;
+# their decision RULES live in framework/governance.prl.
+#
+# certificate_owner carries no `term` facet on purpose: B 18:2025 clause 3
+# defines no "certificate owner" term — the ownership concept is the 3.3
+# Note ("Upon issuance of the OIML certificate, the applicant becomes the
+# owner of the OIML certificate"); 3.26 is "OIML certificate", the
+# document — not its owner.
+#
+# Numbering: every clause reference follows the OFFICIAL published PDF
+# (reference-docs/cs/docs/b018-e25.pdf). The local presentation XML
+# (data/oiml-b018-e25/ in the consumer) is numbered official−1 (its build
+# drops the Introduction) — never cite it.
+#
+# This file is the single source of truth; the consumer's
+# data/oiml-cs/framework/participants.yaml is its GENERATED YAML twin
+# (cd browser && npm run gen:data; schema data/schemas/framework-participants.yaml).
+# Cross-references (organ ids from governance, declaration kinds, the
+# designated_by/becomes kind edges) are checked package-side by the
+# kernel's C120 framework-references-resolve; the consumer's linker R25
+# still guards the regenerated YAML.
+participant_kind issuing_authority {
+  label "OIML Issuing Authority"
+  term "3.28"
+  clause "5.2"
+  definition "Certification body or inspection body from an OIML Member State approved by the Management Committee to issue OIML certificates and associated OIML type evaluation reports in accordance with Scheme A or Scheme B."
+  member member_state
+  competence {
+    delegates_to iso-iec-17065
+    clause "5.2"
+    note "Compliance with ISO/IEC 17065 (B 18:2025, §5.2) — the competence model itself lives in the iso-iec-17065 package; the method of DEMONSTRATING compliance differs per Scheme (framework/schemes.yaml, §5.4)."
+  }
+  approval {
+    decided_by management_committee
+    on_recommendation_of review_committee
+    procedure "PD-03"
+    clause "11.5 f)"
+  }
+  declaration issuing_authority_declaration
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "5.2"
+  }
+}
+
+participant_kind test_laboratory {
+  label "Test Laboratory"
+  term "3.40"
+  clause "5.3"
+  definition "Laboratory that performs some or all of the tests of an OIML type evaluation, designated by an OIML Issuing Authority and approved by the Management Committee. The OIML Issuing Authority — never the Test Laboratory — issues the OIML type evaluation report (3.40 Note 3)."
+  competence {
+    delegates_to iso-iec-17025
+    clause "5.3"
+    note "Compliance with ISO/IEC 17025 (B 18:2025, §5.3) — the competence model itself lives in the iso-iec-17025 package."
+  }
+  approval {
+    decided_by management_committee
+    on_recommendation_of review_committee
+    procedure "PD-04"
+    clause "11.5 f)"
+  }
+  designated_by issuing_authority
+  subkind internal {
+    label "Internal Test Laboratory"
+    term "3.15"
+    definition "Test Laboratory that is part of the same organization as the OIML Issuing Authority."
+  }
+  subkind third_party {
+    label "Third-party Test Laboratory"
+    term "3.42"
+    definition "Test Laboratory that is designated by an OIML Issuing Authority, and registered in the Declaration, and which is independent from the OIML Issuing Authority."
+  }
+  subkind manufacturer {
+    label "Manufacturer's Test Laboratory (MTL)"
+    term "3.21"
+    definition "Test Laboratory that is part of the manufacturer's organization, testing for its parent company under controlled supervision (PD-04, 7.1); when testing for other parties it is treated as a third-party Test Laboratory."
+    data_flag "Test data originating from a Manufacturer's Test Laboratory shall be flagged as such on the OIML type evaluation report (PD-05)."
+    acceptance voluntary
+    acceptance_note "Acceptance of certificates/reports issued on the basis of MTL test reports is voluntary: each Utilizer and Associate declares whether it accepts them (B 18:2025, §5.6.3; PD-06). The MTL acceptance policy is a Declaration content slot (framework/declarations.yaml)."
+  }
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "5.3"
+  }
+}
+
+participant_kind utilizer {
+  label "Utilizer"
+  term "3.45"
+  clause "5.6.1"
+  definition "National issuing authority or national responsible body from an OIML Member State that signs a Declaration indicating its scope of acceptance of OIML certificates and/or OIML type evaluation reports issued under Scheme A and/or Scheme B."
+  member member_state
+  declaration utilizer_declaration
+  admission "PD-09"
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "5.6.1"
+  }
+}
+
+participant_kind associate {
+  label "Associate"
+  term "3.4"
+  clause "5.6.2"
+  definition "National issuing authority or national responsible body from an OIML Corresponding Member that signs a Declaration indicating its scope of acceptance of OIML certificates and/or OIML type evaluation reports issued under Scheme A and/or Scheme B."
+  member corresponding_member
+  declaration associate_declaration
+  admission "PD-09"
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "5.6.2"
+  }
+}
+
+participant_kind applicant {
+  label "Applicant"
+  term "3.3"
+  clause "1.4"
+  definition "Manufacturer and/or authorized representative that applies for OIML type evaluation to an OIML Issuing Authority; the applicant becomes the owner of the OIML certificate on issuance (PD-05 §4.6.6)."
+  becomes certificate_owner
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "3.3"
+  }
+}
+
+participant_kind certificate_owner {
+  label "OIML certificate owner"
+  clause "15.8"
+  definition "Holder of an OIML certificate — on issuance the applicant becomes the owner of the OIML certificate (3.3 Note); the certificate, the type evaluation report and the test report(s) are delivered to the applicant on issuance (PD-05 §4.6.6)."
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "3.3"
+  }
+}
+
+participant_kind user {
+  label "User"
+  term "3.44"
+  clause "15.11"
+  definition "Any organization, other than a Utilizer or an Associate, that accepts and uses OIML certificates and/or OIML type evaluation reports."
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "3.44"
+  }
+}
+
+participant_kind legal_metrology_expert {
+  label "Legal Metrology Expert"
+  term "3.16"
+  clause "11.5 i)"
+  definition "Expert approved by the Management Committee for the assessment of OIML Issuing Authorities and Test Laboratories (peer evaluations and peer assessments); the approval procedures are specified in PD-02."
+  approved_by management_committee
+  procedure "PD-02"
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "3.16"
+  }
+}
+
+participant_kind management_system_expert {
+  label "Management System Expert"
+  term "3.19"
+  clause "11.5 i)"
+  definition "Person, approved by the Management Committee, who has overall responsibility for leading a peer assessment — the team-leader role (PD-02: \"Management System Experts (Team Leaders)\"); the approval procedures are specified in PD-02."
+  approved_by management_committee
+  procedure "PD-02"
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "3.19"
+  }
+}
+
+governance_organ ciml {
+  label "International Committee of Legal Metrology (CIML)"
+  clause "9"
+  mandate "Appoints the MC Chairperson and Deputy Chairperson and the BoA Chairperson and members; approves B 18 revisions; decides all scheme-composition questions: inclusion of new categories, moves of a category from Scheme A back to Scheme B, extension or reduction of the two-year transition period, and withdrawal of earlier Recommendation editions."
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "9"
+  }
+}
+
+governance_organ management_committee {
+  label "Management Committee (MC)"
+  term "3.17"
+  clause "11"
+  mandate "Manages the OIML-CS: decides the participation (approval, re-approval, suspension) of OIML Issuing Authorities and Test Laboratories (11.5 f), conducts periodic continuity reviews (11.5 g), appoints the Review Committee Chairperson (11.5 h), approves the Legal Metrology Expert and Management System Expert lists (11.5 i), and owns the OIML-CS rules, procedures and guidance (11.5 k–l)."
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "11"
+  }
+}
+
+governance_organ review_committee {
+  label "Review Committee (RC)"
+  term "3.35"
+  clause "11.6"
+  mandate "Sub-committee of the Management Committee: reviews the documentation of candidate and existing OIML Issuing Authorities and Test Laboratories and recommends their acceptance or continuation to the MC; validates Legal Metrology Experts and Management System Experts; recommends on complaints."
+  sub_committee_of management_committee
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "11.6"
+  }
+}
+
+governance_organ test_laboratories_forum {
+  label "Test Laboratories Forum (TLF)"
+  term "3.41"
+  clause "12"
+  mandate "Advisory platform of one representative per Test Laboratory (including Manufacturer's Test Laboratories) plus the Executive Secretary: practical questions on testing and the standards of clause 7, reproducibility of test results, best-practice papers and Recommendation amendment proposals, and the development of inter-laboratory comparison programs (12.2)."
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "12"
+  }
+}
+
+governance_organ board_of_appeal {
+  label "Board of Appeal (BoA)"
+  term "3.5"
+  clause "13"
+  mandate "Appeals committee independent of the Management Committee (Chair and four members, all appointed by the CIML): manages appeals against MC decisions relating to participation and to experts, and recommends on disputes (13.2)."
+  independent_of management_committee
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "13"
+  }
+}
+
+governance_organ biml {
+  label "International Bureau of Legal Metrology (BIML)"
+  clause "10"
+  mandate "Secretariat of the OIML-CS (10.1): registers and publishes OIML certificates, collects registration fees, maintains the OIML-CS pages of the OIML website, and maintains the lists of OIML Issuing Authorities, Utilizers and Associates (5.1.4) and of the instrument categories in the OIML-CS (4.5)."
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "10"
+  }
+}
+
+governance_organ executive_secretary {
+  label "Executive Secretary"
+  term "3.11"
+  clause "10.2"
+  mandate "BIML staff member appointed by the BIML Director: day-to-day operation of the OIML-CS under MC direction — processes IA/TL applications, advises on peer (re)assessments, maintains the IA/TL records and the MC/TLF records and expert lists, and monitors the Declarations (10.2 a–j)."
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "10.2"
+  }
+}
+

package/oiml-cs/framework/schemes.prl

@@ -0,0 +1,108 @@
+# OIML-CS FRAMEWORK — THE TWO-SCHEME ARCHITECTURE + CATEGORY LIFECYCLE
+# -----------------------------------------------------------------------------
+# Scheme A vs Scheme B (B 18:2025, 3.37/3.38, §5.4) and the per-category
+# scheme LIFECYCLE as an operational state machine (TODO.roadmap/40, using
+# the task-07 machinery): automatic Scheme B participation on inclusion
+# (§15.1, conditions of §4.2) → automatic transition to Scheme A two years
+# after inclusion (§15.2), with the MC-proposed/CIML-decided variations
+# (shorter §15.2, deferred §15.3, reversed §15.7).
+#
+# The competence REQUIREMENTS are identical in both Schemes (IA → ISO/IEC
+# 17065, TL → ISO/IEC 17025 — framework/participants.prl); only the method
+# of DEMONSTRATING compliance differs (§5.4): self-declaration (Scheme B,
+# §5.4.2) vs peer evaluation on the basis of accreditation or peer
+# assessment (Scheme A, §5.4.3; approval processes in PD-03/PD-04).
+#
+# Scheme membership attaches to the instrument CATEGORY (§4.3), not to the
+# system as a whole — the lifecycle machine below runs per category: one
+# machine instance per instrument category in the OIML-CS, ENTERING at
+# SCHEME_B (§15.1/§4.3); transitions carry their deciding organ and the
+# two-year timer is declared once, bound to the transition_period_elapsed
+# action. The timer trigger is proven by the consumer's seeded test
+# (browser/src/__tests__/cs-framework.test.ts); the trigger calculus lives
+# in browser/src/data/framework.ts (one home, pure functions).
+#
+# Numbering: official published PDF (reference-docs/cs/docs/b018-e25.pdf);
+# the local presentation XML is numbered official−1 — never cite it.
+#
+# This file is the single source of truth; the consumer's
+# data/oiml-cs/framework/schemes.yaml is its GENERATED YAML twin
+# (cd browser && npm run gen:data; schema data/schemas/framework-schemes.yaml).
+# Cross-references (the transitions' decided_by organs, the trigger
+# actions, the entry's conditions_ref) are checked package-side by the
+# kernel's C120 framework-references-resolve; the consumer's linker R25
+# still guards the regenerated YAML.
+scheme_definition scheme_b {
+  label "Scheme B"
+  term "3.38"
+  clause "5.4.2"
+  definition "Introductory level of the OIML-CS where a self-declaration is used as the basis for demonstrating compliance."
+  demonstration {
+    method self_declaration
+    clause "5.4.2.1"
+    note "Self-declaration with additional supporting evidence (§5.4.2.1); the Scheme B application and approval process for IAs is specified in PD-03, for TLs in PD-04 (§5.4.1.1)."
+  }
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "3.38"
+  }
+}
+
+scheme_definition scheme_a {
+  label "Scheme A"
+  term "3.37"
+  clause "5.4.3"
+  definition "Advanced level of the OIML-CS where accreditation or peer assessment is used as the basis for demonstrating compliance."
+  demonstration {
+    method peer_evaluation
+    clause "5.4.3.1"
+    basis { accreditation peer_assessment }
+    note "Compliance demonstrated by peer evaluation on the basis of an accreditation assessment or a peer assessment (§5.4.3.1). The accreditation route requires an Accreditation Body participating in a mutual recognition arrangement (IAF MLA for IAs, §5.4.3.2.1; ILAC MRA for TLs, §5.4.3.3.1 — with the 2025 footnote: IAF and ILAC are being replaced by the Global Accreditation Cooperation Incorporated, transition provisionally January 2026); assessment team requirements are specified in PD-03 (IAs, §5.4.3.2.2) and PD-04 (TLs, §5.4.3.3.2), and for peer assessment in PD-03 + PD-04 (§5.4.3.4.1)."
+  }
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "3.37"
+  }
+}
+
+scheme_lifecycle category_scheme {
+  applies_to instrument_category
+  initial SCHEME_B
+  entry {
+    action category_included
+    automatic true
+    clause "15.1"
+    conditions_ref auto_inclusion
+    description "A category of measuring instrument covered by a new or existing OIML Recommendation is automatically included in the OIML-CS in Scheme B when the conditions of §4.2 are met (§15.1); the initial placement in Scheme B is §4.3."
+  }
+  transition SCHEME_B -> SCHEME_A action transition_period_elapsed {
+    clause "15.2"
+    description "Two years after inclusion in the OIML-CS, the category automatically transitions to Scheme A (§15.2) — the timer-driven transition."
+  }
+  transition SCHEME_B -> SCHEME_A action transition_advanced {
+    clause "15.2"
+    decided_by ciml
+    on_proposal_of management_committee
+    description "The Management Committee may propose to the CIML that a category transitions to Scheme A in a time period of less than two years (§15.2, second sentence; CIML decides, §9 e)."
+  }
+  transition SCHEME_A -> SCHEME_B action moved_to_scheme_b {
+    clause "15.7"
+    decided_by ciml
+    on_proposal_of management_committee
+    description "It may be proposed by the Management Committee and decided by the CIML to move a category of measuring instrument from Scheme A back to Scheme B (§15.7; §9 e)."
+  }
+  trigger two-year-transition {
+    kind timer
+    action transition_period_elapsed
+    window { years 2 }
+    clause "15.2"
+    deferrable true
+    deferral_note "The Management Committee may propose to the CIML that a category does not automatically transition after two years (§15.3 — e.g. suitable experts for assessments not yet available); a granted deferral extends this timer's window per the CIML decision (§9 e iii)."
+    description "The two-year Scheme-B window opened by the category's inclusion: when it elapses, transition_period_elapsed fires and the category moves to Scheme A automatically (§15.2)."
+  }
+  source {
+    doc "urn:oiml:pub:b:18:2025"
+    clause "15"
+  }
+}
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oimlsmart/primmel-packages",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "The OIML SMART platform's authoritative model content: every Recommendation, the OIML-CS scheme, the CASCO foundations, the shared modules, and the product/program reference packages as Primmel (.prl) packages — the single source of truth the platform's data trees regenerate from. Consumed by the smart monorepo (oimlsmart/smart) at a pinned version (TODO.repos/02).",
   "type": "module",
   "repository": {
@@ -12,6 +12,6 @@
   },
   "license": "MIT",
   "devDependencies": {
-    "@primmel/primmel": "^1.10.0"
+    "@primmel/primmel": "^1.11.1"
   }
 }