plurimath 0.10.2 → 0.10.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a2ce7ef29dd4032b83c86b06d92276325630994243ef48e193aa8d3092e2fe22
-  data.tar.gz: ebaec8740845b7f1cb76e690f95f349d98d18a0b1342528463d8af3187138d1c
+  metadata.gz: 7aad5adc31e4e7391ca43f1e6c4608d00710092037b26a0a42c6f47de06c8524
+  data.tar.gz: 89f63ecb2b54a96a2326802917e54a6dd82ba55426d173fe575010d3ac706524
 SHA512:
-  metadata.gz: a80a5ad2febd36bad53adc58c6a3d6406ee04bd78c05c2e3ea7eeecf0f924818798de20c745995ee38b161ffc3758389bb80d6ad6487de16183abdc12e88f166
-  data.tar.gz: 2f1258c3745a73a0c1d4336f489d1908cfc4691a19b093dc2d0a4bcd19612ad4d449a6f452ff963a27ca01aba6eada160be778e22f7705129fc44f43ad092985
+  metadata.gz: d4b5a070148d62563d62bd3f363cecdcf309a95d97de74f4a7b4c0221f8364631b63780d11521a6e1d6666b7f30e28e16e5257938e9b13ac0859a6f0c9375f38
+  data.tar.gz: 0a3c516e3b3da885fca07a94d36967998ebf0c9c7f4b046f0110062434c3da70e47c03b31af33acbffeb5c3d6a5a398daac7ea15f3cb9b066444c51402d320da

data/.rubocop_todo.yml

@@ -0,0 +1,389 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2026-05-02 05:09:58 UTC using RuboCop version 1.86.1.
+# The point is for the user to remove these configuration 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: 1
+Gemspec/RequiredRubyVersion:
+  Exclude:
+    - 'plurimath.gemspec'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: with_first_argument, with_fixed_indentation
+Layout/ArgumentAlignment:
+  Exclude:
+    - 'lib/plurimath/math/function/overleftrightarrow.rb'
+
+# Offense count: 5
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleAlignWith.
+# SupportedStylesAlignWith: either, start_of_block, start_of_line
+Layout/BlockAlignment:
+  Exclude:
+    - 'lib/plurimath/math/core.rb'
+    - 'lib/plurimath/unicode_math/transform.rb'
+
+# Offense count: 5
+# This cop supports safe autocorrection (--autocorrect).
+Layout/ClosingParenthesisIndentation:
+  Exclude:
+    - 'lib/plurimath/math/core.rb'
+
+# Offense count: 10
+# This cop supports safe autocorrection (--autocorrect).
+Layout/ElseAlignment:
+  Exclude:
+    - 'lib/plurimath/unicode_math/transform.rb'
+    - 'lib/plurimath/utility.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Layout/EmptyLines:
+  Exclude:
+    - 'lib/plurimath/unicode_math/transform.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: empty_lines, empty_lines_except_namespace, empty_lines_special, no_empty_lines, beginning_only, ending_only
+Layout/EmptyLinesAroundClassBody:
+  Exclude:
+    - 'lib/plurimath/unicode_math/transform.rb'
+
+# Offense count: 4
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowForAlignment, AllowBeforeTrailingComments, ForceEqualSignAlignment.
+Layout/ExtraSpacing:
+  Exclude:
+    - 'lib/plurimath/unicode_math/parse.rb'
+    - 'lib/plurimath/unicode_math/parsing_rules/common_rules.rb'
+    - 'lib/plurimath/unicode_math/parsing_rules/masked.rb'
+
+# Offense count: 9
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: consistent, consistent_relative_to_receiver, special_for_inner_method_call, special_for_inner_method_call_in_parentheses
+Layout/FirstArgumentIndentation:
+  Exclude:
+    - 'lib/plurimath/unicode_math/transform.rb'
+
+# Offense count: 14
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: special_inside_parentheses, consistent, align_brackets
+Layout/FirstArrayElementIndentation:
+  Exclude:
+    - 'lib/plurimath/unicode_math/transform.rb'
+
+# Offense count: 9
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Width, EnforcedStyleAlignWith, AllowedPatterns.
+# SupportedStylesAlignWith: start_of_line, relative_to_receiver
+Layout/IndentationWidth:
+  Exclude:
+    - 'lib/plurimath/math/core.rb'
+    - 'lib/plurimath/unicode_math/transform.rb'
+    - 'lib/plurimath/utility.rb'
+
+# Offense count: 29312
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
+# URISchemes: http, https
+Layout/LineLength:
+  Enabled: false
+
+# Offense count: 12
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: aligned, indented
+Layout/MultilineOperationIndentation:
+  Exclude:
+    - 'lib/plurimath/unicode_math/parse.rb'
+    - 'lib/plurimath/unicode_math/parsing_rules/sub_sup.rb'
+    - 'lib/plurimath/unicode_math/transform.rb'
+
+# Offense count: 3
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowForAlignment, EnforcedStyleForExponentOperator, EnforcedStyleForRationalLiterals.
+# SupportedStylesForExponentOperator: space, no_space
+# SupportedStylesForRationalLiterals: space, no_space
+Layout/SpaceAroundOperators:
+  Exclude:
+    - 'lib/plurimath/unicode_math/parse.rb'
+    - 'lib/plurimath/unicode_math/parsing_rules/common_rules.rb'
+    - 'lib/plurimath/unicode_math/parsing_rules/masked.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods.
+# AllowedMethods: enums
+Lint/ConstantDefinitionInBlock:
+  Exclude:
+    - 'spec/plurimath/math/formula/intent_encoding_spec.rb'
+
+# Offense count: 13
+# Configuration parameters: IgnoreLiteralBranches, IgnoreConstantBranches, IgnoreDuplicateElseBranch.
+Lint/DuplicateBranch:
+  Exclude:
+    - 'lib/plurimath/math/function/limits.rb'
+    - 'lib/plurimath/math/function/nary.rb'
+    - 'lib/plurimath/math/function/power_base.rb'
+    - 'lib/plurimath/mathml/formula_transformation.rb'
+    - 'lib/plurimath/mathml/translator.rb'
+    - 'lib/plurimath/unicode_math/transform.rb'
+    - 'lib/plurimath/xml_engine/oga/dumper.rb'
+
+# Offense count: 7
+Lint/DuplicateMethods:
+  Exclude:
+    - 'lib/plurimath/formatter/numeric_formatter.rb'
+    - 'lib/plurimath/math/function/td.rb'
+    - 'lib/plurimath/math/number.rb'
+    - 'lib/plurimath/math/symbols/symbol.rb'
+    - 'lib/plurimath/math/symbols/twocups.rb'
+    - 'lib/plurimath/xml_engine/ox_engine/element.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowComments.
+Lint/EmptyConditionalBody:
+  Exclude:
+    - 'spec/spec_helper.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowComments.
+Lint/EmptyFile:
+  Exclude:
+    - 'spec/plurimath/math/symbols/paren_spec.rb'
+
+# Offense count: 1
+Lint/IneffectiveAccessModifier:
+  Exclude:
+    - 'lib/plurimath/math/symbols/symbol.rb'
+
+# Offense count: 11
+# Configuration parameters: AllowedParentClasses.
+Lint/MissingSuper:
+  Exclude:
+    - 'lib/plurimath/errors/formatter/unsupported_base.rb'
+    - 'lib/plurimath/math/formula.rb'
+    - 'lib/plurimath/math/function/binary_function.rb'
+    - 'lib/plurimath/math/function/linebreak.rb'
+    - 'lib/plurimath/math/function/nary.rb'
+    - 'lib/plurimath/math/function/table.rb'
+    - 'lib/plurimath/math/function/ternary_function.rb'
+    - 'lib/plurimath/math/function/unary_function.rb'
+    - 'lib/plurimath/math/function/unitsml.rb'
+    - 'lib/plurimath/math/number.rb'
+    - 'lib/plurimath/math/symbols/symbol.rb'
+
+# Offense count: 4
+Lint/UnmodifiedReduceAccumulator:
+  Exclude:
+    - 'lib/plurimath/math/formula.rb'
+    - 'lib/plurimath/math/function/fenced.rb'
+
+# Offense count: 4
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
+# NotImplementedExceptions: NotImplementedError
+Lint/UnusedMethodArgument:
+  Exclude:
+    - 'lib/plurimath/formatter/numeric_formatter.rb'
+    - 'lib/plurimath/math/formula.rb'
+    - 'lib/plurimath/math/function/left.rb'
+    - 'lib/plurimath/utility.rb'
+
+# Offense count: 151
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
+Metrics/AbcSize:
+  Enabled: false
+
+# Offense count: 4
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
+# AllowedMethods: refine
+Metrics/BlockLength:
+  Max: 57
+
+# Offense count: 3
+# Configuration parameters: CountBlocks, CountModifierForms.
+Metrics/BlockNesting:
+  Max: 4
+
+# Offense count: 111
+# Configuration parameters: AllowedMethods, AllowedPatterns, Max.
+Metrics/CyclomaticComplexity:
+  Enabled: false
+
+# Offense count: 161
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Max: 50
+
+# Offense count: 12
+# Configuration parameters: CountKeywordArgs.
+Metrics/ParameterLists:
+  Max: 6
+  MaxOptionalParameters: 5
+
+# Offense count: 84
+# Configuration parameters: AllowedMethods, AllowedPatterns, Max.
+Metrics/PerceivedComplexity:
+  Enabled: false
+
+# Offense count: 7
+# Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
+# AllowedNames: as, at, by, cc, db, id, if, in, io, ip, of, on, os, pp, to
+Naming/MethodParameterName:
+  Exclude:
+    - 'lib/plurimath/math/function/mlabeledtr.rb'
+    - 'lib/plurimath/mathml/translator.rb'
+
+# Offense count: 46
+# Configuration parameters: Mode, AllowedMethods, AllowedPatterns, AllowBangMethods, WaywardPredicates.
+# AllowedMethods: call
+# WaywardPredicates: infinite?, nonzero?
+Naming/PredicateMethod:
+  Enabled: false
+
+# Offense count: 36
+# Configuration parameters: NamePrefix, ForbiddenPrefixes, AllowedMethods, MethodDefinitionMacros, UseSorbetSigs.
+# NamePrefix: is_, has_, have_, does_
+# ForbiddenPrefixes: is_, has_, have_, does_
+# AllowedMethods: is_a?
+# MethodDefinitionMacros: define_method, define_singleton_method
+Naming/PredicatePrefix:
+  Enabled: false
+
+# Offense count: 5
+# Configuration parameters: EnforcedStyle, CheckMethodNames, CheckSymbols, AllowedIdentifiers, AllowedPatterns.
+# SupportedStyles: snake_case, normalcase, non_integer
+# AllowedIdentifiers: TLS1_1, TLS1_2, capture3, iso8601, rfc1123_date, rfc822, rfc2822, rfc3339, x86_64
+Naming/VariableNumber:
+  Exclude:
+    - 'spec/plurimath/html/parse_spec.rb'
+    - 'spec/plurimath/xml_engine_spec.rb'
+
+# Offense count: 13
+# Configuration parameters: MinSize.
+Performance/CollectionLiteralInLoop:
+  Exclude:
+    - 'Rakefile'
+    - 'lib/plurimath/math/formula.rb'
+    - 'lib/plurimath/math/function/fenced.rb'
+    - 'lib/plurimath/math/symbols/symbol.rb'
+    - 'lib/plurimath/utility.rb'
+    - 'lib/plurimath/utility/intent_encoding.rb'
+    - 'spec/plurimath/formatter/numbers/fraction_spec.rb'
+
+# Offense count: 4593
+# Configuration parameters: Prefixes, AllowedPatterns.
+# Prefixes: when, with, without
+RSpec/ContextWording:
+  Enabled: false
+
+# Offense count: 1452
+# Configuration parameters: CountAsOne.
+RSpec/ExampleLength:
+  Max: 394
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: CustomTransform, IgnoredWords, DisallowedExamples.
+# DisallowedExamples: works
+RSpec/ExampleWording:
+  Exclude:
+    - 'spec/plurimath/xml_engine_spec.rb'
+
+# Offense count: 1
+RSpec/LeakyConstantDeclaration:
+  Exclude:
+    - 'spec/plurimath/math/formula/intent_encoding_spec.rb'
+
+# Offense count: 17
+RSpec/LeakyLocalVariable:
+  Exclude:
+    - 'spec/plurimath/math/formula_spec.rb'
+    - 'spec/plurimath/math/function/binary_function_spec.rb'
+    - 'spec/plurimath/math/function/unary_function_spec.rb'
+    - 'spec/plurimath/math/number_spec.rb'
+    - 'spec/plurimath/math/symbols/symbol_spec.rb'
+    - 'spec/plurimath/unicode_math/plurimath/unicodemath_tests_spec.rb'
+    - 'spec/plurimath/unicode_math/plurimath/unicodemath_transform_spec.rb'
+
+# Offense count: 408
+RSpec/MultipleExpectations:
+  Max: 12
+
+# Offense count: 11
+# Configuration parameters: AllowSubject.
+RSpec/MultipleMemoizedHelpers:
+  Max: 11
+
+# Offense count: 51
+# Configuration parameters: AllowedGroups.
+RSpec/NestedGroups:
+  Max: 5
+
+# Offense count: 4
+RSpec/RepeatedDescription:
+  Exclude:
+    - 'spec/plurimath/math/function/power_base_spec.rb'
+    - 'spec/plurimath/number_formatter_spec.rb'
+
+# Offense count: 26
+RSpec/RepeatedExampleGroupBody:
+  Exclude:
+    - 'spec/plurimath/asciimath/metanorma_examples_spec.rb'
+    - 'spec/plurimath/latex/parser_spec.rb'
+    - 'spec/plurimath/latex_spec.rb'
+    - 'spec/plurimath/math/formula/html_spec.rb'
+    - 'spec/plurimath/math/formula/latex_spec.rb'
+    - 'spec/plurimath/math/function/unary_function_spec.rb'
+    - 'spec/plurimath/mathml/v3/section_3_spec.rb'
+
+# Offense count: 148
+RSpec/RepeatedExampleGroupDescription:
+  Enabled: false
+
+# Offense count: 25
+# Configuration parameters: CustomTransform, IgnoreMethods, IgnoreMetadata, InflectorPath, EnforcedInflector.
+# SupportedInflectors: default, active_support
+RSpec/SpecFilePathFormat:
+  Enabled: false
+
+# Offense count: 39
+Style/OptionalArguments:
+  Exclude:
+    - 'lib/plurimath/math/function/binary_function.rb'
+    - 'lib/plurimath/math/function/color.rb'
+    - 'lib/plurimath/math/function/font_style.rb'
+    - 'lib/plurimath/math/function/left.rb'
+    - 'lib/plurimath/math/function/right.rb'
+    - 'lib/plurimath/math/function/td.rb'
+    - 'lib/plurimath/math/function/ternary_function.rb'
+    - 'lib/plurimath/math/function/unary_function.rb'
+    - 'lib/plurimath/math/function/vec.rb'
+    - 'lib/plurimath/utility/intent_encoding.rb'
+
+# Offense count: 111
+# Configuration parameters: AllowedMethods.
+# AllowedMethods: respond_to_missing?
+Style/OptionalBooleanParameter:
+  Enabled: false
+
+# Offense count: 13
+# Configuration parameters: Max.
+Style/SafeNavigationChainLength:
+  Exclude:
+    - 'lib/plurimath/asciimath/parser.rb'
+    - 'lib/plurimath/math/function/fenced.rb'
+    - 'lib/plurimath/math/function/font_style.rb'
+    - 'lib/plurimath/math/function/frac.rb'
+    - 'lib/plurimath/math/function/table.rb'
+    - 'lib/plurimath/utility.rb'
+    - 'lib/plurimath/utility/intent_encoding.rb'

