Module cmd 

CLI 子命令实现（规范第 9 章）。

Structs

EntryPatch

str entry set 的字段补丁：None 表示不改动，Some("") 表示移除该键。

Functions

abs

便捷：把相对路径映射为绝对路径。

author_add

str author add：按 id 新增 / 覆盖一条 [[authors]]（规范 §4.4）。

author_rm

str author rm：按 id 删除一条 [[authors]]。

branch_add

在指定分支下新增关联分支（任意深度）。

branch_rm

删除关联分支（含其全部下级）。

context

生成供 AI 使用的上下文片段。

entry_set

str entry set：设置某分支 entries[] 中指定 path 条目的字段。

export

导出为单一 JSON / TOML（派生数据，只读）。

fmt

按规范 §4.9 键序 / 表序重写 ._meta（保注释）。

init

创建一个新的 .str bundle。

list_codes

列出全部错误码（测试矩阵用）。

locate

定位某 uuid 对应的 visit 下标。

ls

列出某分支的清单（读 ._meta）或磁盘原始内容。

media_type_for

依据扩展名猜测媒体类型。

meta_set

str meta set：设置分支自身（._meta 顶层）的元信息字段。

node_add

新增独立节点（深度 1）。

norm

输出归一化 JSON。

open

打开 bundle。

ref_add

新增跨枝关联线。

ref_rm

删除关联线。

reveal

平台适配：macOS 上把 .str 目录标记为 bundle，并让 ._meta 可见。

show

打印某分支的 ._meta（归一化 JSON）。

sync

用磁盘实际状态修正全部 entries，并更新 size / sha256。

tree

渲染分支树（含 refs 关联线）。

validate

校验整个 bundle。