jfox-cli 0.1.4__tar.gz → 0.2.0__tar.gz

{jfox_cli-0.1.4 → jfox_cli-0.2.0}/.github/workflows/integration-test.yml

@@ -14,6 +14,7 @@ on:
       - 'jfox/**'
       - 'tests/**'
       - 'pyproject.toml'
+      - '.github/workflows/integration-test.yml'
   # 允许手动触发
   workflow_dispatch:
     inputs:
@@ -33,6 +34,32 @@ env:
   PYTHONUTF8: 1
 
 jobs:
+  # ============ Lint 检查 ============
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - uses: astral-sh/setup-uv@v4
+      with:
+        version: "latest"
+        enable-cache: true
+
+    - name: Install dependencies
+      run: uv sync --extra dev
+
+    - name: Run ruff check
+      run: uv run ruff check jfox/ tests/
+
+    - name: Run black check
+      run: uv run black --check jfox/ tests/
+
   # ============ 快速测试（PR 和 push 触发）============
   test-fast:
     runs-on: ${{ matrix.os }}
@@ -61,9 +88,15 @@ jobs:
       run: uv sync --extra dev
 
     - name: Run fast tests (no embedding)
+      shell: bash
       run: |
         # 运行非 embedding 测试（单进程避免知识库冲突）
-        uv run pytest tests/ -m "not embedding and not slow" --timeout=180 -v --tb=short
+        ARGS="-m 'not embedding and not slow' --timeout=180 -v --tb=short"
+        if [ "${{ matrix.os }}" = "ubuntu-latest" ]; then
+          eval uv run pytest tests/ $ARGS --cov=jfox --cov-report=xml
+        else
+          eval uv run pytest tests/ $ARGS
+        fi
       timeout-minutes: ${{ matrix.os == 'windows-latest' && 50 || 20 }}
       env:
         PYTHONIOENCODING: utf-8
@@ -78,6 +111,14 @@ jobs:
           .pytest_cache/
           htmlcov/
 
+    - name: Upload coverage data
+      if: matrix.os == 'ubuntu-latest'
+      uses: actions/upload-artifact@v4
+      with:
+        name: coverage-data
+        path: coverage.xml
+        retention-days: 1
+
   # ============ 核心测试（带 embedding，但只跑核心）============
   test-core:
     runs-on: ${{ matrix.os }}
@@ -102,12 +143,20 @@ jobs:
         version: "latest"
         enable-cache: true
 
-    - name: Cache model
+    - name: Cache model (Unix)
+      if: runner.os != 'Windows'
       uses: actions/cache@v4
       with:
         path: ~/.cache/torch/sentence_transformers
         key: ${{ runner.os }}-sentence-transformers-all-MiniLM-L6-v2
 
+    - name: Cache model (Windows)
+      if: runner.os == 'Windows'
+      uses: actions/cache@v4
+      with:
+        path: ~\AppData\Local\torch\sentence_transformers
+        key: ${{ runner.os }}-sentence-transformers-all-MiniLM-L6-v2
+
     - name: Install dependencies
       run: uv sync --extra dev
 
@@ -152,12 +201,20 @@ jobs:
         version: "latest"
         enable-cache: true
 
-    - name: Cache model
+    - name: Cache model (Unix)
+      if: runner.os != 'Windows'
       uses: actions/cache@v4
       with:
         path: ~/.cache/torch/sentence_transformers
         key: ${{ runner.os }}-sentence-transformers-all-MiniLM-L6-v2
 
+    - name: Cache model (Windows)
+      if: runner.os == 'Windows'
+      uses: actions/cache@v4
+      with:
+        path: ~\AppData\Local\torch\sentence_transformers
+        key: ${{ runner.os }}-sentence-transformers-all-MiniLM-L6-v2
+
     - name: Install dependencies
       run: uv sync --extra dev
 
@@ -178,38 +235,76 @@ jobs:
         path: |
           .pytest_cache/
 
