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 使用的上下文片段。（规范 §9：<UUID> 缺省为当前节点。）

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，只能登记在 ROOT 下）。

norm

输出归一化 JSON。

open

打开 bundle：<dir> 可为 bundle 根，也可为其内部的分支/内容目录。

ref_add

新增跨枝关联线。（规范 §9：源分支 <UUID> 缺省为当前节点；--target 仍必填。）

ref_rm

删除关联线。

reveal

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

show

打印某分支的 ._meta（归一化 JSON）。（规范 §9：<UUID> 缺省为当前节点。）

spec_set

str spec set：把整份 bundle 声明的规范版本（._meta.spec）统一改写为 version。

sync

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

tree

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

validate

校验整个 bundle。