Release Notes

v1.2.2 - 2026-06-17

Binary File Corruption in MOC Engine: _moc.md (globalMocSyncV4_2) called app.vault.process() — a UTF-8 text API — on non-markdown files (images, PDFs, etc.) referenced from MOC sections. This corrupted binary files by prepending YAML frontmatter and mangling invalid UTF-8 bytes (e.g. PNG magic byte 0x89 → replacement character U+FFFD). Added a guard if (childFile.extension !== 'md') continue; to skip all non-markdown files before any write operation.

Recovery Script: scripts/recover_vault_binaries.py — scans the vault for corrupted binary files and restores them from git history. Supports full-vault scan, --dry-run, and targeted single-file recovery with optional explicit commit hash.

Logic Unification: vault/templates/_new.md now shares identical regex and sanitization logic with ref/obsidian_zid_wikilink.py.
Heading Support: ZID detection (zidLineRegex) now supports Markdown headings (# through ######) as prefixes.
Improved Sanitization: Added support for Eszett (ẞ) and better handling of periods in filenames.

Functional Example Vault: The vault/ directory is now a fully functional Obsidian vault.
- vault/templates/: Master scripts and planner configuration.
- vault/voothi/: Content catalog with live examples of MOCs, ZID Pivots, and Polymorphism.
Interactive Documentation: Technical manuals in docs/ now feature "Active Links" (dual Wikilink/Markdown) for one-click navigation within Obsidian and on GitHub.
Comprehensive RFC Tracking: Added docs/rfcs/ for tracking architectural decisions and version staging.
ZID Mapping Utility: Internal tools for re-indexing knowledge bases to new chronographic anchors.

Directory Consolidation: Simplified repository root by moving templater/, daily-note-calendar/, and assets/ into a centralized docs/ folder.
ZID Baseline: Re-anchored all example notes to a consistent 20260104 baseline.
Terminology Harmonization: Standardized "Automated Graph" and "MOC Engine" terminology across all manuals.
Table of Contents Expansion: Added H3 granularity to documentation TOCs for better discoverability.

Link Integrity Audit: Resolved 100% of broken links caused by the docs/ and vault/ restructuring.
Terminology Correction: Changed "CVS" to "VCS" (Version Control System) in root documentation.
Redundancy Pruning: Removed conflicting legacy MOC entries and duplicate content files.

Comprehensive Documentation Overhaul:
- New root README.md with Table of Contents and project overview.
- Detailed templater/README.md covering _new.md, _update.md, and _moc.md.
- Detailed daily-note-calendar/README.md covering the day-planner.md template and plugin setup.
Visual Guides: Integration of asset screenshots as step-by-step visual documentation.
Kardenwort Ecosystem: Added context for the broader learning environment.

Relative Navigation: All internal links are now relative for better portability.
Plugin Instructions: Enriched with specific folder paths and hotkey recommendations (Alt + Q, Alt + A, Alt + S).
Internal Anchors: Standardized "Return to Top" links to point to same-file Table of Contents.

Plugin Attribution: Corrected documentation to reflect that Daily Note Calendar (not Periodic Notes) handles the temporal note structure in this setup.