Release Notes
Added
- Manifest v2 incremental cache with graph-backed hierarchy state, v1
migration, external --manifest <path> support, merge-on-write persistence,
and unsupported future-version protection.
- Child-aware incremental hierarchy export for corpus and nested layouts,
including warm skips, bounded descendant refresh, multi-root validation
planning, orphaned hierarchy members, evicted Issue tombstones, and snapshot
metadata.
--hierarchy-layout corpus|nested; incremental hierarchy defaults to
corpus, while non-incremental hierarchy keeps the legacy nested layout.- Content-visible option fingerprints covering JSON, changelog, field filters,
--no-attachments, hierarchy depth, and hierarchy issue caps.
Changed
- Incremental flat, bulk, query, and hierarchy exports validate cached Issues
through Jira search metadata before deciding whether to skip, repair missing
artifacts, backfill changelogs, evict inaccessible cache entries, or perform
a full export.
- Changelog-only incremental repairs now fetch and write only the changelog
sidecars instead of rewriting the main Markdown when the Issue itself is
unchanged.
- Hierarchy traversal now records all parent edges and artifact paths for
shared non-cyclic children while avoiding duplicate child fetches.
- Jira
updated freshness comparison now parses Jira/RFC3339 timestamps and
uses conservative string fallback only when parsing fails.
Security
- Manifest artifact paths are sanitized at load and write/join use sites,
rejecting parent traversal, absolute paths, root/prefix components, and
Windows-drive-style paths.
- Manifest saves now use randomized
create_new temp files beside the target,
sync them, and rename atomically, avoiding deterministic temp-file symlink
attacks.
Documentation
- Added manifest v2 format documentation.
- Updated README installation names for the generated Homebrew formula,
installer, and release archive names.
- Documented
--manifest, --hierarchy-layout, corpus hierarchy output, and
nested incremental shared-path behavior.
Install jarkdown 1.7.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/dchuk/jarkdown-rs/releases/download/v1.7.0/jarkdown-installer.sh | sh
Install prebuilt binaries via Homebrew
brew install dchuk/tap/jarkdown
Download jarkdown 1.7.0
