WIP: Local Sync #1

Draft

jmarya wants to merge 2 commits from mdsync into main

pull from: mdsync

merge into: jmarya:main

jmarya:main

jmarya:renovate/moka-0.x-lockfile

jmarya:renovate/toml-1.x-lockfile

Conversation 0 Commits 2 Files changed 6 +987

jmarya commented 2025-12-05 21:24:56 +00:00

Owner

Copy link

Sync Vikunja into a local markdown task format

Sync Vikunja into a local markdown task format

jmarya added 1 commit 2025-12-05 21:24:58 +00:00

feat: implement local sync 03743c27d5

jmarya referenced this pull request 2026-04-18 00:07:35 +00:00

Export #17

jmarya force-pushed mdsync from 03743c27d5 to 6dd3d1f4e6 2026-07-28 07:55:10 +00:00 Compare

jmarya added 1 commit 2026-07-28 08:10:45 +00:00

feat(sync): mirror project tree, reconcile notes, add sync options ... 96fe9e0604

Finishes the local sync as a one-way pull: Vikunja stays the source of
truth and the local tree is a derived backup.

Reconciliation. Repeat runs previously left debris behind: a retitled
task produced a second note under its new name, and a task deleted
upstream kept its note forever. Sync now records what it wrote in a
.vk-sync.json manifest at the output root and reconciles against it, so
renames move notes and deletions remove them. Only paths listed in the
manifest are ever rewritten or deleted, so unrelated files in the output
directory are never touched, and a corrupt manifest degrades to writing
rather than deleting.

Project hierarchy. Projects are laid out mirroring Vikunja's
parent/child structure instead of being flattened. Siblings whose titles
sanitize to the same segment get their id appended so they can no longer
share a directory, and a malformed parent chain is depth-capped rather
than looping forever.

Done tasks. Tasks came from whichever view happened to be first, so
inclusion of done tasks was incidental. They are now fetched from the
task endpoint with an explicit filter, re-checked locally in case the
server ignores it, and exposed as --done.

Pseudo-projects such as Favorites duplicate tasks that already live in a
real project. They are now detected by their non-positive id rather than
the literal English title, which never matched on localized instances.

Also adds --project to sync a subset (entries for projects outside the
run are carried forward, never pruned), --archived, and --dry-run, plus
a per-project progress line and a change summary. Exits non-zero when
any operation failed.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

jmarya force-pushed mdsync from 96fe9e0604 to 109dbf59e6 2026-07-28 08:31:49 +00:00 Compare

Some checks failed

Hide checks

moira/test moira/test — failed

Details

This pull request is marked as a work in progress.

This branch is out-of-date with the base branch

View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.

git fetch -u origin mdsync:mdsync

git switch mdsync

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch main

git merge --no-ff mdsync

git switch mdsync

git rebase main

git switch main

git merge --ff-only mdsync

git switch mdsync

git rebase main

git switch main

git merge --no-ff mdsync

git switch main

git merge --squash mdsync

git switch main

git merge --ff-only mdsync

git switch main

git merge mdsync

git push origin main

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels

No items

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

jmarya/vk!1

No description provided.