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

{jfox_cli-0.8.0 → jfox_cli-0.10.0}/.claude-plugin/marketplace.json

@@ -1,17 +1,20 @@
 {
   "name": "jfox-skills",
   "id": "jfox-skills",
-  "owner": { "name": "zhuxixi" },
+  "owner": {
+    "name": "zhuxixi",
+    "url": "https://github.com/zhuxixi"
+  },
   "metadata": {
     "description": "JFox Zettelkasten 知识管理工具的 Claude Code 集成",
-    "version": "0.1.0"
+    "version": "0.2.0"
   },
   "plugins": [
     {
       "name": "jfox",
-      "source": "./",
-      "description": "JFox 知识管理 CLI 的 Claude Code 集成——搜索、导入、整理、会话总结",
-      "version": "0.1.0",
+      "source": "./packages/cc-plugin",
+      "description": "JFox 知识管理 CLI 的 Claude Code 集成——搜索、写入工作流（导入/整理/会话总结）与知识库管理",
+      "version": "0.2.0",
       "author": { "name": "zhuxixi" },
       "keywords": ["zettelkasten", "knowledge-management"],
       "category": "workflow"

{jfox_cli-0.8.0 → jfox_cli-0.10.0}/.gitignore

@@ -47,3 +47,5 @@ cache/
 analysis_report.md
 kimi-export-*.md
 review_body*.md
+.pr_monitor_state.json
+.tmp_issue_body.md

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

@@ -2,6 +2,45 @@
 
 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
+- replace hf-mirror.com with ModelScope for model download
+- auto-summary daemon for Claude Code sessions
+
+### Fixes
+- Last Used 始终显示 Never，日常操作未更新 last_used (#222)
+- **plugin**: remove commands field, let Claude Code auto-discover (#214)
+- **plugin**: correct commands paths in plugin.json (#213)
+
+### Changes
+- ignore pr-monitor state and tmp issue body files
+- add superpowers plans and spec for recent work
+- document Claude Code plugin structure in CLAUDE.md (#220)
+- **plugin**: rename kb skill to manage and dedup CRUD docs (#218)
+- **plugin**: restructure plugin source for marketplace best practices (#217)
+- add Claude Code plugin guide and design docs (#215)
+
+[0.9.0]: https://github.com/zhuxixi/jfox/compare/v0.8.0...v0.9.0
+
 ## [0.8.0] - 2026-05-10
 
 ### Features

{jfox_cli-0.8.0 → jfox_cli-0.10.0}/CLAUDE.md

@@ -133,6 +133,16 @@ Four jobs in `.github/workflows/integration-test.yml`:
 - Set `PYTHONUTF8=1` and `chcp 65001` for encoding
 - HuggingFace mirror for China: `export HF_ENDPOINT=https://hf-mirror.com`
 
+## Claude Code Plugin
+
+JFox ships as a Claude Code plugin. Two-tier structure:
+- `.claude-plugin/marketplace.json` — top-level marketplace registry (version, description)
+- `packages/cc-plugin/.claude-plugin/plugin.json` — plugin source metadata
+- `packages/cc-plugin/skills/` — 5 skills: `search`, `ingest`, `manage`, `organize`, `session-summary`
+
+**Plugin versioning**: bump version in both `plugin.json` AND `marketplace.json` together. Current: 0.2.0.
+**Skill rename history**: `kb` → `manage` (v0.2.0) — "manage" is the canonical KB lifecycle + CRUD skill.
+
 ## Branch Rules
 
 - **main 是保护分支**，不能直接 commit 或 push。所有改动必须通过新分支 + PR 合入。

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jfox-cli
-Version: 0.8.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.8.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 |