feat(bucket): implement bucket initialization and logging infrastructure

Add bucket init logic with directory structure creation and log macros
for tracing

1 files changed, 175 insertions, 2 deletions

diff --git a/rola-cli/locales/helps/basic.toml b/rola-cli/locales/helps/basic.toml
index 656cdc4..ff0dfd1 100644
--- a/rola-cli/locales/helps/basic.toml
+++ b/rola-cli/locales/helps/basic.toml
@@ -1,9 +1,182 @@
 [en]
 help = """
-NO YET
+[[b_blue]]**Usage**[[/]]: **rola** [-v | --version] [-h | --help] [-L | --lang *<LANG>*]
+__          **OUTPUT CONTROL:**
+__            [--silence | --quiet] [--no-error] [--no-result]
+__            [--no-color] [--json | --json-pretty]
+__          **LOGS:**
+__            [-V | --verbose] [--log-time]
+__            [--log-level _disable_ | [[gray]]_trace_[[/]] | [[b_cyan]]_debug_[[/]] | [[b_yellow]]_warn_[[/]] | [[b_red]]_error_[[/]]]
+__          **CONTEXT:**
+__            [--bucket-dir *<DIR>*] [--draft-dir *<DIR>*] [--dir *<CWD>*]
+__          **BEHAVIOUR CONTROL:**
+__            [[b_yellow]]**[-y | --yes]**[[/]] [[b_red]]**[-O | --overwrite]**[[/]] [--no-pager]
 """
 
 [zh_CN]
 help = """
-暂无
+[[b_blue]]**用法**[[/]]：**rola** [-v | --version] [-h | --help] [-L | --lang *<LANG>*]
+__         **输出控制：**
+__           [--silence | --quiet] [--no-error] [--no-result]
+__           [--no-color] [--json | --json-pretty]
+__         **日志：**
+__           [-V | --verbose] [--log-time]
+__           [--log-level _disable_ | [[gray]]_trace_[[/]] | [[b_cyan]]_debug_[[/]] | [[b_yellow]]_warn_[[/]] | [[b_red]]_error_[[/]]]
+__         **上下文：**
+__           [--bucket-dir *<DIR>*] [--draft-dir *<DIR>*] [--dir *<CWD>*]
+__         **行为控制：**
+__           [[b_yellow]]**[-y | --yes]**[[/]] [[b_red]]**[-O | --overwrite]**[[/]] [--no-pager]
 """
