jfox-cli 0.9.0__tar.gz → 0.10.0__tar.gz

{jfox_cli-0.9.0 → jfox_cli-0.10.0}/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to jfox-cli will be documented in this file.
 
+## [0.10.0] - 2026-06-06
+
+### Features
+- **auto-summary**: progress visibility + remove 7-day scan limit (#235)
+- **daemon**: interactive auto-summary prompt on daemon start (#233)
+- add pi skills and package.json for pi-package support
+- **daemon**: add restart command
+
+### Fixes
+- Issue #224 CR leftovers — atomic write + CAS + interruptible Popen + threading.Event (#236)
+
+### Changes
+- **README**: add auto-summary section with implementation details
+- ignore pr-monitor state and tmp issue body files
+- add superpowers plans and spec for recent work
+
+[0.10.0]: https://github.com/zhuxixi/jfox/compare/v0.9.0...v0.10.0
+
 ## [0.9.0] - 2026-05-22
 
 ### Features

{jfox_cli-0.9.0 → jfox_cli-0.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jfox-cli
-Version: 0.9.0
+Version: 0.10.0
 Summary: JFox - Zettelkasten 知识管理 CLI 工具
 Project-URL: Homepage, https://github.com/zhuxixi/jfox
 Project-URL: Repository, https://github.com/zhuxixi/jfox
@@ -363,6 +363,35 @@ jfox query "Luhmann's methodology" --depth 2
 | `jfox daemon stop` | Stop embedding daemon |
 | `jfox daemon status` | Show daemon PID, port, model info |
 
+### Auto-Summary
+
+Auto-summary runs inside the daemon to automatically archive Claude Code sessions into your knowledge base. It scans `~/.claude/projects/` for finished sessions, generates a structured summary via `claude -p`, and writes it as a `session` type note.
+
+A session is considered "finished" when its file has not been modified for `idle_threshold` minutes (default: 30).
+
+| Command | Description |
+|---------|-------------|
+| `jfox auto-summary enable` | Enable auto-summary in daemon |
+| `jfox auto-summary disable` | Disable auto-summary |
+| `jfox auto-summary status` | Show config and ledger statistics |
+| `jfox auto-summary scan` | List sessions that would be processed |
+| `jfox auto-summary run` | Manually trigger a summary round |
+| `jfox auto-summary run --dry-run` | Preview without writing |
+
+**Key options:**
+- `--interval` — Scan interval in minutes (default: 30)
+- `--idle-threshold` — Minutes of inactivity to consider a session finished (default: 30)
+- `--kb` — Target knowledge base for saved notes
+
+**How it works:**
+
+- Uses `claude -p` (non-interactive mode) to generate summaries from stdin/stdout
+- Runs with `--permission-mode bypassPermissions` so the daemon never blocks on permission prompts
+- Tracks processed sessions in `~/.zk_auto_summary_state.json` to avoid duplicates; transient failures are retried up to 3 times before giving up
+- A session is eligible only after its file has been idle for `idle_threshold` minutes (no new content)
+
+> **Privacy note:** Auto-summary sends session text to Anthropic API via `claude -p` to generate summaries. Only session content is transmitted.
+
 ### Global Options
 
 | Option | Description |

{jfox_cli-0.9.0 → jfox_cli-0.10.0}/README.md

@@ -324,6 +324,35 @@ jfox query "Luhmann's methodology" --depth 2
 | `jfox daemon stop` | Stop embedding daemon |
 | `jfox daemon status` | Show daemon PID, port, model info |
 
+### Auto-Summary
+
+Auto-summary runs inside the daemon to automatically archive Claude Code sessions into your knowledge base. It scans `~/.claude/projects/` for finished sessions, generates a structured summary via `claude -p`, and writes it as a `session` type note.
+
+A session is considered "finished" when its file has not been modified for `idle_threshold` minutes (default: 30).
+
+| Command | Description |
+|---------|-------------|
+| `jfox auto-summary enable` | Enable auto-summary in daemon |
+| `jfox auto-summary disable` | Disable auto-summary |
+| `jfox auto-summary status` | Show config and ledger statistics |
+| `jfox auto-summary scan` | List sessions that would be processed |
+| `jfox auto-summary run` | Manually trigger a summary round |
+| `jfox auto-summary run --dry-run` | Preview without writing |
+
+**Key options:**
+- `--interval` — Scan interval in minutes (default: 30)
+- `--idle-threshold` — Minutes of inactivity to consider a session finished (default: 30)
+- `--kb` — Target knowledge base for saved notes
+
+**How it works:**
+
+- Uses `claude -p` (non-interactive mode) to generate summaries from stdin/stdout
+- Runs with `--permission-mode bypassPermissions` so the daemon never blocks on permission prompts
+- Tracks processed sessions in `~/.zk_auto_summary_state.json` to avoid duplicates; transient failures are retried up to 3 times before giving up
+- A session is eligible only after its file has been idle for `idle_threshold` minutes (no new content)
+
+> **Privacy note:** Auto-summary sends session text to Anthropic API via `claude -p` to generate summaries. Only session content is transmitted.
+
 ### Global Options
 
 | Option | Description |