Troubleshooting¶

Common issues and solutions.

Type Checking Issues¶

Error:

error: Cannot find module './.divvun-rt/hfst.ts'

Solution: Run sync to generate types:

divvun-runtime sync

Error:

error: Property 'model_path' is missing

Solution: Check command parameters in Modules & Commands or generated .divvun-rt/ types.

Error:

Error: Asset not found: tokeniser.pmhfst

Solution: Verify file exists in assets/ directory:

ls assets/tokeniser.pmhfst

Error:

Warning: Message ID 'typo' not found in locale 'en'

Solution: Add message to errors-en.ftl:

typo = Spelling error
    .desc = The word {$1} is not in the dictionary.

Messages appear in wrong language.

Solution: Set locale priority:

divvun-runtime run -c 'suggest={"locales":["fo","en"]}' bundle.drb "text"

Error:

Error: Pipeline 'spellOnly' not found

Solution: List available pipelines:

divvun-runtime list bundle.drb

Use exact pipeline name:

divvun-runtime run --pipeline spell-only bundle.drb "text"

Enable detailed logging:

RUST_LOG=divvun_runtime=debug divvun-runtime run bundle.drb "input"

Module-specific logging:

export RUST_LOG=divvun_runtime::modules::cg3=trace

If issues persist: