Skip to content

Release v0.20.7

Choose a tag to compare

View all tags
@github-actions github-actions released this 03 Oct 20:38
· 23 commits to main since this release
v0.20.7
aeb16cd

xbrlkit v0.20.7

Summary

A targeted bug-fix release that makes report package loading reliable in xbrlkit serve and keeps filings parseable when a national taxonomy host is unreachable. Loading failures are now reported clearly instead of silently producing an empty model.

Key Improvements

  • Report package support in serve — zipped report packages are now loaded correctly, including archives created on Windows that use backslash path separators.
  • Resilient taxonomy resolution — a filing whose national taxonomy host is offline or gone will still load, falling back rather than failing outright.
  • Clearer diagnostics — load operations now name the specific taxonomy or schema reference that could not be resolved, both in logs and in tool output, so you can tell what a load went without.
  • Fail loudly, not silently — an empty load inside a package is now refused instead of returning an empty model, and malformed/unreadable archives are caught and reported as errors.
  • Documentation updated across the parse, serve, and filings_org READMEs to describe degraded-load behaviour and the new messaging.

Bug Fixes

  • Fixed report packages failing to load in the MCP server session (#94).
  • Fixed extraction of ZIP archives whose entries use backslash separators.
  • Fixed filings failing to parse when a referenced national taxonomy host no longer resolves.
  • Bad or corrupt archives no longer raise unhandled exceptions during load.
  • Empty package loads no longer succeed quietly with no facts.

Notable Technical Changes

  • xbrlkit/parse/arelle_load.py records and surfaces unresolved taxonomy references during Arelle model loading.
  • xbrlkit/serve/session.py, server.py, and tools.py updated for package-aware loading and stricter error propagation.
  • xbrlkit/filings_org/client.py and download.py adjusted for package download/unpack handling.
  • Test coverage expanded in tests/test_serve.py and tests/test_arelle_cache.py.

Breaking Changes

None. Behaviour changes are limited to loads that previously returned an empty model silently — these now raise a clear error, which may surface as a new failure in code that relied on the empty result.

📊 Release Statistics

  • Commits: 7
  • Files Changed: 13
  • Lines Added: 567
  • Lines Deleted: 32
  • Previous Release: v0.20.6

🔗 Links

🤖 Generated with Claude Code

Assets 2
Loading