data/ARCHITECTURE.md

@@ -0,0 +1,102 @@
+# Architectural Change: Plurimath Formula as Universal Math Model
+
+## Summary
+
+This PR establishes the **Plurimath Formula model** as the universal mathematical model for Plurimath, replacing MathML as the central interchange format. All math representation languages (MathML, LaTeX, OMML, UnicodeMath, AsciiMath) now convert TO the Formula model, then render TO any other representation.
+
+---
+
+## Before This PR
+
+MathML (mml gem models) served as the de facto universal model. Parsing converted input to MathML models, and rendering converted from MathML models to output formats.
+
+```
+Input → MathML Models → Output
+         (as universal model)
+```
+
+---
+
+## After This PR
+
+Plurimath Formula model is the universal model. The Translator converts MathML models to Formula, and Formula renders to all output formats.
+
+```
+MathML Models → Translator → Plurimath Formula model → Renderer → LaTeX
+                                     ↓
+                                     → Renderer → OMML
+                                     ↓
+                                     → Renderer → UnicodeMath
+                                     ↓
+                                     → Renderer → AsciiMath
+```
+
+---
+
+## Core Components
+
+### Plurimath Formula model (`lib/plurimath/math/formula.rb`)
+
+The `Formula` class is the central data structure - a recursive tree that represents mathematical structure:
+
+- `Formula` contains an array of `value` items
+- Each item can be: `Number`, `Symbol`, `BinaryFunction`, `UnaryFunction`, `NaryFunction`, `Formula::Mrow`, etc.
+- Functions wrap other formulas or values to represent operators, fences, scripts, etc.
+
+### Translator (`lib/plurimath/mathml/translator.rb`)
+
+The `Translator` class bridges **MathML models** and the **Plurimath Formula model**:
+
+- Takes `Mml::V4::*` model nodes as input
+- Converts them to corresponding `Plurimath::Math::*` classes (Formula nodes)
+- Handles element-specific translation logic (e.g., `mo_to_symbol`, `mphantom_to_phantom`)
+
+### Renderer
+
+Each Formula node knows how to render itself to different formats:
+
+- `to_latex` - LaTeX output
+- `to_mathml` - MathML output
+- `to_omml` - Office Math (OMML) output
+- `to_unicodemath` - UnicodeMath output
+- `to_asciimath` - AsciiMath output
+
+---
+
+## LutaML-Model 0.8.0 Update Impact
+
+The upgrade to `lutaml-model 0.8.0` changed the mml gem models, which affected:
+
+1. **Attribute access** - Model attributes changed or moved
+2. **Element handling** - Some elements now behave differently
+3. **Serialization** - Ox vs Oga adapters produce different output
+
+This PR fixes 17 MathML translator tests that broke due to these changes, with 14 remaining that require further investigation.
+
+---
+
+## Key Files Changed
+
+| File | Purpose |
+|------|---------|
+| `lib/plurimath/math/formula.rb` | Plurimath Formula model definition and rendering |
+| `lib/plurimath/math/core.rb` | Base class for math elements |
+| `lib/plurimath/math/symbols/symbol.rb` | Symbol element handling |
+| `lib/plurimath/math/number.rb` | Number element |
+| `lib/plurimath/mathml/translator.rb` | MathML → Plurimath Formula translation |
+| `lib/plurimath/utility.rb` | Utility functions |
+
+---
+
+## Benefits of Plurimath Formula as Universal Model
+
+1. **Consistency** - All representations go through the same Plurimath Formula model
+2. **Extensibility** - Easy to add new representation languages
+3. **Separation of concerns** - Parsing (to Formula) and rendering (from Formula) are separate
+4. **Testability** - Plurimath Formula is a plain Ruby object, easy to construct and inspect
+
+---
+
+## Remaining Work
+
+14 tests in `spec/plurimath/mathml_spec.rb` still fail due to the LutaML update. See `TODO.fix-fails/REMAINING_FAILURES.md` for details.

