dcc 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 20194e78152501f174cc4043818c81319b23e7daf7cd18ab37277ea2cf1d8efe
-  data.tar.gz: a26781f5b6c988f2fa45b90c5ebc288e858513fc3e4a88d7a726df15269879c0
+  metadata.gz: 8fd7d7c99a99c2c731f5ba45311efdc2a5289f40b84868017aae775596f99052
+  data.tar.gz: 91eb8fe3f98be477dcc166df3e34ce16d804bd0c025740681d0d3f1ba54ecffa
 SHA512:
-  metadata.gz: 19c04dbb79e6b417827093efe6f3304c88bf7bb8d4ff504669f19b33e4f0b78491f48675d4db885d84abf03feff78e7a51ac4f989f418a8ed0065a9d223fb1e9
-  data.tar.gz: 5b92f29ff4422d1f9c73ac60a7e2b1b6a2eb5c8405cd0e755ad38699df56c8327ef6325c3ef19b5f761b5bed836ffdf5fea284e9624c2dc8baa9eea1626c2684
+  metadata.gz: 75a3b13cf4ab4a57a23d053339827eb9d34d23137afc7410e046b0db77aea50f46093bf3702c0a42db5fa790602dda39fd1a76492cef5072c3eda60f95491bcc
+  data.tar.gz: 34917d4371a984e8a6ed7b31ebda92d5f590297e9f85b58408a5285081f32227e26eff91ea2805ff3762aa4705894c2370fee58971a40332fcc2e6082e5613d8

data/.github/workflows/ci.yml

@@ -0,0 +1,19 @@
+# Auto-generated by Cimas: Do not edit it manually!
+# See https://github.com/metanorma/cimas
+name: rake
+
+permissions:
+  contents: write
+  packages: write
+
+on:
+  push:
+    branches: [ master, main ]
+    tags: [ v* ]
+  pull_request:
+
+jobs:
+  rake:
+    uses: metanorma/ci/.github/workflows/generic-rake.yml@main
+    secrets:
+      pat_token: ${{ secrets.LUTAML_CI_PAT_TOKEN }}

data/.github/workflows/release.yml

@@ -0,0 +1,28 @@
+# Auto-generated by Cimas: Do not edit it manually!
+# See https://github.com/metanorma/cimas
+name: release
+
+permissions:
+  contents: write
+  packages: write
+  id-token: write
+
+on:
+  workflow_dispatch:
+    inputs:
+      next_version:
+        description: |
+          Next release version. Possible values: x.y.z, major, minor, patch (or pre|rc|etc).
+          Also, you can pass 'skip' to skip 'git tag' and do 'gem push' for the current version
+        required: true
+        default: 'skip'
+  repository_dispatch:
+    types: [ do-release ]
+
+jobs:
+  release:
+    uses: relaton/support/.github/workflows/release.yml@main
+    with:
+      next_version: ${{ github.event.inputs.next_version }}
+    secrets:
+      rubygems-api-key: ${{ secrets.LUTAML_CI_RUBYGEMS_API_KEY }}

data/.gitignore

@@ -14,3 +14,7 @@
 # Local scratchpads
 TODO.scratch/
 *.gem
+
+# Web (npm)
+web/node_modules/
+web/dist/

data/.rubocop_todo.yml

