oxios-markdown 1.0.2

Markdown knowledge management — ported from files.md by Artem Zakirullin
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

//! # oxios-markdown
//!
//! Markdown knowledge management library — ported from [files.md](https://github.com/zakirullin/files.md)
//! by Artem Zakirullin. Licensed under MIT — see LICENSE-THIRD-PARTY.
//!
//! This crate provides core functionality for managing a knowledge base
//! stored as plain `.md` files:
//!
//! - **VirtualFs** — sandboxed filesystem with path traversal protection
//! - **BacklinkIndex** — bidirectional link tracking between notes
//! - **Merge** — LCS-based conflict resolution
//! - **Parser** — text processing utilities (similarity, links, headings)
//!
//! # Example
//!
//! ```no_run
//! use oxios_markdown::VirtualFs;
//! use std::path::PathBuf;
//!
//! let fs = VirtualFs::new(PathBuf::from("/path/to/knowledge")).unwrap();
//! fs.write("brain", "Rust.md", "# Rust\n\nSee [Ownership](brain/Ownership.md)").unwrap();
//! let content = fs.read("brain", "Rust.md").unwrap();
//! ```

#![warn(missing_docs)]

pub mod backlinks;
pub mod chat;
pub mod checklist;
pub mod fs;
#[allow(dead_code)]
pub mod fslog;
pub mod habits;
pub mod html;
pub mod i18n;
pub mod journal;
pub mod knowledge;
pub mod merge;
pub mod parser;
pub mod plugins;
pub mod schedule;
pub mod stats;
#[allow(dead_code)]
pub mod sync;
pub mod tgtxt;
pub mod tokens;
pub mod types;
pub mod worker;

// Re-export core types for convenience
pub use types::{
    FileEntry, FsError, Habits, KnowledgeConfig, SyncError, SyncFile, SyncRequest, SyncResponse,
    CHAT_FILENAME, DIR_ARCHIVE, DIR_JOURNAL, DIR_MEDIA, DIR_USER_ROOT, DONE_FILENAME,
    HABIT_COMPLETED, HABIT_COMPLETED_AT_WEEKEND, HABIT_SKIPPED, LATER_FILENAME, MD_EXT, MODE_CHAT,
    MODE_FULL, MODE_JOURNAL, MODE_NOTES, MODE_TASKS, MOOD_EMOJIS, MOOD_HABIT, READ_FILENAME,
    SHOP_FILENAME, STATUS_MERGED, STATUS_NOT_MODIFIED, STATUS_OK, STATUS_UPDATED_ON_SERVER,
    WATCH_FILENAME,
};

pub use backlinks::{Backlink, BacklinkIndex, LinkEdge, LinkGraph, LinkNode};
pub use chat::{
    append_to_chat_msg, delete_chat_msg, find_chat_msg_by_hash, move_from_chat, read_chat_msgs,
    rename_chat_msg, today_header as chat_today_header,
};
pub use checklist::{
    add_checklist_item, add_header_and_text, checklist_item, checklist_items,
    complete_checklist_item, incomplete_checklist_items, remove_checklist_item,
    remove_completed_checklist_items,
};
pub use fs::split_posix_path;
pub use fs::VirtualFs;
pub use fslog::FsLog;
pub use habits::{
    emoji_for_status, habit_emoji, habits, last_week_habits, weekday_emoji, write_habits,
};
pub use html::{
    escape_html, markdown_to_html, replace_with_placeholders, restore_from_placeholders,
    strip_html_tags,
};
pub use i18n::{add_emoji, emoji_for};
pub use journal::{
    add_emoji as journal_add_emoji, add_record as journal_add_record,
    today_header as journal_today_header, today_journal_filename,
};
pub use knowledge::{FileChange, KnowledgeBase, NoteHit};
pub use merge::merge;
pub use parser::{
    emoji_prefix, extract_headings, extract_markdown_links, is_multiline, lcfirst, levenshtein,
    norm_new_lines, similar, split_text_into_chunks, substr, today_chat_header, today_journal_path,
    ucfirst,
};
pub use plugins::{
    can_handle as world_clock_can_handle, format_report as format_world_clock_report,
    handle as world_clock_handle, world_clock_for_names, world_clock_now, TimezoneEntry,
};
pub use schedule::ScheduleManager;
pub use stats::{done_today, format_today_report, today_report, CompletedItem, TodayReport};
pub use sync::{MediaEntry, MediaSyncResponse, SyncEngine};
pub use tgtxt::{extract_text_imgs_links, ExtractResult};
pub use tokens::TokenManager;
pub use worker::{
    move_due_tasks, next_exclude_today, remove_completed_checklist, remove_completed_inbox_entries,
    remove_completed_items, schedule_report, NightlyReport,
};