data/Gemfile

@@ -3,14 +3,15 @@ source "https://rubygems.org"
 # Specify your gem's dependencies in plurimath.gemspec
 gemspec
 
-gem 'lutaml-model', github: "lutaml/lutaml-model", branch: "main"
-gem 'canon'
+gem "canon"
+gem "lutaml-model", github: "lutaml/lutaml-model", branch: "main"
+gem "oga"
+gem "omml", github: "plurimath/omml", branch: "main"
+gem "opal-rspec", "~> 1.1.0a"
+gem "ox"
 gem "rake", "~> 12.0"
 gem "rspec", "~> 3.0"
 gem "rubocop-performance"
 gem "rubocop-rake"
 gem "rubocop-rspec"
-gem 'oga'
-gem 'opal-rspec', "~> 1.1.0a"
-gem 'ox'
-gem 'simplecov', require: false, group: :test
+gem "simplecov", require: false, group: :test

data/Rakefile

@@ -72,17 +72,17 @@ def input_for_formats(klass)
     <<~ROW
       | #{format_input(format, klass)}
     ROW
-  end.join("")
+  end.join
 end
 
 def format_input(format, klass)
   klass.input(format).flatten.map do |s|
-    if [:latex, :unicodemath].include?(format)
+    if %i[latex unicodemath].include?(format)
       "`\\#{s}`"
     else
       "`#{s}`"
     end