@@ -1,10 +1,560 @@
-# This configuration was generated by
-# `rubocop --auto-gen-config`
-# on 2026-07-21 using RuboCop version 1.21+.
-# The point is for the user to remove these records
-# one by one as the offenses are removed from the code base.
-# Note that changes in the inspected code, or installation of new
-# versions of RuboCop, may require this file to be generated again.
-
-# Offense count: 0
-# Initially empty; populated by `rubocop --auto-gen-config`.
+# Deliberate deferrals. Every entry records debt we chose not to pay in the
+# CI-green PR, and why. Remove entries as the offenses get fixed.
+#
+# This file is hand-maintained. Do not regenerate it with
+# `rubocop --auto-gen-config` — that drops the reasons and silently widens
+# the exclusions to whatever happens to be broken that day.
+#
+# Per-file `Exclude:` is preferred over `Enabled: false` throughout: it
+# freezes the offenses that exist today while keeping the rule live for every
+# new file.
+
+# ---------------------------------------------------------------------------
+# Architectural: compact module style
+# ---------------------------------------------------------------------------
+
+# The library namespaces every model compactly (`module Dcc::V3`), and the
+# inherited oss-guides config enforces `nested`. Converting the 116 files to
+# nested style changes constant lookup and would collide with every open
+# branch, so it is its own PR.
+#
+# This cop accounts for 372 offenses on its own. Beyond its 116, enabling it
+# makes RuboCop emit 256 phantom Layout offenses against the compact-module
+# files: 231 Layout/IndentationWidth plus a few Layout/TrailingWhitespace,
+# Layout/ArgumentAlignment, Layout/LineLength, Style/StringLiterals and
+# Lint/RedundantSafeNavigation. Those are not real — RuboCop reports trailing
+# whitespace on lines that have none, and `rubocop -a --only
+# Layout/IndentationWidth` finds nothing to correct. All 256 vanish when this
+# cop is off, which is why it is disabled outright rather than excluded.
+Style/ClassAndModuleChildren:
+  Enabled: false
+
+# ---------------------------------------------------------------------------
+# Line length
+# ---------------------------------------------------------------------------
+
+# 107 lines over the 80-column limit, in 53 files. RuboCop cannot fix these:
+# `rubocop -a` corrects 0 of the 107, so every one is a manual rewrap. That
+# would put 53 more files into a PR that has to merge ahead of nine open
+# branches. Frozen per file; new files still have to stay under 80.
+Layout/LineLength:
+  Exclude:
+    - 'dcc.gemspec'
+    - 'examples/parse_and_inspect.rb'
+    - 'lib/dcc.rb'
+    - 'lib/dcc/base/comment.rb'
+    - 'lib/dcc/base/xml_blob.rb'
+    - 'lib/dcc/builder/session.rb'
+    - 'lib/dcc/cli/cli.rb'
+    - 'lib/dcc/context_configuration.rb'
+    - 'lib/dcc/context_options.rb'
+    - 'lib/dcc/convert/csv.rb'
+    - 'lib/dcc/convert/json.rb'
+    - 'lib/dcc/convert/result.rb'
+    - 'lib/dcc/diff.rb'
+    - 'lib/dcc/diff/result.rb'
+    - 'lib/dcc/error.rb'
+    - 'lib/dcc/extract/file.rb'
+    - 'lib/dcc/i18n/text_lookup.rb'
+    - 'lib/dcc/inspect/report.rb'
+    - 'lib/dcc/quantity_format/formatter.rb'
+    - 'lib/dcc/server/app.rb'
+    - 'lib/dcc/signature/result.rb'
+    - 'lib/dcc/type/base64_binary.rb'
+    - 'lib/dcc/type/decimal_xml_list.rb'
+    - 'lib/dcc/type/iso_country_code.rb'
+    - 'lib/dcc/type/iso_language_code.rb'
+    - 'lib/dcc/type/schema_version.rb'
+    - 'lib/dcc/type/si_unit.rb'
+    - 'lib/dcc/validate/business_rules.rb'
+    - 'lib/dcc/validate/issue.rb'
+    - 'lib/dcc/validate/result.rb'
+    - 'lib/dcc/validate/schematron/rule.rb'
+    - 'lib/dcc/validate/schematron/rules.rb'
+    - 'lib/dcc/validate/schematron/rules/administrative_data_completeness.rb'
+    - 'lib/dcc/validate/schematron/rules/date_range_check.rb'
+    - 'lib/dcc/validate/schematron/rules/influence_conditions_placement.rb'
+    - 'lib/dcc/validate/schematron/rules/iso_code_validation.rb'
+    - 'lib/dcc/validate/schematron/rules/language_code_dedup.rb'
+    - 'lib/dcc/validate/schematron/rules/non_si_declaration.rb'
+    - 'lib/dcc/validate/schematron/rules/release_format_check.rb'
+    - 'lib/dcc/validate/schematron/rules/schema_version_check.rb'
+    - 'lib/dcc/validate/schematron/rules/uncertainty_consistency.rb'
+    - 'lib/dcc/validate/schematron/rules/unit_format_check.rb'
+    - 'lib/dcc/validate/schematron/rules/used_methods_placement.rb'
+    - 'lib/dcc/validate/schematron/rules/used_software_placement.rb'
+    - 'lib/dcc/validate/schematron/rules/xml_list_spacing.rb'
+    - 'spec/dcc/builder/builder_spec.rb'
+    - 'spec/dcc/cli/cli_spec.rb'
+    - 'spec/dcc/extract/file_spec.rb'
+    - 'spec/dcc/server_spec.rb'
+    - 'spec/dcc/type_spec.rb'
+    - 'spec/dcc/validate/schematron_stubs_spec.rb'
+    - 'spec/dcc/validate_spec.rb'
+    - 'spec/dcc_spec.rb'
+
+# ---------------------------------------------------------------------------
+# Complexity metrics — a refactoring project, not a lint pass
+# ---------------------------------------------------------------------------
+
+# 246 offenses across the Metrics family. Every one needs a real refactor of
+# working code — splitting methods, extracting collaborators, reshaping the
+# XML mapping blocks. That is its own effort with its own tests, and it is
+# not something to bundle into the PR that unblocks CI. Frozen per file so
+# new code is still held to the limits.
+Metrics/AbcSize:
+  Exclude:
+    - 'lib/dcc/base/administrative_data.rb'
+    - 'lib/dcc/base/byte_data.rb'
+    - 'lib/dcc/base/condition.rb'
+    - 'lib/dcc/base/contact.rb'
+    - 'lib/dcc/base/contact_not_strict.rb'
+    - 'lib/dcc/base/core_data.rb'
+    - 'lib/dcc/base/data.rb'
+    - 'lib/dcc/base/formula.rb'
+    - 'lib/dcc/base/hash_type.rb'
+    - 'lib/dcc/base/influence_condition_list.rb'
+    - 'lib/dcc/base/item.rb'
+    - 'lib/dcc/base/item_list.rb'
+    - 'lib/dcc/base/list.rb'
+    - 'lib/dcc/base/location.rb'
+    - 'lib/dcc/base/measurement_result.rb'
+    - 'lib/dcc/base/measuring_equipment.rb'
+    - 'lib/dcc/base/measuring_equipment_list.rb'
+    - 'lib/dcc/base/quantity.rb'
+    - 'lib/dcc/base/ref_type_definition.rb'
+    - 'lib/dcc/base/resp_person.rb'
+    - 'lib/dcc/base/result.rb'
+    - 'lib/dcc/base/rich_content.rb'
+    - 'lib/dcc/base/software.rb'
+    - 'lib/dcc/base/statement.rb'
+    - 'lib/dcc/base/text.rb'
+    - 'lib/dcc/base/used_method.rb'
+    - 'lib/dcc/cli/cli.rb'
+    - 'lib/dcc/cli/formatters.rb'
+    - 'lib/dcc/convert/csv.rb'
+    - 'lib/dcc/convert/json.rb'
+    - 'lib/dcc/convert/liquid_filters.rb'
+    - 'lib/dcc/diff.rb'
+    - 'lib/dcc/diff/result.rb'
+    - 'lib/dcc/extract/file.rb'
+    - 'lib/dcc/inspect/report.rb'
+    - 'lib/dcc/quantity_format/formatter.rb'
+    - 'lib/dcc/quantity_math/real.rb'
+    - 'lib/dcc/server/app.rb'
+    - 'lib/dcc/si/base/complex.rb'
+    - 'lib/dcc/si/base/complex_list_xml_list.rb'
+    - 'lib/dcc/si/base/constant.rb'
+    - 'lib/dcc/si/base/hybrid.rb'
+    - 'lib/dcc/si/base/real.rb'
+    - 'lib/dcc/si/base/real_list_xml_list.rb'
+    - 'lib/dcc/si/base/si_list.rb'
+    - 'lib/dcc/signature/signer.rb'
+    - 'lib/dcc/validate/business_rules.rb'
+    - 'lib/dcc/validate/issue.rb'
+    - 'lib/dcc/validate/result.rb'
+    - 'lib/dcc/validate/schematron/rules/administrative_data_completeness.rb'
+    - 'lib/dcc/validate/schematron/rules/id_refid_linking.rb'
+    - 'lib/dcc/validate/schematron/rules/influence_conditions_placement.rb'
+    - 'lib/dcc/validate/schematron/rules/iso_code_validation.rb'
+    - 'lib/dcc/validate/schematron/rules/language_code_dedup.rb'
+    - 'lib/dcc/validate/schematron/rules/non_si_declaration.rb'
+    - 'lib/dcc/validate/schematron/rules/release_format_check.rb'
+    - 'lib/dcc/validate/schematron/rules/unit_format_check.rb'
+    - 'lib/dcc/validate/schematron/rules/used_methods_placement.rb'
+    - 'lib/dcc/validate/schematron/rules/xml_list_spacing.rb'
+
+Metrics/BlockLength:
+  Exclude:
+    - 'lib/dcc/base/administrative_data.rb'
+    - 'lib/dcc/base/core_data.rb'
+    - 'lib/dcc/base/list.rb'
+    - 'lib/dcc/base/measuring_equipment.rb'
+    - 'lib/dcc/base/quantity.rb'
+    - 'lib/dcc/base/statement.rb'
+    - 'lib/dcc/si/base/complex.rb'
+    - 'lib/dcc/si/base/real_list_xml_list.rb'
+
+Metrics/CyclomaticComplexity:
+  Exclude:
+    - 'lib/dcc/cli/formatters.rb'
+    - 'lib/dcc/convert/csv.rb'
+    - 'lib/dcc/convert/json.rb'
+    - 'lib/dcc/convert/liquid_filters.rb'
+    - 'lib/dcc/diff.rb'
+    - 'lib/dcc/extract/file.rb'
+    - 'lib/dcc/i18n/text_lookup.rb'
+    - 'lib/dcc/inspect/report.rb'
+    - 'lib/dcc/server/app.rb'
+    - 'lib/dcc/validate/business_rules.rb'
+    - 'lib/dcc/validate/issue.rb'
+    - 'lib/dcc/validate/schematron/rules/administrative_data_completeness.rb'
+    - 'lib/dcc/validate/schematron/rules/date_range_check.rb'
+    - 'lib/dcc/validate/schematron/rules/id_refid_linking.rb'
+    - 'lib/dcc/validate/schematron/rules/influence_conditions_placement.rb'
+    - 'lib/dcc/validate/schematron/rules/iso_code_validation.rb'
+    - 'lib/dcc/validate/schematron/rules/language_code_dedup.rb'
+    - 'lib/dcc/validate/schematron/rules/non_si_declaration.rb'
+    - 'lib/dcc/validate/schematron/rules/release_format_check.rb'
+    - 'lib/dcc/validate/schematron/rules/unit_format_check.rb'
+    - 'lib/dcc/validate/schematron/rules/used_methods_placement.rb'
+    - 'lib/dcc/validate/schematron/rules/xml_list_spacing.rb'
+    - 'lib/dcc/validate/severity.rb'
+
+Metrics/MethodLength:
+  Exclude:
+    - 'lib/dcc/base/administrative_data.rb'
+    - 'lib/dcc/base/byte_data.rb'
+    - 'lib/dcc/base/calibration_laboratory.rb'
+    - 'lib/dcc/base/condition.rb'
+    - 'lib/dcc/base/contact.rb'
+    - 'lib/dcc/base/contact_not_strict.rb'
+    - 'lib/dcc/base/core_data.rb'
+    - 'lib/dcc/base/data.rb'
+    - 'lib/dcc/base/digital_calibration_certificate.rb'
+    - 'lib/dcc/base/equipment_class.rb'
+    - 'lib/dcc/base/formula.rb'
+    - 'lib/dcc/base/hash_type.rb'
+    - 'lib/dcc/base/identification.rb'
+    - 'lib/dcc/base/identifications.rb'
+    - 'lib/dcc/base/influence_condition_list.rb'
+    - 'lib/dcc/base/item.rb'
+    - 'lib/dcc/base/item_list.rb'
+    - 'lib/dcc/base/list.rb'
+    - 'lib/dcc/base/location.rb'
+    - 'lib/dcc/base/measurement_meta_data_list.rb'
+    - 'lib/dcc/base/measurement_result.rb'
+    - 'lib/dcc/base/measurement_result_list.rb'
+    - 'lib/dcc/base/measuring_equipment.rb'
+    - 'lib/dcc/base/measuring_equipment_list.rb'
+    - 'lib/dcc/base/quantity.rb'
+    - 'lib/dcc/base/ref_type_definition.rb'
+    - 'lib/dcc/base/resp_person.rb'
+    - 'lib/dcc/base/resp_person_list.rb'
+    - 'lib/dcc/base/result.rb'
+    - 'lib/dcc/base/result_list.rb'
+    - 'lib/dcc/base/rich_content.rb'
+    - 'lib/dcc/base/software.rb'
+    - 'lib/dcc/base/software_list.rb'
+    - 'lib/dcc/base/statement.rb'
+    - 'lib/dcc/base/statement_list.rb'
+    - 'lib/dcc/base/string_with_lang.rb'
+    - 'lib/dcc/base/text.rb'
+    - 'lib/dcc/base/used_method.rb'
+    - 'lib/dcc/base/used_method_list.rb'
+    - 'lib/dcc/builder/session.rb'
+    - 'lib/dcc/cli/cli.rb'
+    - 'lib/dcc/cli/formatters.rb'
+    - 'lib/dcc/convert/csv.rb'
+    - 'lib/dcc/convert/html.rb'
+    - 'lib/dcc/convert/json.rb'
+    - 'lib/dcc/convert/liquid_filters.rb'
+    - 'lib/dcc/diff.rb'
+    - 'lib/dcc/extract/file.rb'
+    - 'lib/dcc/i18n/text_lookup.rb'
+    - 'lib/dcc/inspect/report.rb'
+    - 'lib/dcc/migrate.rb'
+    - 'lib/dcc/server/app.rb'
+    - 'lib/dcc/si/base/complex.rb'
+    - 'lib/dcc/si/base/complex_list_xml_list.rb'
+    - 'lib/dcc/si/base/constant.rb'
+    - 'lib/dcc/si/base/coverage_interval_mu.rb'
+    - 'lib/dcc/si/base/expanded_mu.rb'
+    - 'lib/dcc/si/base/expanded_unc_xml_list.rb'
+    - 'lib/dcc/si/base/hybrid.rb'
+    - 'lib/dcc/si/base/measurement_uncertainty_univariate.rb'
+    - 'lib/dcc/si/base/real.rb'
+    - 'lib/dcc/si/base/real_list_xml_list.rb'
+    - 'lib/dcc/si/base/si_list.rb'
+    - 'lib/dcc/si/base/standard_mu.rb'
+    - 'lib/dcc/signature/signer.rb'
+    - 'lib/dcc/signature/verifier.rb'
+    - 'lib/dcc/transform/xslt.rb'
+    - 'lib/dcc/type/decimal_xml_list.rb'
+    - 'lib/dcc/validate/business_rules.rb'
+    - 'lib/dcc/validate/result.rb'
+    - 'lib/dcc/validate/schematron/profile.rb'
+    - 'lib/dcc/validate/schematron/rules/administrative_data_completeness.rb'
+    - 'lib/dcc/validate/schematron/rules/date_range_check.rb'
+    - 'lib/dcc/validate/schematron/rules/id_refid_linking.rb'
+    - 'lib/dcc/validate/schematron/rules/influence_conditions_placement.rb'
+    - 'lib/dcc/validate/schematron/rules/iso_code_validation.rb'
+    - 'lib/dcc/validate/schematron/rules/language_code_dedup.rb'
+    - 'lib/dcc/validate/schematron/rules/non_si_declaration.rb'
+    - 'lib/dcc/validate/schematron/rules/release_format_check.rb'
+    - 'lib/dcc/validate/schematron/rules/unit_format_check.rb'
+    - 'lib/dcc/validate/schematron/rules/used_methods_placement.rb'
+    - 'lib/dcc/validate/schematron/rules/used_software_placement.rb'
+    - 'lib/dcc/validate/schematron/rules/xml_list_spacing.rb'
+    - 'lib/dcc/validate/xsd.rb'
+
+Metrics/ParameterLists:
+  Exclude:
+    - 'lib/dcc/validate/issue.rb'
+    - 'lib/dcc/validate/schematron/rule.rb'
+
+Metrics/PerceivedComplexity:
+  Exclude:
+    - 'lib/dcc/convert/csv.rb'
+    - 'lib/dcc/convert/json.rb'
+    - 'lib/dcc/convert/liquid_filters.rb'
+    - 'lib/dcc/diff.rb'
+    - 'lib/dcc/extract/file.rb'
+    - 'lib/dcc/i18n/text_lookup.rb'
+    - 'lib/dcc/inspect/report.rb'
+    - 'lib/dcc/server/app.rb'
+    - 'lib/dcc/validate/business_rules.rb'
+    - 'lib/dcc/validate/schematron/rules/administrative_data_completeness.rb'
+    - 'lib/dcc/validate/schematron/rules/date_range_check.rb'
+    - 'lib/dcc/validate/schematron/rules/id_refid_linking.rb'
+    - 'lib/dcc/validate/schematron/rules/influence_conditions_placement.rb'
+    - 'lib/dcc/validate/schematron/rules/iso_code_validation.rb'
+    - 'lib/dcc/validate/schematron/rules/language_code_dedup.rb'
+    - 'lib/dcc/validate/schematron/rules/release_format_check.rb'
+    - 'lib/dcc/validate/schematron/rules/unit_format_check.rb'
+    - 'lib/dcc/validate/schematron/rules/used_methods_placement.rb'
+    - 'lib/dcc/validate/schematron/rules/xml_list_spacing.rb'
+
+
+# ---------------------------------------------------------------------------
+# Naming — the cop defaults are wrong for this domain
+# ---------------------------------------------------------------------------
+
+# The short parameter names RuboCop flags are the conventional ones in this
+# code: `q` for a quantity, `a`/`b` for the two sides of a diff, `u`/`u1`/`u2`
+# for units being composed, `v` for a version string, `mr` for a measurement
+# result. Spelling them out would make the maths harder to read, not easier.
+# Widening AllowedNames rather than excluding files, so the rule keeps working
+# on genuinely lazy names. This list must repeat the inherited defaults —
+# only Exclude is merged across configs, so a bare addition would replace it.
+Naming/MethodParameterName:
+  AllowedNames:
+    - as
+    - at
+    - by
+    - cc
+    - db
+    - id
+    - if
+    - in
+    - io
+    - ip
+    - of
+    - "on"
+    - os
+    - pp
+    - to
+    - a
+    - b
+    - mr
+    - q
+    - u
+    - u1
+    - u2
+    - v
+
+# Names like `country_code_iso_3166_1` and `used_lang_code_iso_639_1` come
+# from the standards they reference (ISO 3166-1, ISO 639-1) and from the DCC
+# XML element names they map to. The cop wants `iso_31661`, which would break
+# the link to the schema. These names are not a style choice, so the rule does
+# not apply to this codebase at all.
+Naming/VariableNumber:
+  Enabled: false
+
+# ---------------------------------------------------------------------------
+# RSpec — suite-wide style the specs deliberately do not follow
+# ---------------------------------------------------------------------------
+
+# RSpec/MultipleExpectations caps an example at ONE expectation. These specs
+# check a parsed document by asserting over several of its fields at once,
+# which is the point of a round-trip test. Splitting 61 examples into ~200
+# would make the suite slower and no clearer. Frozen per file.
+RSpec/MultipleExpectations:
+  Exclude:
+    - 'spec/dcc/builder/builder_spec.rb'
+    - 'spec/dcc/convert/additional_spec.rb'
+    - 'spec/dcc/convert/json_spec.rb'
+    - 'spec/dcc/extract/file_spec.rb'
+    - 'spec/dcc/i18n/text_lookup_spec.rb'
+    - 'spec/dcc/inspect/report_spec.rb'
+    - 'spec/dcc/migrate_spec.rb'
+    - 'spec/dcc/namespace_spec.rb'
+    - 'spec/dcc/plugin_spec.rb'
+    - 'spec/dcc/quantity_format/formatter_spec.rb'
+    - 'spec/dcc/quantity_math/real_spec.rb'
+    - 'spec/dcc/schema_spec.rb'
+    - 'spec/dcc/server_spec.rb'
+    - 'spec/dcc/signature/signature_spec.rb'
+    - 'spec/dcc/type_spec.rb'
+    - 'spec/dcc/validate/schematron_spec.rb'
+    - 'spec/dcc/validate_spec.rb'
+    - 'spec/dcc_spec.rb'
+    - 'spec/round_trip_spec.rb'
+
+# Same story: long examples that build a document and then assert over it.
+RSpec/ExampleLength:
+  Exclude:
+    - 'spec/dcc/builder/builder_spec.rb'
+    - 'spec/dcc/cli/cli_spec.rb'
+    - 'spec/dcc/cli/formatters_spec.rb'
+    - 'spec/dcc/convert/additional_spec.rb'
+    - 'spec/dcc/extract/file_spec.rb'
+    - 'spec/dcc/migrate_spec.rb'
+    - 'spec/dcc/type_spec.rb'
+    - 'spec/dcc/validate/business_rules_spec.rb'
+    - 'spec/dcc/validate_spec.rb'
+    - 'spec/round_trip_spec.rb'
+
+# The rest of the RSpec family is spec-organisation preference, not
+# correctness: `subject` used without naming it, several describes per file,
+# file paths that do not mirror the class name, a context wording rule, and
+# describes whose subject is a string rather than a class. Frozen per file
+# rather than argued one by one; none of it affects what the suite proves.
+RSpec/ContextWording:
+  Exclude:
+    - 'spec/round_trip_spec.rb'
+
+RSpec/DescribeClass:
+  Exclude:
+    - 'spec/ptb_fixtures_spec.rb'
+    - 'spec/round_trip_spec.rb'
+
+RSpec/MultipleDescribes:
+  Exclude:
+    - 'spec/dcc/convert/additional_spec.rb'
+    - 'spec/dcc/convert/json_spec.rb'
+    - 'spec/dcc/extract/file_spec.rb'
+    - 'spec/dcc/server_spec.rb'
+    - 'spec/dcc/type_spec.rb'
+    - 'spec/dcc/validate/schematron_spec.rb'
+    - 'spec/dcc/validate/schematron_stubs_spec.rb'
+    - 'spec/dcc/validate_spec.rb'
+
+RSpec/NamedSubject:
+  Exclude:
+    - 'spec/dcc/server_spec.rb'
+
+RSpec/SpecFilePathFormat:
+  Exclude:
+    - 'spec/dcc/builder/builder_spec.rb'
+    - 'spec/dcc/signature/signature_spec.rb'
+
+# RSpec/DescribedClass wants `described_class` in place of the literal class
+# name. In a library with parallel `Dcc::V2::Foo` and `Dcc::V3::Foo`
+# hierarchies, spelling out which one a spec means is worth more than the
+# indirection. Its autocorrect is also flagged unsafe.
+RSpec/DescribedClass:
+  Exclude:
+    - 'spec/dcc/schema_spec.rb'
+    - 'spec/dcc_spec.rb'
+
+
+# ---------------------------------------------------------------------------
+# Unsafe autocorrections — each one changes behaviour
+# ---------------------------------------------------------------------------
+
+# RuboCop marks all of these "unsafe correctable", meaning the rewrite is not
+# behaviour-preserving in general. `rubocop -A` was tried and reverted on this
+# branch precisely because an autocorrect pair broke `Dcc::Builder.call`.
+# Each of these needs a human to check the surrounding code and, in most
+# cases, a test that does not exist yet. Frozen until then, not swept.
+#
+# Style/SafeNavigation in particular changes `x && x.foo` into `x&.foo`, which
+# differs whenever the receiver can be `false` rather than `nil`.
+Style/SafeNavigation:
+  Exclude:
+    - 'lib/dcc/validate/schematron/rules/date_range_check.rb'
+    - 'lib/dcc/validate/schematron/rules/influence_conditions_placement.rb'
+    - 'lib/dcc/validate/schematron/rules/iso_code_validation.rb'
+    - 'lib/dcc/validate/schematron/rules/language_code_dedup.rb'
+    - 'lib/dcc/validate/schematron/rules/release_format_check.rb'
+    - 'lib/dcc/validate/schematron/rules/unit_format_check.rb'
+    - 'lib/dcc/validate/schematron/rules/used_methods_placement.rb'
+    - 'lib/dcc/validate/schematron/rules/used_software_placement.rb'
+
+Style/MapIntoArray:
+  Exclude:
+    - 'lib/dcc/validate/schematron/rules/id_refid_linking.rb'
+
+Style/MapJoin:
+  Exclude:
+    - 'lib/dcc/convert/csv.rb'
+
+Style/PartitionInsteadOfDoubleSelect:
+  Exclude:
+    - 'lib/dcc/convert/json.rb'
+
+Style/RedundantInterpolation:
+  Exclude:
+    - 'lib/dcc/diff.rb'
+
+Style/StringConcatenation:
+  Exclude:
+    - 'examples/convert_all_formats.rb'
+
+Style/SymbolProc:
+  Exclude:
+    - 'lib/dcc/validate/xsd.rb'
+
+Performance/DeletePrefix:
+  Exclude:
+    - 'lib/dcc/schema/version.rb'
+
+Performance/DeleteSuffix:
+  Exclude:
+    - 'lib/dcc/type/decimal_xml_list.rb'
+
+# `FIXTURE_CACHE = {}` in the spec helper is a cache: the suite writes into it
+# on every fixture load. Freezing it, which is what this cop asks for, would
+# break every spec that touches a fixture.
+Style/MutableConstant:
+  Exclude:
+    - 'spec/spec_helper.rb'
+
+# The `.sort` after `Dir.glob` keeps fixture iteration order stable across
+# platforms and Ruby versions. Ruby only started guaranteeing sorted glob
+# results in 3.0, and the suite names examples after the fixture it is on, so
+# dropping the sort would make spec output order drift.
+Lint/RedundantDirGlobSort:
+  Exclude:
+    - 'spec/round_trip_spec.rb'
+
+# ---------------------------------------------------------------------------
+# Small ones that need a real decision, not a rename
+# ---------------------------------------------------------------------------
+
+# Both unused arguments are public keyword parameters. `warning_source:` is
+# still passed in by Dcc::VersionedParser, and `xml:` is part of the published
+# signature of Dcc::Schema::Version.resolve_dsi. RuboCop wants a leading
+# underscore, but for keyword arguments that renames the keyword and breaks
+# callers. Removing them is an API change and belongs in its own PR.
+Lint/UnusedMethodArgument:
+  Exclude:
+    - 'lib/dcc/context_options.rb'
+    - 'lib/dcc/schema/version.rb'
+
+# The remaining few are judgement calls about existing working code: branches
+# that happen to share a body but read better apart, predicate methods whose
+# names the cop disputes, `size` on a literal, and an `it` assignment. All are
+# cosmetic, none is mechanical, and none belongs in a CI-unblocking PR.
+Lint/DuplicateBranch:
+  Exclude:
+    - 'lib/dcc/convert/liquid_filters.rb'
+
+Naming/PredicateMethod:
+  Exclude:
+    - 'lib/dcc.rb'
+    - 'lib/dcc/server/storage/memory.rb'
+    - 'lib/dcc/si/v1.rb'
+    - 'lib/dcc/si/v2.rb'
+    - 'lib/dcc/v2.rb'
+    - 'lib/dcc/v3.rb'
+
+Performance/FixedSize:
+  Exclude:
+    - 'lib/dcc/cli/formatters.rb'
+
+Style/ItAssignment:
+  Exclude:
+    - 'lib/dcc/builder/session.rb'
+