Skip to content

PlantUML linker fails on generated .fbs.bin with UTF-8 error although source .puml is ASCII-only #335

Description

@simon-d-bmw

Summary

A sequence diagram parses successfully with the PlantUML parser step, but the later linker step fails while reading the generated .fbs.bin with a UTF-8 error in the source_file field.

Observed behavior

Warning / failure shape:

Failed to parse FlatBuffer ... Utf8 error ... while verifying table field 'source_file'

Affected source:
attribute_access_getter_sequence.puml

Generated artifact:
attribute_access_getter_sequence.fbs.bin

Expected behavior

If the source .puml parses successfully, the generated FlatBuffer should also be consumable by the linker.

Why this looks like a tooling bug

  • The .puml source is ASCII-only.
  • puml_cli parses it successfully.
  • The failure appears only in the linker while verifying the generated FlatBuffer.

Impact

Valid diagrams can still trigger downstream linker warnings/failures, making architectural-design validation noisy and less trustworthy.

Narrow repro

Build the architectural / dependable-element docs containing the affected sequence diagram.

Notes

This may be adjacent to the ongoing PlantUML idmap/linker refactor work (#290, #321, #322, #323), but those PRs do not appear to describe this UTF-8 / FlatBuffer failure explicitly.

Suspected area

Mismatch between:

  • PlantUML parser output
  • FlatBuffer schema/content
  • linker-side verification expectations

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions