* Add codeowners file (#1) * Add CMake build system with Makefile and comprehensive documentation (#3) * Add CMake build system with Makefile and comprehensive documentation - Add CMakeLists.txt with FetchContent for TDLib, nlohmann/json, spdlog, CLI11, and GoogleTest - Add Makefile with build-debug, build-release, clean-*, and format targets - Add .gitignore for C++ projects and VSCode - Add .clang-format based on Google style (120 cols, 4-space indent) - Add BUILDING.md with detailed build instructions and troubleshooting - Add CLAUDE.md with project structure and development workflow - Update README.md to reference BUILDING.md for technical details - Add placeholder main.cpp with FUSE headers and CLI11 integration - Add example GoogleTest test suite - Create directory structure: include/tg-fuse, src/, tests/ * Fix build system: add FUSE alias targets and mixed C++ standard support - Create fuse::fuse alias target for cross-platform consistency - Add proper FUSE library detection for macOS (use dylib instead of framework) - Fix macOS FUSE header path (fuse/fuse.h instead of osxfuse/fuse.h) - Enable mixed C++ standards: C++17 for TDLib, C++20 for tg-fuse - Add _FILE_OFFSET_BITS=64 via FUSE target interface - Update TDLib to use master branch (v1.8.0 incompatible with C++17 gperf) - Disable tests and benchmarks for third-party libraries - Add .claude to .gitignore * wip * Update default mount points to /mnt/tg (Linux) and /Volumes/tg (macOS) Changed from /dev/tg to /mnt/tg for Linux and /tmp/tg to /Volumes/tg for macOS. These are more canonical mount point locations for their respective platforms. Updated documentation files: - README.md: all code examples and platform notes - CLAUDE.md: project overview and mount points section - BUILDING.md: platform-specific notes Also removed references to requiring root access for /dev mounting. * Telegram interface (#4) * Add CMake build system with Makefile and comprehensive documentation - Add CMakeLists.txt with FetchContent for TDLib, nlohmann/json, spdlog, CLI11, and GoogleTest - Add Makefile with build-debug, build-release, clean-*, and format targets - Add .gitignore for C++ projects and VSCode - Add .clang-format based on Google style (120 cols, 4-space indent) - Add BUILDING.md with detailed build instructions and troubleshooting - Add CLAUDE.md with project structure and development workflow - Update README.md to reference BUILDING.md for technical details - Add placeholder main.cpp with FUSE headers and CLI11 integration - Add example GoogleTest test suite - Create directory structure: include/tg-fuse, src/, tests/ * Fix build system: add FUSE alias targets and mixed C++ standard support - Create fuse::fuse alias target for cross-platform consistency - Add proper FUSE library detection for macOS (use dylib instead of framework) - Fix macOS FUSE header path (fuse/fuse.h instead of osxfuse/fuse.h) - Enable mixed C++ standards: C++17 for TDLib, C++20 for tg-fuse - Add _FILE_OFFSET_BITS=64 via FUSE target interface - Update TDLib to use master branch (v1.8.0 incompatible with C++17 gperf) - Disable tests and benchmarks for third-party libraries - Add .claude to .gitignore * wip * Update default mount points to /mnt/tg (Linux) and /Volumes/tg (macOS) Changed from /dev/tg to /mnt/tg for Linux and /tmp/tg to /Volumes/tg for macOS. These are more canonical mount point locations for their respective platforms. Updated documentation files: - README.md: all code examples and platform notes - CLAUDE.md: project overview and mount points section - BUILDING.md: platform-specific notes Also removed references to requiring root access for /dev mounting. * Add TDLib wrapper library with comprehensive test suite Implement complete wrapper around TDLib with coroutine-based API, persistent SQLite caching, and comprehensive testing. Core Components: - types.hpp/cpp: Data structures (User, Chat, Message, MediaInfo, FileListItem) - exceptions.hpp: Exception hierarchy for error handling - async.hpp: C++20 coroutine support (Task<T>, TdPromise<T>) - cache.hpp/cpp: SQLite-based persistent cache with thread safety - client.hpp/cpp: TelegramClient with 22 coroutine-based API methods Test Suite: - types_test.cpp: 33 tests for type system and utilities - cache_test.cpp: 22 tests for cache operations (CRUD, concurrency, persistence) - async_test.cpp: 15 tests for coroutine functionality - All 73 tests passing with 100% pass rate Build System: - Add test-debug, test-release, test targets to Makefile - Disable TDLib tests via BUILD_TESTING flag - Add tglib static library target - Add SQLite3 dependency Examples: - simple_client.cpp: Demonstrates authentication, chat listing, messaging Documentation: - TESTING.md: Comprehensive test guide API Features: - Authentication flow (phone/code/password) - Entity operations (get_all_chats, resolve_username, search_public_chat) - Messaging (send_text, get_messages, get_last_message) - File operations (send_file with auto-detection, list_media, download_file) - Full TDLib integration with type conversions * Add TDLib wrapper documentation - TG_WRAPPER_README.md: Overview and quick start guide - TG_WRAPPER_DESIGN.md: Architecture and design decisions - TG_WRAPPER_USAGE.md: Comprehensive usage guide with examples * Add mock FUSE daemon with CLI companion app (#5) * Add mock FUSE daemon with CLI companion app Implement a functional FUSE filesystem daemon (tg-fused) with mock data for development and testing. The daemon supports: - Virtual directory structure: users/, groups/, channels/ - Symlinks for quick access: @username -> users/username - Read-only .info files with mock entity data - Platform abstraction layer for macFUSE (FUSE2) and libfuse3 - Proper daemonisation with file logging to ~/.local/share/tg-fuse/logs/ - Verbose logging via -v flag (stackable: -v, -vv, -vvv) - User-only file permissions (0700 dirs, 0400 files) - Effective uid/gid as filesystem owner CLI companion app (tg-fuse) provides subcommands: - mount: spawns daemon via exec() - login/logout/status: placeholders for future Telegram auth Build produces binaries in bin/ directory. * fmt * Add interactive login command with config management (#6) - Add `tg-fuse config set --api-id=XXX --api-hash=YYY` for API credentials - Add `tg-fuse login` for interactive Telegram authentication - Add `tg-fuse logout` and `tg-fuse status` commands - Store config in XDG directories (~/.config/tg-fuse/, ~/.local/share/tg-fuse/) - Redirect spdlog and TDLib logs to files instead of stderr - Fix client stop() order to prevent segfault on exit - Add progress dots while waiting for TDLib state changes - Update README with setup instructions * feat: List users in daemon (#7) * Add TelegramDataProvider with real user data from Telegram - Implement TelegramDataProvider backed by TelegramClient cache - Add users CLI command for debugging (tg-fuse users --list) - Display user names instead of numeric IDs for users without usernames - Use absolute symlink paths from mount point for clarity - Change symlink permissions to 0755 for cleaner display - Refactor daemon to initialise after forking (fixes hang on daemonise) - Root symlinks only shown for contacts with actual usernames * Fix .info file truncation due to size mismatch The getattr was calculating file size before fetching bio/full user info, while read_file fetched this data lazily, resulting in larger content than the reported size. Use a fixed 4KB size for .info files since their content is generated dynamically. * Address PR review comments for TelegramDataProvider - Move enum defaults to beginning (PathCategory::NOT_FOUND, UserStatus::UNKNOWN) - Change sanitise_for_path return type to std::filesystem::path - Add mutable qualifier to users_loaded_ for const-correctness - Refactor path operations to use std::filesystem::path - Add constants.hpp with kUsersDir, kContactsDir, kInfoFile - Add thread-safety documentation comments * Add 'self' symlink to VFS root pointing to current user - Add get_me() to TelegramClient using TDLib's getMe API - Add kSelfSymlink constant for the symlink name - Add SELF_SYMLINK path category and current_user_ cache - Display 'self' symlink in root directory listing - Handle /self in get_entry(), read_link(), and parse_path() * feat: List groups & channels (#8) * Add groups listing to FUSE filesystem - Add /groups/ directory listing groups and supergroups - Groups with username display username, otherwise display title (sanitised) - Each group has .info file with title, username (if public), and type - Group mtime set to last message timestamp * Add channels listing and sanitise directory names Implements /channels directory following the same pattern as groups: - Lists all channels from Telegram cache - Each channel has a .info file with title, username (if public), and type - Directory naming uses username if available, sanitised title otherwise Also enhances sanitise_for_path to: - Filter out emoji characters for easier terminal usage - Collapse multiple consecutive spaces into one - Trim leading and trailing spaces * feat: Messages (#9) * Add messages file with LRU cache and fmt-based formatting Add a `messages` file to each chat directory: - Read: displays recent messages as markdown blockquotes - Write: sends new messages (append-only) Key components: - FormattedMessagesCache: LRU cache for pre-formatted message content - Message callback: TDLib notifies cache on new messages - fmt/bustache: fast formatting without std::stringstream - Write detection: uses cached content size to extract new text New files: - include/fuse/message_formatter.hpp - message formatting interface - include/fuse/messages_cache.hpp - LRU cache with RCU-style updates - include/tg/formatters.hpp - fmt formatters for tg types - src/fuse/message_formatter.cpp - fmt-based message formatting - src/fuse/messages_cache.cpp - cache implementation Dependencies added: - fmt 10.2.1 (external, shared with spdlog) - bustache (mustache templating for future custom formats) * Refactor message formatting to use proper fmt formatters Replace custom stringstream-based formatting with fmt library formatters for tg types. Introduce MessageInfo struct that bundles message, sender, and chat for unified formatting. Use fmt::join for formatting message vectors. - Add fmt formatters for UserStatus, ChatType, MediaType, MediaInfo - Add User formatter with format specs (:d, :u, :f, :i) - Add Chat and MessageInfo formatters - Simplify MessageFormatter to utility functions only - Update messages cache to use UserResolver and ChatResolver - Add comprehensive formatter tests (34 new tests) * Add rate-limited background message prefetching with persistent cache - Add ChatMessageStats to SQLite for persisting message metadata (message count, content size, last_message_time for mtime) - Convert FormattedMessagesCache to TLRU with 1-hour TTL for staleness - Implement RateLimiter to avoid Telegram API flood bans - Add BackgroundPrefetcher for priority-ordered prefetching (contacts → users → groups → channels by last_message_time) - Update TelegramDataProvider to use persisted stats for fstat - Add get_messages_until() for fetching messages with age/count limits * Add customisable message formatting with bustache templates - Add message_format config option (default: "> **{{sender}}** [{{time}}]: {{message}}") - Compile bustache template once at cache construction (thread-safe) - Replace fmt-based formatting with bustache template rendering - Add bustache formatters for MessageInfo (sender, time, message placeholders) - Add bustache format tests * Update README and fix timestamp format fallback - Remove development status section from README - Update filesystem structure to show messages files - Add contacts symlinks documentation - Fix timestamp format fallback to use ISO date format * feat: Files (#11) * Add files directory with document listing and cache CLI - Add /users/<name>/files/, /groups/<name>/files/, /channels/<name>/files/ directories that list documents shared in each chat - Files are named with timestamp prefix: YYYYMMDD-HHMM-filename.ext - Use TDLib searchChatMessages API with proper filters for efficient file discovery (documents and media cached separately) - Only show documents in files/ directory (filter out photos/videos) - Cache files permanently in SQLite with 1-year history limit - Add rate limiting (50ms between batches) for API requests Add cache management CLI commands: - tg-fuse cache stats: show cache statistics - tg-fuse cache clear-files <entity>: clear file cache for a chat - tg-fuse cache clear-all-files: clear all file caches - tg-fuse cache clear-all: clear all caches Cache CLI accesses SQLite directly without TDLib, so it works while the filesystem is mounted. * Implement file download for files/ directory - Add read_file support for files in files/ directory - Use persistent remote file IDs instead of local file IDs (local IDs change between sessions, remote IDs are stable) - Update download_file_sync to use getRemoteFile API - Increase download timeout to 2 minutes for large files * Add media/ directory for photos, videos and animations - Add kMediaDir constant and media path categories - Implement media/ directory listing with is_media_type filter - Support media file download and reading - Extract download_and_read_file() helper to reduce duplication - files/ shows documents, audio, voice, stickers - media/ shows photos, videos, animations (GIFs) * Update README with files/ and media/ directory structure Document the new directories for accessing shared files and media from chats, including timestamp-prefixed filename format. * Add file upload support for sending files to Telegram chats (#13) * Add file upload support to files/ and media/ directories Implement file upload via cp to send files to Telegram chats: - cp file.pdf /mnt/tg/users/alice/files/ → sends as document - cp photo.jpg /mnt/tg/users/alice/media/ → sends as compressed media Features: - Pending upload tracking with temp files in /tmp/tg-fuse/uploads/ - SHA256-based upload cache for deduplication (reuse remote file IDs) - File size validation against Telegram limits (2GB regular, 4GB premium) - macOS fcopyfile compatibility (chflags, setattr_x, fsetattr_x callbacks) - Completed uploads remain visible in directory listings for 30 seconds Also adds send_file() to TelegramClient for uploading local files as documents or media via TDLib's sendMessage with appropriate content types. * Fix parse_path() to properly categorise uploads to chat directories The previous code had duplicate `else if (components.size() == 3)` blocks that were unreachable. Now unknown files in chat directories are properly categorised as USER_UPLOAD/GROUP_UPLOAD/CHANNEL_UPLOAD, enabling: cp file.txt /mnt/tg/users/alice/ → sent as text message (auto-detect) cp photo.jpg /mnt/tg/users/alice/ → sent as compressed media cp doc.pdf /mnt/tg/users/alice/ → sent as document * Update README with file upload documentation Document the new file upload feature: - Auto-detection of file types (text/media/document) - Explicit upload via files/ and media/ directories - Upload deduplication via file hash caching - File size limits * Fix async file upload by deferring temp file cleanup TDLib's sendMessage returns immediately while file upload continues asynchronously in the background. The temp file was being deleted before TDLib finished reading it, causing "file can't be opened" errors. Changes: - Add updateMessageSendSucceeded/Failed handlers in TelegramClient - Track pending uploads by message ID to temp file path mapping - Clean up temp files only after TDLib confirms upload success/failure - Add invalidate_upload() to CacheManager for cache miss handling - Disable upload caching until we can reliably get remote file IDs * Fix README repository links and remove deduplication note - Fix repository URLs to point to zmij/tg-fuse - Remove upload deduplication mention (feature temporarily disabled) * Add upload deduplication cache Cache file hashes and remote file IDs to avoid re-uploading the same file when sending to multiple chats. The remote file ID is extracted from updateMessageSendSucceeded after TDLib completes the upload. - Add send_file() overload accepting file hash and size for caching - Track pending uploads with hash info in TelegramClient - Extract remote file ID from message content on upload success - Check cache before upload, use send_file_by_id() on cache hit - Invalidate cache and re-upload if cached remote ID fails * Fix README: use /groups/ path instead of # prefix * Update TG wrapper documentation to reflect current implementation - Remove all "pending stub" references - everything is now implemented - Update directory structure to use /users/, /groups/, /channels/ - Remove obsolete #groupname notation - Add upload deduplication documentation - Add new API methods: get_me(), get_messages_until(), send_file_by_id(), set_message_callback() - Add upload cache methods documentation - Update implementation status to show all features complete - Add FUSE integration patterns and file structure 🤖 Generated with [Claude Code](https://claude.com/claude-code) * Add txt file for sending text messages (#18) * Add txt file for sending text messages (#17) Enable sending text messages by writing to a dedicated txt file: - echo 'Hello' > /mnt/tg/users/alice/txt - echo 'Hello' > /mnt/tg/text/@alice (symlink) Features: - Add txt file to each chat directory (users, groups, channels) - Add /text/ directory with symlinks to user txt files - Make messages file read-only (use txt for sending) - Streaming support: buffers until 4096 bytes then sends - Smart splitting at newline/UTF-8 boundaries - Rate limit protection: 1s minimum between sends - Buffer overflow protection: 40KB max (fails write if exceeded) - Reading txt returns last sent message content * Update README with txt file documentation - Add txt file to filesystem structure - Add /text/ directory with symlinks - Change messages to read-only in docs - Add new "Sending Text Messages" section - Update quick start examples to use txt * Hide txt file for read-only chats - Add can_send_messages field to Chat struct - Extract permission from TDLib chat.permissions_.can_send_basic_messages_ - Only show txt file in groups/channels where user can send messages - Return NOT_FOUND for txt path if chat is read-only This prevents exposing txt files for channels/groups where the user doesn't have permission to post messages. * Persist can_send_messages field in SQLite cache Add can_send_messages column to chats table schema and read it back in all get_cached_chat*() functions. This ensures txt files are properly hidden for read-only channels and groups after restart. The schema already includes the column; this adds reading it back. * Add chat preloading and cache invalidation for faster startup - Add preload_chats() method using TDLib's loadChats API to trigger batch updateNewChat events instead of waiting for slow individual updates - Add chat and user callbacks to invalidate caches when TDLib sends updates (updateNewChat, updateUser events) - Call get_me() and preload_chats() at startup in TelegramDataProvider to populate data immediately - Disable kernel directory caching with FUSE mount options (attr_timeout=0, entry_timeout=0, negative_timeout=0) so ls shows fresh data when chats are updated - Include current user in users list via ensure_current_user_loaded() This significantly improves cold start performance - chats are now available almost immediately instead of populating slowly over time. * Add timeout-based flushing for txt streaming writes When writing to txt files via streaming (e.g., tail -f | grep > txt), the buffer is now automatically flushed after 2 seconds of inactivity. This ensures messages are sent even for low-volume streams that don't fill the 4096-byte buffer threshold. Implements a background flusher thread that: - Wakes every second to check for stale buffers - Flushes any buffer with no writes for 2+ seconds - Performs final flush of all buffers on shutdown * Move SQLite cache to dedicated directory Separate tg-fuse's SQLite cache from TDLib's database: - Cache now stored in ~/.local/share/tg-fuse/cache/ - TDLib database remains in ~/.local/share/tg-fuse/tdlib/ This provides cleaner separation between our application data and the underlying TDLib storage.

Send text via writing #17

Description

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions