# kb-lint 定時健檢（Phase 4 草稿，部署到 Gitea 時啟用）
#
# 部署前提（ASSUMPTION：部署環境未定，以下依常見 self-hosted 配置假設）：
# - self-hosted runner 與 Ollama 同機或內網可達（必要時以 OLLAMA_BASE_URL 覆寫，
#   這是唯一允許的設定覆寫來源，AGENTS.md §1.2）
# - runner 具 Python 3.11+；文件內容全程不離開內網（AGENTS.md §1.1）
# - 報告以 artifact 上傳供人工下載審核；lint 絕不修改 repo 內容
name: kb-lint
on:
  schedule:
    - cron: "0 21 * * 0"   # UTC 週日 21:00 = 台北時間週一 05:00
  workflow_dispatch: {}

jobs:
  lint:
    runs-on: self-hosted
    steps:
      - uses: actions/checkout@v4
      - name: Set up venv
        run: |
          python3 -m venv .venv
          .venv/bin/pip install -r requirements.txt
      - name: Run lint
        # 結束碼 1 = 有待人工核准項目 → workflow 標紅作為通知信號
        run: .venv/bin/python tools/lint.py --output reports
      - name: Upload report
        if: always()
        uses: actions/upload-artifact@v3
        with:
          name: lint-report
          path: reports/