feat: use snapshot design (#9)

* docs: remove snapshot command from README and refactor backup system to snapshot-based architecture

- Remove "One-time Snapshot" section from both English and Chinese READMEs
- Rename "Download Binary" to "Via Binary" in installation sections
- Refactor backup system from entry-based to snapshot-based architecture:
  - Replace BackupEntry with Snapshot and SnapshotFile interfaces
  - Add "create" event type to FileEventType
  - Change BackupIndex structure to use snapshots array instead of entries
  - Replace

* feat: add defensive null checks for snapshot data structures

- Add files array initialization when loading backup index to ensure all snapshots have files property
- Add null-safe array access with fallback to empty arrays in getAllSnapshots(), getFileHistory(), restoreSnapshot(), cleanupOldSnapshots(), and getBackupStats()
- Add null-safe size access with fallback to 0 in getBackupStats()
- Prevent potential runtime errors when accessing snapshots or files arrays that may be undefined

* feat: auto-load .gitignore patterns and expand default exclude patterns

- Add automatic .gitignore file reading and pattern merging in getDefaultConfig()
- Expand default exclude patterns to cover more system and build artifacts:
  - Change .git pattern to **/.*/** for all hidden files/directories
  - Add database files (*.db, *.sqlite, *.sqlite3)
  - Add lock and process files (*.lock, *.lck, *.pid)
  - Add system log and trace files (*.idx, *.etl, *.evtx, *.evt, *.trace, *.out, *.asl)
  - Add Windows

* update fix

* update fix

* update fix

* update fix

* update fix

* refactor: simplify restore command to use positional argument instead of flags

- Replace --id and --time flags with single positional argument accepting snapshot ID or timestamp
- Auto-detect input type: snap_* prefix for snapshot ID, numeric for timestamp
- Update help text and examples to show new usage: `shield restore <id>`
- Update interactive mode hints to reflect simplified command syntax
- Improve error message to show expected input formats

Author: tomsun28

README.md

@@ -22,7 +22,7 @@ A workspace history version management tool that protects your workspace from un
 npm install -g agentshield
 ```
 
-### Download Binary
+### Via Binary 
 
 ```bash
 curl -fsSL https://github.com/tomsun28/agentshield/raw/main/install.sh | bash
@@ -58,63 +58,16 @@ shield stop ./my-project
 shield status
 ```
 
-### Exec Mode (Recommended for Agent Tasks)
-
-```bash
-# Snapshot workspace, run command, then allow easy restore
-shield exec -- npm run agent-task
-shield exec -- python ai_script.py
-shield exec --path=./my-project -- cargo run
-```
-
-This mode:
-1. Takes a full snapshot before the command runs
-2. Executes your agent command
-3. Allows you to easily restore any modified files
-
-### One-time Snapshot
-
-```bash
-# Take a snapshot of current directory
-shield snapshot
-
-# Take a snapshot of specific directory  
-shield snapshot ./my-project
-```
-
 ### Restore Files
 
 ```bash
-# List all backups with timestamps (use for --time option)
+# List all backups with snapshot ID
 shield list
-# Restore all files to most recent backup
-shield restore
-
-# Restore only a specific file to its latest backup
-shield restore --file=src/index.ts
-
-# Restore all files to a specific timestamp
-shield restore --time=1737216000000
-
-# Restore a specific file to a specific timestamp
-shield restore --file=src/index.ts --time=1737216000000
 
+# Restore a specific snapshot by ID
+shield restore --id=<snapshot_id>
 ```
 
-### List Backups
-
-```bash
-# List all backups with details including timestamps
-shield list
-```
-
-The `list` command shows:
-- File path with event type icon (📄 changed, 🗑️ deleted, 📝 renamed)
-- Time ago and file size
-- Exact timestamp (for use with `--time` option)
-- ISO date string
-- Rename history (if applicable)
-
 ### Status and Cleanup
 
 ```bash

README_CN.md

@@ -22,7 +22,7 @@
 npm install -g agentshield
 ```
 
-### 二进制文件安装
+### 二进制安装
 
 ```bash
 curl -fsSL https://github.com/tomsun28/agentshield/raw/main/install.sh | bash
@@ -57,63 +57,16 @@ shield stop ./my-project
 shield status
 ```
 
-### Exec 模式（推荐用于代理任务）
-
-```bash
-# 快照工作区，运行命令，然后允许轻松恢复
-shield exec -- npm run agent-task
-shield exec -- python ai_script.py
-shield exec --path=./my-project -- cargo run
-```
-
-此模式会：
-1. 在命令运行前创建完整快照
-2. 执行你的代理命令
-3. 允许你轻松恢复任何修改过的文件
-
-### 一次性快照
-
-```bash
-# 创建当前目录的快照
-shield snapshot
-
-# 创建指定目录的快照  
-shield snapshot ./my-project
-```
-
 ### 恢复文件
 
 ```bash
-# 列出所有备份及时间戳（用于 --time 选项）
+# 列出所有变更及快照点
 shield list
 
-# 恢复所有文件到最近的备份
-shield restore
-
-# 仅恢复特定文件到其最新备份
-shield restore --file=src/index.ts
-
-# 恢复所有文件到特定时间戳
-shield restore --time=1737216000000
-
-# 恢复特定文件到特定时间戳
-shield restore --file=src/index.ts --time=1737216000000
+# 恢复文件到特定快照点
+shield restore --id=<snapshot_id>
 ```
 
-### 列出备份
-
-```bash
-# 列出所有备份详情，包括时间戳
-shield list
-```
-
-`list` 命令显示：
-- 文件路径及事件类型图标（📄 修改、🗑️ 删除、📝 重命名）
-- 相对时间和文件大小
-- 精确时间戳（用于 `--time` 选项）
-- ISO 日期字符串
-- 重命名历史（如适用）
-
 ### 状态和清理
 
 ```bash
@@ -133,4 +86,4 @@ shield clean --days=3
 
 ## 📄 开源协议
 
-[Apache License 2.0](./LICENSE)
+[Apache License 2.0](./LICENSE)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentshield",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "Instant file protection for AI agent operations - hardlink-based zero-copy backup system",
   "type": "module",
   "main": "dist/index.js",