Stacks 2 项目/看板索引模块。 More...

Classes
struct	ProjectSync::DbPaths
	项目索引数据库路径。 More...
struct	ProjectSync::SyncSummary
	同步结果摘要；用于 CLI、Alfred 反馈和接口日志。 More...

Enumerations
enum class	ProjectSync::SyncError { ProjectSync::search_path_missing , ProjectSync::search_path_not_directory , ProjectSync::project_db_unreadable , ProjectSync::project_file_unreadable , ProjectSync::io_failure }
	工作区同步的可恢复错误分类。 More...

Functions
std::expected< SyncSummary, SyncError >	ProjectSync::sync_all (const std::filesystem::path &search_path, const DbPaths &paths={})
	同步新增路径与全部已记忆路径，并原子重建两个索引。
template<std::invocable< const std::filesystem::directory_entry & > Visitor>
void	ProjectSync::for_each_project_file (const std::filesystem::path &directory, Visitor &&visitor)
	递归遍历工作区中的 .project 文件。
std::string_view	ProjectSync::sync_error_message (SyncError error) noexcept
	SyncError 到稳定、可读的 CLI/Alfred 错误文本。
std::string	ProjectSync::format_file_time (std::filesystem::file_time_type file_time)
	把 filesystem 写入时间转换为本地 YYYY-MM-DD HH:MM:SS。

Detailed Description

Stacks 2 项目/看板索引模块。

本模块只负责读取已保存的工作区路径、扫描 .project 文件并原子重建 data/Project.json 与 data/Stack.json。业务任务的增删改查在 TaskManager 中完成。

设计约束：

Files
file	/Users/runner/work/CXX-CMake-template/CXX-CMake-template/single-exe-static-modules/modules/project_sync/include/ProjectSync.cppm

Classes