-  end.join(", ").gsub(/\|/, "\\|")
+  end.join(", ").gsub("|", "\\|")
 end
 
 def write_intent_doc_file(file)
@@ -94,9 +94,9 @@ def write_intent_doc_file(file)
     end
 
     file.write(
-      <<~INTENT
+      <<~INTENT,
 
-        * `#{klass.name.gsub("Plurimath::Math::", "")}`
+        * `#{klass.name.gsub('Plurimath::Math::', '')}`
         ** #{intents.join("\n** ")}
       INTENT
     )
@@ -129,8 +129,8 @@ def intent_classes
     Plurimath::Math::Formula,
   ].flatten
   intent_classes.select do |klass|
-    klass.instance_methods(false).include?(:intent_names)
+    klass.method_defined?(:intent_names, false)
   end
 end
 
-task :default => :spec
+task default: :spec

data/TODO.bad_symbols.md

@@ -0,0 +1,45 @@
+# Bad Symbol.new Usages in translator.rb
+
+## Line 577 (FIXED)
+```ruby
+Plurimath::Math::Symbols::Symbol.new("(", mo_element: true)
+```
+Was used in `combine_function_with_parens` to create opening parenthesis.
+FIXED: Now uses `next_elem` directly if it's a Paren object, or creates `Paren::Lround.new` as fallback.
+Problem with old code: It was ignoring the existing `Paren::Lround` object returned by `mo_to_symbol` and creating a generic Symbol.
+
+## Line 171 - mo_element= (FIXED)
+```ruby
+result.mo_element = true
+```
+This was setting mo_element on Symbol objects returned by mathml_unary_classes.
+FIXED: Removed this line as Symbol class doesn't have mo_element attribute and doesn't need it.
+The Paren classes already know how to render themselves as `<mo>` via their own to_mathml_without_math_tag method.
+
+## Line 169-175 - linebreakstyle not passed (FIXED)
+```ruby
+return Plurimath::Math::Function::Linebreak.new(
+  Plurimath::Math::Symbols::Symbol.new(value)
+)
+```
+The `linebreakstyle` attribute was not being passed to Linebreak constructor.
+FIXED: Now passes `linebreakstyle` attribute and uses `mathml_unary_classes` for proper encoding.
+
+## Line 159 - whitespace stripped (PARTIALLY FIXED)
+```ruby
+result = Plurimath::Utility.mathml_unary_classes([stripped], lang: :mathml)
+```
+Whitespace was being stripped from Symbol values, causing phantom content to lose spaces.
+FIXED for LaTeX output: Restores original value after `mathml_unary_classes` creates the Symbol.
+MathML structure issue remains a pre-existing bug.
+
+## Remaining Issues - SEE TODO.fix-tests/
+
+Detailed investigation reports for the remaining 19 test failures are in `TODO.fix-tests/`:
+
+- 00-overview.md - Summary of all failures
+- 01-zero-width-space.md - OMML empty element serialization
+- 02-html-linebreak.md - HTML linebreak positioning (FIXED)
+- 03-phantom-whitespace.md - LaTeX whitespace in phantom (PARTIALLY FIXED)
+- 04-mathml-structure.md - MathML structure differences
+- 05-omml-rendering.md - OMML rendering issues