-  # ============ 覆盖率报告汇总 ============
+  # ============ 质量门禁（所有必须测试通过才算成功）============
+  quality-gate:
+    runs-on: ubuntu-latest
+    needs: [lint, test-fast]
+    if: always()
+    steps:
+    - name: Check all jobs passed
+      run: |
+        echo "lint: ${{ needs.lint.result }}"
+        echo "test-fast: ${{ needs.test-fast.result }}"
+        if [[ "${{ needs.lint.result }}" == "success" && "${{ needs.test-fast.result }}" == "success" ]]; then
+          echo "Quality gate passed!"
+          exit 0
+        else
+          echo "Quality gate FAILED!"
+          exit 1
+        fi
+
+  # ============ 覆盖率报告（解析 test-fast 的 coverage artifact）============
   coverage:
     runs-on: ubuntu-latest
     needs: [test-fast]
     if: always() && needs.test-fast.result == 'success'
+    permissions:
+      pull-requests: write
 
     steps:
     - name: Checkout code
       uses: actions/checkout@v4
 
-    - name: Set up Python
-      uses: actions/setup-python@v5
-      with:
-        python-version: '3.11'
-
-    - uses: astral-sh/setup-uv@v4
+    - name: Download coverage data
+      uses: actions/download-artifact@v4
       with:
-        version: "latest"
-        enable-cache: true
+        name: coverage-data
 
-    - name: Install dependencies
-      run: uv sync --extra dev
-
-    - name: Run coverage
+    - name: Post coverage comment on PR
+      if: github.event_name == 'pull_request'
+      env:
+        GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       run: |
-        uv run pytest tests/ -m "not embedding and not slow" --cov=jfox --cov-report=xml --cov-report=html -v --timeout=300
-      timeout-minutes: 25
+        python -c "
+        import xml.etree.ElementTree as ET
+        import subprocess
+
+        tree = ET.parse('coverage.xml')
+        root = tree.getroot()
+        rate = float(root.attrib['line-rate'])
+        lines_covered = int(root.attrib['lines-covered'])
+        lines_valid = int(root.attrib['lines-valid'])
+
+        rows = []
+        for cls in root.iter('class'):
+            name = cls.attrib['filename']
+            r = float(cls.attrib['line-rate'])
+            rows.append((name, r))
+        rows.sort(key=lambda x: x[1])
+
+        comment = '## Test Coverage\n\n'
+        comment += '**Overall: {:.1f}%** ({}/{} lines)\n\n'.format(rate * 100, lines_covered, lines_valid)
+        comment += '| Module | Coverage | Status |\n|--------|----------|--------|\n'
+        for name, r in rows:
+            icon = ':green_circle:' if r >= 0.8 else ':yellow_circle:' if r >= 0.5 else ':red_circle:'
+            comment += '| {} | {:.1f}% | {} |\n'.format(name, r * 100, icon)
+
+        pr = '${{ github.event.pull_request.number }}'
+        subprocess.run(['gh', 'pr', 'comment', pr, '--body', comment])
+        "
 
     - name: Upload coverage report
       uses: actions/upload-artifact@v4
       with:
         name: coverage-report
-        path: |
-          htmlcov/
-          coverage.xml
+        path: coverage.xml

