journal
Local-first automation for Obsidian journal analytics.
Personal analytics journal pipeline.
// overview
journal-sync is a personal knowledge and life-tracking sync engine for a Markdown vault. It updates daily, weekly, monthly, quarterly, and yearly notes from Flow focus sessions, iCloud Shortcut payloads, reminders, goals, grades, media logs, and vault context.
The codebase emphasizes deterministic Markdown rendering, typed contracts, strict parsers, cache-backed adapters, and file-safe note updates. It is a CLI-backed automation tool rather than a web app.
// how it works
CLI commands dispatch into application services through runtime wiring. Ports define local integrations; adapters bind Flow SQLite, iCloud status JSON, Obsidian notes, schedules, reminders, goals, media scans, and JSON caches.
Domain modules parse source notes, compute metrics and windows, reconcile goals, then render stable Markdown tables, text charts, and summary blocks back into the vault.
// capabilities
Daily sync
Combines focus sessions, shortcut status, schedule rules, reminders, goals, and vault state.
Period reports
Builds week, month, quarter, and year summaries with deltas, targets, moving averages, and text charts.
Goal reconciliation
Carries active goals through daily and period notes while preserving local Markdown structure.
Media and grades
Imports Obsidian media, Kindle annotations, and university grade projections into dedicated notes.