data/TODO.bugs/01-unitsml-enoent.md

@@ -0,0 +1,28 @@
+# Fix Unitsml ENOENT - missing unitsdb data files
+
+## Problem
+~44 test failures with `Errno::ENOENT` - unitsml gem can't find
+`unitsdb/units.yaml`. The GitHub-hosted unitsml gem has an empty
+`unitsdb/` directory (git submodule not initialized during `bundle install`).
+
+## Affected specs (51 total failures)
+- spec/plurimath/asciimath_spec.rb (23 failures)
+- spec/plurimath/integration/asciimath_spec.rb (13 failures)
+- spec/plurimath/math/formula/unitsml_spec.rb (3 failures)
+- spec/plurimath/asciimath/metanorma/mn_samples_bipm_spec.rb (2 failures)
+- spec/plurimath/asciimath/metanorma/mn_samples_jcgm_spec.rb (1 failure)
+- spec/plurimath/asciimath/parser_spec.rb (1 failure)
+- spec/plurimath/unicode_math_spec.rb (1 failure)
+
+## Root cause
+The unitsml gem's `unitsdb/` is a git submodule. When bundler installs
+from GitHub, submodules aren't initialized. The local copy at
+`../../unitsml/unitsml-ruby/` has the data.
+
+## Fix
+Change Gemfile to use local path for unitsml:
+```ruby
+gem "unitsml", path: "../../unitsml/unitsml-ruby"
+```
+
+## Status: Fixed (changed Gemfile to local path)

