@chiimagnus/applebookscli 0.2.1 → 0.3.0

package/README.md

@@ -13,6 +13,7 @@ English | [简体中文](README.zh.md)
 - Extract PDF highlights and notes.
 - Export JSON, CSV, Markdown, or HTML.
 - **Safely update notes and manage collections, with an automatic backup before writes.**
+- Review the last 24 hours of AppleBooksCLI write/sync tool calls through local operation history.
 - Provide a standard `applebookscli` Agent Skill in English and Chinese.
 
 ## Requirements
@@ -27,8 +28,6 @@ npm install --global @chiimagnus/applebookscli@latest
 npx -y skills@1.5.23 add "chiimagnus/AppleBooksCLI#v$(applebookscli --version)" --skill applebookscli --global
 ```
 
-For the Chinese Skill, replace `applebookscli` with `applebookscli-zh` in the second command.
-
 Future npm upgrades keep an Agent Skills CLI-managed Skill on the same CLI release tag automatically. `--ignore-scripts` disables that automatic update.
 
 ## Help
@@ -144,6 +143,17 @@ applebookscli sync --json
 
 `sync` only processes already pending collection/member/annotation cloud records and does not trigger the lifecycle when none are pending. Acknowledgement proves only that **this Mac** completed the Apple Books CloudKit upload; it does not prove that another device already displays the change. A post-commit `cloud_sync_failed` must not cause an automatic mutation retry, and restoring a BKLibrary snapshot is not equivalent to replaying individually flushable cloud mutations.
 
+## Operation history
+
+AppleBooksCLI keeps a private local history of the last 24 hours of its annotation/collection mutations, backup restores, and explicit `sync` calls. `history list` returns only summaries; `history get` is the explicit full-detail read and may contain the original note/title/details/selectors plus captured stdout/stderr.
+
+```sh
+applebookscli history list --json
+applebookscli history get <history-id> --json
+```
+
+History is stored only for the current user under AppleBooksCLI's Application Support directory. AppleBooksCLI does not send it as telemetry or sync it between devices, and history is evidence of prior tool calls rather than an undo engine.
+
 ## Optional configuration
 
 Most users do not need a configuration file. `~/.config/applebookscli/config.json` is only needed for an additional EPUB directory or to supplement title/author metadata for historical annotations.

package/README.zh.md

@@ -13,6 +13,7 @@
 - 提取 PDF 划线与笔记。
 - 导出 JSON、CSV、Markdown 或 HTML。
 - **安全修改笔记、管理藏书，并在写入前自动备份。**
+- 通过本地 operation history 查看最近 24 小时的 AppleBooksCLI 写入/同步 tool calls。
 - 提供标准 `applebookscli` Agent Skill，并提供英文/中文两个版本。
 
 ## 系统要求
@@ -27,8 +28,6 @@ npm install --global @chiimagnus/applebookscli@latest
 npx -y skills@1.5.23 add "chiimagnus/AppleBooksCLI#v$(applebookscli --version)" --skill applebookscli-zh --global
 ```
 
-英文 Skill 把第二条命令里的 `applebookscli-zh` 改成 `applebookscli` 即可。
-
 以后通过 npm 升级 CLI 时，由 Agent Skills CLI 管理的 Skill 会自动跟随到相同的 CLI release tag。使用 `--ignore-scripts` 会关闭这项自动更新。
 
 ## 获取帮助
@@ -144,6 +143,17 @@ applebookscli sync --json
 
 `sync` 只处理已存在的 pending collection/member/annotation cloud records；无 pending 时不触发生命周期。acknowledgement 只证明**当前 Mac** 已完成 Apple Books CloudKit upload，不等于另一台设备已经显示。post-commit `cloud_sync_failed` 不能触发自动重试；BKLibrary restore 也不等同于可逐条 flush 的 cloud mutation。
 
+## 操作历史
+
+AppleBooksCLI 会在本机私有保存最近 24 小时的批注/藏书 mutation、backup restore 与显式 `sync` 调用。`history list` 只返回摘要；只有显式 `history get` 才返回完整记录，其中可能包含原始 note/title/details/selector 以及捕获的 stdout/stderr。
+
+```sh
+applebookscli history list --json
+applebookscli history get <history-id> --json
+```
+
+History 只存放在当前用户的 AppleBooksCLI Application Support 目录中；AppleBooksCLI 不把它作为 telemetry 上传，也不跨设备同步。它只是既往 tool call 的证据，不是 undo engine。
+
 ## 可选配置
 
 大多数用户不需要配置文件。只有需要指定额外的 EPUB 目录，或给历史批注补充书名/作者信息时，才需要 `~/.config/applebookscli/config.json`。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chiimagnus/applebookscli",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Native Apple Books CLI for macOS on Apple Silicon.",
   "license": "AGPL-3.0-only",
   "repository": {