jfox_cli-0.2.0/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+All notable changes to jfox-cli will be documented in this file.
+
+## [0.2.0] - 2026-04-13
+
+### Features
+- **edit**: add `--content-file` parameter for reading note content from a file (#106)
+
+### Fixes
+- **skill**: add `--kb` parameter support to jfox-health skill
+- **cli**: add `use` as alias for `kb switch` subcommand (#105)
+
+### Changes
+- **skills**: redesign from 5 skills to 4
+- **test**: fix flaky `test_update_content_preserves_id_and_created` (timing race on fast machines)
+
+### Performance
+- **startup**: lazy import optimization to eliminate startup overhead for lightweight commands (#122)
+- **ci**: optimize CI coverage job to avoid rerunning tests (#119)
+
+## [0.1.5] - 2026-04-12
+
+### Fixes
+- **index**: add `--kb` parameter to `jfox index` command (#104) (#113)
+- **index**: fix `index verify` false positives (filename vs index ID format mismatch) (#111)
+- **index**: fix `index rebuild` clearing ChromaDB before re-indexing (#110)
+- **test**: prevent test KB residue in global config (#101)
+- **ci**: resolve Windows path comparison bug and add quality gate
+
+### Changes
+- **style**: auto-fix all ruff/black lint errors (1869 fixed)
+
+[0.2.0]: https://github.com/zhuxixi/jfox/compare/v0.1.5...v0.2.0
+[0.1.5]: https://github.com/zhuxixi/jfox/compare/v0.1.4...v0.1.5

{jfox_cli-0.1.4 → jfox_cli-0.2.0}/CLAUDE.md

@@ -126,6 +126,10 @@ 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`
 
+## Branch Rules
+
+- **main 是保护分支**，不能直接 commit 或 push。所有改动必须通过新分支 + PR 合入。
+
 ## Gotchas
 
 - `pytest.ini` `addopts` includes `-v`, so `pytest tests/` already runs verbose — adding `-v` manually is redundant

{jfox_cli-0.1.4 → jfox_cli-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jfox-cli
-Version: 0.1.4
+Version: 0.2.0
 Summary: JFox - Zettelkasten 知识管理 CLI 工具
 Project-URL: Homepage, https://github.com/zhuxixi/jfox
 Project-URL: Repository, https://github.com/zhuxixi/jfox
@@ -143,7 +143,7 @@ jfox init --name personal --path ~/my-notes --desc "个人笔记"
 jfox kb list
 
 # 切换默认知识库
-jfox kb switch work
+jfox kb use work
 
 # 查看知识库详情
 jfox kb info work
@@ -207,7 +207,7 @@ jfox query "卢曼的方法论"
 | `jfox init` | 初始化知识库 | `jfox init --name work --desc "工作笔记"` |
 | `jfox kb list` | 列出所有知识库 | `jfox kb list` |
 | `jfox kb create <name>` | 创建知识库 | `jfox kb create work --desc "工作笔记"` |
-| `jfox kb switch <name>` | 切换默认知识库 | `jfox kb switch work` |
+| `jfox kb use <name>` | 切换默认知识库 | `jfox kb use work` |
 | `jfox kb info [name]` | 查看知识库详情 | `jfox kb info work` |
 | `jfox kb rename <old> <new>` | 重命名知识库 | `jfox kb rename work job` |
 | `jfox kb remove <name>` | 删除知识库 | `jfox kb remove temp --force` |
@@ -321,7 +321,7 @@ $ jfox kb list
 
 ```bash
 # 切换到 work 知识库
-jfox kb switch work
+jfox kb use work
 
 # 之后的所有操作都在 work 知识库上进行
 jfox add "新项目想法" --title "项目A"

{jfox_cli-0.1.4 → jfox_cli-0.2.0}/README.md

@@ -106,7 +106,7 @@ jfox init --name personal --path ~/my-notes --desc "个人笔记"
 jfox kb list
 
 # 切换默认知识库
-jfox kb switch work
+jfox kb use work
 
 # 查看知识库详情
 jfox kb info work
@@ -170,7 +170,7 @@ jfox query "卢曼的方法论"
 | `jfox init` | 初始化知识库 | `jfox init --name work --desc "工作笔记"` |
 | `jfox kb list` | 列出所有知识库 | `jfox kb list` |
 | `jfox kb create <name>` | 创建知识库 | `jfox kb create work --desc "工作笔记"` |
-| `jfox kb switch <name>` | 切换默认知识库 | `jfox kb switch work` |
+| `jfox kb use <name>` | 切换默认知识库 | `jfox kb use work` |
 | `jfox kb info [name]` | 查看知识库详情 | `jfox kb info work` |
 | `jfox kb rename <old> <new>` | 重命名知识库 | `jfox kb rename work job` |
 | `jfox kb remove <name>` | 删除知识库 | `jfox kb remove temp --force` |
@@ -284,7 +284,7 @@ $ jfox kb list
 
 ```bash
 # 切换到 work 知识库
-jfox kb switch work
+jfox kb use work
 
 # 之后的所有操作都在 work 知识库上进行
 jfox add "新项目想法" --title "项目A"