data/TODO.bugs/02-system-stack-error-cloned-objects.md

@@ -0,0 +1,34 @@
+# Fix SystemStackError in Formula#cloned_objects
+
+## Problem
+4 test failures with `SystemStackError: stack level too deep` in
+`Plurimath::Math::Core#cloned_objects`. The `cloned_objects` method
+recursively clones all values, but some formula structures create
+infinite recursion.
+
+## Affected specs (19 failures total)
+- spec/plurimath/mathml_spec.rb:213 - MathML object round-trip
+- spec/plurimath/mathml_spec.rb:778 - table with parentheses and sqrt
+- spec/plurimath/mathml_spec.rb:1448 - mtable with frame/rowlines
+- spec/plurimath/mathml_spec.rb:1713 - metanorma bipm input
+- spec/plurimath/math_zone_spec.rb:675 - table math zone
+- spec/plurimath/math_zone_spec.rb:4234 - table math zone
+- spec/plurimath/integration/asciimath_spec.rb - 12 ogc/bipm/itu/jcgm examples
+
+## Stack trace pattern
+```
+Core#cloned_objects → Formula#cloned_objects → Array#map →
+Core#variable_value → Array#map → Core#cloned_objects → ...
+```
+
+## Root cause
+`cloned_objects` in `lib/plurimath/math/core.rb:223` creates
+`self.class.new(nil)` which triggers `Formula.new(nil)`. If the Formula
+contains objects that reference back to the formula or create cyclic
+structures, the recursion never terminates.
+
+This is likely a pre-existing bug exposed by V4 parsing producing
+different formula structures. Needs investigation of what formula
+structure triggers the infinite recursion.
+
+## Status: Open (pre-existing, needs investigation)