Release and Version History

x.y.z (Backlog)

Features and Improvements

Minor Improvements

Bugfixes

Miscellaneous

1.0.1 (2026-01-04)

Major Refactor

This release represents a significant architectural overhaul focused on reliability, maintainability, and AI-native development practices.

Architecture Changes

  • Refactored from monolithic model.py to modular structure with separate marks/ and nodes/ directories

  • Each ADF type now has its own dedicated module (e.g., node_paragraph.py, mark_strong.py)

  • Added code generation for api.py to ensure consistent public API exports

  • Introduced TypeEnum for type-safe ADF type handling

  • Added graceful error handling: unimplemented types are now skipped with optional warnings instead of crashing

New Mark Types

New Node Types

Testing Improvements

  • Comprehensive test coverage using real Confluence page data

  • Two-layer testing architecture: PageSample (page-level) and AdfSample (element-level)

  • JMESPath-based element extraction for precise testing

  • Round-trip serialization tests for all implemented types

Documentation

  • Complete maintainer guide with 5 sections:

    • Project overview and design philosophy

    • Cross-referencing three sources of truth (JSON schema, official docs, real pages)

    • Base class architecture and markdown helpers

    • Step-by-step guide for implementing new marks/nodes

    • Testing workflow documentation

  • User-facing getting started guide with practical examples

  • AI-consumable documentation structure

AI-Native Development

  • Claude Code skills for development workflow:

    • /dev - Maintainer guide quick reference

    • /adf-format-json-schema - Query ADF JSON schema

    • /adf-json-example - Fetch real ADF from Confluence

    • /implement-model - Automated implementation workflow

0.1.2 (2025-03-03)

Features and Improvements

  • Made it open source and publish to PyPI

0.1.1 (2025-01-04)

Features and Improvements

  • First release (GitHub Relase only)

  • Add support to export to Markdown

  • Support the following mark and node type:

    • MarkBackGroundColor

    • MarkCode

    • MarkEm

    • MarkLink

    • MarkStrike

    • MarkStrong

    • MarkSubSup

    • MarkTextColor

    • MarkUnderLine

    • MarkIndentation

    • NodeBlockCard

    • NodeBlockQuote

    • NodeBulletList

    • NodeCodeBlock

    • NodeDate

    • NodeDoc

    • NodeEmoji

    • NodeExpand

    • NodeHardBreak

    • NodeHeading

    • NodeInlineCard

    • NodeListItem

    • NodeMedia

    • NodeMediaGroup

    • NodeMediaSingle

    • NodeMention

    • NodeNestedExpand

    • NodeOrderedList

    • NodePanel

    • NodeParagraph

    • NodeRule

    • NodeStatus

    • NodeTable

    • NodeTableCell

    • NodeTableHeader

    • NodeTableRow

    • NodeTaskItem

    • NodeTaskList

    • NodeText