__init__.py
python
sha256:cf6265cea8c21d9228d90dec13ef6ec2dab5103d466db9cc4590681832de4bf8
docs(KD-STAGING): sync governance after KD-6b DONE
Human
13 days ago
| 1 | """Knowtation domain plugin — vault-native version control for Markdown knowledge bases. |
| 2 | |
| 3 | Treats a Knowtation vault as a structured system of notes with YAML frontmatter, |
| 4 | Markdown sections, wikilinks, entity references, and mist attachments. Two |
| 5 | commits that only reformat whitespace in a note produce no semantic delta. |
| 6 | Tag-set unions and frontmatter key additions auto-merge without conflicts. |
| 7 | |
| 8 | Language support |
| 9 | ---------------- |
| 10 | - Markdown notes (*.md): full frontmatter + section-level semantic tracking. |
| 11 | - All other vault files: file-level tracking with raw-bytes identity. |
| 12 | |
| 13 | Extending semantic support |
| 14 | -------------------------- |
| 15 | Implement a ``NoteAdapter`` in ``muse/plugins/knowtation/parser.py`` for a |
| 16 | new file format and register it in ``ADAPTERS``. The plugin will automatically |
| 17 | use it for diff and merge operations. |
| 18 | |
| 19 | Side effects on import |
| 20 | ---------------------- |
| 21 | Importing this package eagerly calls |
| 22 | :func:`muse.plugins.knowtation.hooks.register_knowtation_hook` so the |
| 23 | ``muse merge --consolidate`` flag finds the consolidation hook in the |
| 24 | process-wide singleton without callers needing to wire it up by hand. |
| 25 | The registration is idempotent and never performs any I/O. |
| 26 | """ |
| 27 | |
| 28 | from muse.plugins.knowtation.hooks import register_knowtation_hook |
| 29 | |
| 30 | register_knowtation_hook() |
File History
1 commit
sha256:cf6265cea8c21d9228d90dec13ef6ec2dab5103d466db9cc4590681832de4bf8
docs(KD-STAGING): sync governance after KD-6b DONE
Human
13 days ago