+
+
+# 全局：
+# --draft-dir 草稿路径
+# --bucket-dir 桶路径
+# --dir 路径
+# -V --version
+# -v --verbose
+# -h --help
+# -L --lang --language
+# --json --json-pretty
+# --no-color --no-pager
+# --no-error --only-error
+# --quiet / --silence
+# -y / --yes
+# --overwrite
+
+# # 创建草稿，临时视图
+# rola create --draft
+# rola init --draft
+
+# # 创建桶，存储库，远程真相
+# rola create --bucket
+# rola init --bucket
+
+# # 仅 draft 中命令
+# # 桶
+# rola bucket origin --bind-to-url url
+# rola bucket origin --delete / -D
+# rola bucket origin --rename-to other
+# rola bucket # 列出
+# rola bucket origin # 显示元数据
+
+# # 检查连接
+# rola test-connection --url url
+# rola test-connection --bucket origin
+
+# # 信息同步
+# rola update
+# rola update --all
+
+# # 视图
+# rola view # 列出所有视图
+# rola view THIS # 当前视图
+# rola view origin/main # 主视图
+# rola view --new other # 新建视图
+# rola view --clone other # 克隆视图
+# rola view --checkout-clone other # 新建视图并直接切换
+# rola view --checkout-new other # 新建视图并直接切换
+# rola view --checkout other # 切换
+# rola view origin --rename-to other # 命名
+# rola view --forget origin # 忘记视图
+# rola view origin/main --track-to main # 跟踪
+# rola view main --track-to origin/main # 跟踪
+# rola view main --break-track # 断开跟踪
+# rola view --show-track # 展示跟踪状态
+# rola view main --show-track # 展示跟踪状态
+# rola view main --up-track # 同步视图 上传 (只提醒使用--overwrite-up-track)
+# rola view main --overwrite-up-track # 同步视图 上传
+# rola view main --down-track # 同步视图 下载
+
+# # 状态
+# rola status --view main # 检查视图状态 （等效 rola view main）
+# rola status # 检查草稿状态（如果在draft）
+# rola status # 检查桶状态（如果在bucket）
+# rola status --file ./file # 检查文件状态
+# rola status --file . # 检查多个文件状态
+# rola status --bucket origin # 检查远程桶状态 (等效 rola bucket origin)
+# rola status --bucket-url url # 检查url状态 (等效 rola test-connection --url url)
+# rola status --align task # 检查对齐状态 (等效 rola align task)
+# rola status --align-task # 检查所有对齐状态 (等效 rola align)
+
+# # 实际版控
+# rola set-forward ./my.file --follow latest # 将文件总是追踪最新版本
+# rola set-forward ./my.file --follow ver:16 # 锁定到16版本
+# rola set-forward ./my.file --follow origin/main # 跟随某个view的版本
+
+# rola track . # 跟踪文件
+# 为每个文件判断：
+# 在 forward 为 latest 时
+# 1. 本地版本同步，且已修改：尝试上传（可能冲突）
+# 2. 本地版本不同步，且未修改：下载
+# 3. 本地版本不同步，且已修改：阻止！（使用 --overwrite 覆盖）
+# 4. 在 3 的情况下，使用 --overwrite 覆盖本地（或显式使用 --down --overwrite）
+# 5. 在 3 的情况下，使用 --up --overwrite 覆盖远程（强制提交）
+# 在 forward 为 ver 时
+# 1. 本地版本同步 ver，且已修改：阻止！（使用 --overwrite 覆盖）
+# 2. 本地版本不同步 ver，且未修改：下载
+# 3. 本地版本同步 ver，未修改，什么都不做
+# 在 forward 为 view 时
+# 1. 如果view中没有该文件，阻止！（使用 --allow-non-forward）
+# 2. 如果view中没有该文件，且使用 --allow-non-forward：不做任何事
+# 3. 如果view存在该文件，将view中该文件的版本视作ver，同（在 forward 为 ver 时）的行为
+
+# 显式模式：
+# --up --down 显式指定上传或下载，若状态不一，必须使用 --overwrite
+
+# # 对齐
+# rola align # 查看所有本地 view 和实际结构不一致的情况（移动、新增、丢失）
+# rola align 移动项 --connect 丢失项
+# rola align 丢失项 --connect 移动项 # 匹配为移动
+# rola align 移动项 --confirm # 确认移动
+# rola align 新增项 --confirm # 确认新增
+# rola align 丢失项 --confirm # 确认丢失 (为删除)
+# rola align --confirm-all # 全部确认（谨慎！）
+# rola align 移动项 --break # 断开为丢失和新增
+# rola align 项 # 查看项
+
+# # view 之间操作 (--overwrite 覆写)
+# rola send 文件 --to-view view # 将该文件发送到view（同当前view的位置）
+# rola send 文件 --to-view view --path # 将文件发送到view（指定位置）
+# rola send view:文件 --to-view ... # 使用指定view的文件
+# rola send view:文件 --to-view THIS # 从其他view拉取文件到此处
+# rola send bucket/view:文件 --to-view THIS # 从远程view拉取文件到此处
+
+# # 直接 view-tree 操作（危险的修复行为）
+# rola op-view-tree rm path # 删除某条路径记录
+# rola op-view-tree add path --id 文件id # 新增某条路径记录
+# rola op-view-tree set path --forward xx --id xx # 修改某条路径记录
+# rola op-view-tree mv path ... path2 # 移动某条路径记录
+# rola op-view-tree cp path ... path2 # 移动某条路径记录
+# rola stack view1 view2 view3 ... --clone-into view4 (将view1 view2 view3的视图堆叠成一个视图，放置到view4)
+# rola stack ... --into view4 (同上，但是会删除旧视图)
+# rola op-idmap ls # 列出所有 id map
+# rola op-idmap ls id # 列出关于该 id 的映射
+# rola op-idmap ls --remote id # 反向查找：通过远程 id 查找本地 id
+# rola op-idmap write 12 --to-remote 25 # 将 12 号 id 映射到 远程 id 25
+# rola op-idmap clean 12 # 将 12 号 id 映射移除
+# rola op-idmap clean --remote 12 # 将映射到远程12号id的本地id移除
+
+# # 查询操作
+# rola query bind-buckets
+# rola query views
+# rola query idmaps
+# rola query objects
+
+# # 视图查看
+# rola ls # 等效别名 (rls)：展示当前目录的元数据（富有rola元数据的ls命令）
+# rola tree # 等效别名 (rtree): 展示当前目录的树
+
+# # GUI
+# rola desktop --install # 安装 RorolalaVCS - Dashboard
+# rola desktop # 启动 RorolalaVCS - Dashboard
+
+# # 更新
+# rola source show # 展示远程更新源
+# rola source update-info # 更新远程信息
+# rola source update # 更新rola
+# rola source change 源 # 切换更新源
+# rola source show-info # 查询更新信息
+
+# # 交互式
+# rola op-view-tree --shell-mode # 进入 REPL 直接使用 cd ls rm add set mv 操作 tree