How laserattack/mado2 works
Mado is a command-line markdown organizer whose entries live in a local MADO/ directory. The visible workflow dispatches a command, parses an optional query, asks the repository to find or remove matching entries, then formats results; init and new provide repository and entry creation. The query language and entry model are distinct domain stages, with common text/time utilities as an internal layer. The README gives no feature inventory, and some source is unsampled, so uncertain internal links are omitted or marked unverified.
Main entry points: repository.cpp Repository · command.cpp Commands · parser.cpp Query Parser · main.cpp CLI Entry
Components 17
CLI
- CLI Entry
code/cli/main.cpp - Commands
code/cli/command.cpp - Flag Parser
code/cli/3rdparty/flag.h/flag.h - Flag Context
code/cli/flag_context.hpp - Output Formatters
code/cli/entry_info_format.cpp
Query Language
- Query Lexer
code/libmado/src/query/lexer.cpp - Query Parser
code/libmado/src/query/parser.cpp - Query AST
code/libmado/src/query/ast.cpp - Unicode Processing
code/libmado/3rdparty/utf8proc/utf8proc.c - Query Interpreter
code/libmado/src/interpreter/interpreter.cpp
Entries And Storage
- Repository
code/libmado/src/repository/repository.cpp - Entry Model
code/libmado/src/entry/entry.cpp
Common Utilities
- Text Utilities
code/libmado/src/common/text_utils.cpp - Time Utilities
code/libmado/src/common/time_utils.cpp - Fuzzy Matching
code/libmado/src/common/fuzzy_match.cpp
Other components
- User
- Local Filesystem
Connections 17
- User → CLI Entry: runs
code/cli/main.cpp - CLI Entry → Flag Context: parses flags
code/cli/main.cpp - Flag Context → Flag Parser: wraps
code/cli/flag_context.hpp - CLI Entry → Commands: dispatches
code/cli/main.cpp - Commands → Query Lexer: tokenizes query
code/cli/command.cpp - Commands → Query Parser: parses query
code/cli/command.cpp - Commands → Repository: runs operations
code/cli/command.cpp - Commands → Output Formatters: formats results
code/cli/command.cpp - Query Parser → Unicode Processing: uses Unicode
code/libmado/src/query/parser.cpp - Repository → Query Interpreter: evaluates filters
code/libmado/src/repository/repository.cpp - Repository → Text Utilities: uses text helpers
code/libmado/src/repository/repository.cpp - Repository → Time Utilities: uses time helpers
code/libmado/src/repository/repository.cpp - Repository → Entry Model: loads entries
code/libmado/src/repository/repository.cpp - Repository → Local Filesystem: reads and writes
code/libmado/src/repository/repository.cpp - Query Lexer → Query Parser: supplies tokens
- Query Parser → Query AST: builds tree
- Query Interpreter → Query AST: evaluates tree