center-kb 0.2.0__tar.gz

center_kb-0.2.0/.claude/skills/kb-summarize/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: kb-summarize
+description: Điền summary L0/L1/L2 cho các section đang pending trong .kb/ sau khi chạy kb ingest. Dùng khi user yêu cầu summarize KB, điền summary, hoặc sau khi vừa ingest tài liệu mới.
+---
+
+# KB Summarize — điền tri thức vào khung .kb/
+
+Bạn là "nửa LLM" của pipeline CENTER-KB. `kb ingest` đã sinh khung; nhiệm vụ
+của bạn là điền phần summary. KHÔNG sửa bất kỳ thứ gì ngoài các vị trí nêu dưới.
+
+## Quy trình
+
+1. Chạy `kb status` — lấy danh sách section pending (doc, section id, file).
+2. Với TỪNG section pending, lặp:
+   a. Đọc nguyên văn: `kb get <doc-id> <section-id> --level l3`
+   b. Mở file L2 (`.kb/<doc-id>/<file>.md`), tìm marker
+      `<!-- TODO:summarize <section-id> -->` trong section tương ứng.
+   c. Thay marker bằng đoạn văn cô đọng (xem Quy tắc viết). KHÔNG đụng vào
+      các bảng markdown đã có sẵn trong section — chúng do code chép nguyên văn.
+   d. Mở `.kb/<doc-id>/_manifest.yaml`, điền `summary` (1 câu, ≤ 25 từ)
+      cho section đó và đổi `status: pending` → `status: summarized`.
+3. Khi mọi section của một doc xong: mở `.kb/index.yaml`, điền/sửa `summary`
+   (1 câu) và kiểm tra `title`, `revision`, `tags` của doc đó cho đúng.
+4. Chạy `kb build` — phải PASS. Nếu fail vì table integrity: bạn đã lỡ sửa
+   bảng, khôi phục bảng về nguyên văn từ file `.raw.md`.
+5. Báo cáo: số section đã điền, tổng token L2 (xem `kb stats`).
+
+## Quy tắc viết (bắt buộc)
+
+- Viết **tiếng Anh**.
+- Đoạn L2: cô đọng văn xuôi còn ~20–30% độ dài gốc, giữ cấu trúc logic.
+- Giữ NGUYÊN VĂN: mọi mã hiệu (P, R, D...), tên record/field (UR, PA...),
+  giá trị số, đơn vị, tham chiếu chéo (§x.y). Không diễn đạt lại thuật ngữ.
+- KHÔNG suy diễn ngoài văn bản gốc. Thiếu chắc chắn → giữ nguyên câu gốc.
+- KHÔNG tóm tắt bảng, không tạo bảng mới, không xóa bảng.
+- Summary L1 (manifest): 1 câu ≤ 25 từ, nêu section nói về cái gì và chứa
+  loại dữ liệu gì (để BM25 khớp được từ khóa kỹ thuật).
+
+## Làm việc theo lô
+
+Điền lần lượt từng section, mỗi 5–10 section chạy lại `kb build
+--allow-pending` để bắt lỗi sớm. Không sửa nhiều file song song.

center_kb-0.2.0/.dockerignore

@@ -0,0 +1,15 @@
+.git
+.github
+.kb-work
+.pytest_cache
+.ruff_cache
+.superpowers
+.venv
+dist
+dist-check
+docs
+source
+tests
+*.pdf
+.coverage
+__pycache__

center_kb-0.2.0/.github/workflows/kb-publish.yml

@@ -0,0 +1,23 @@
+# Mẫu CI publish index lên kb-hub — copy sang các repo con tham gia federation.
+# Yêu cầu secret KB_HUB_URL (URL hub kèm token, vd https://x-access-token:${TOKEN}@github.com/org/kb-hub.git)
+name: kb-publish
+on:
+  push:
+    branches: [main]
+    paths: [".kb/**"]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install center-kb  # hoặc pip install -e . nếu repo chứa source
+      - name: Publish L0+L1 lên hub
+        run: kb publish --hub "${{ secrets.KB_HUB_URL }}" --repo-id "${{ github.event.repository.name }}"
+        env:
+          GIT_AUTHOR_NAME: kb-publish-ci
+          GIT_AUTHOR_EMAIL: ci@local
+          GIT_COMMITTER_NAME: kb-publish-ci
+          GIT_COMMITTER_EMAIL: ci@local

center_kb-0.2.0/.github/workflows/kb-review.yml

@@ -0,0 +1,63 @@
+# Auto-mark sections reviewed after a PR merges into main.
+# Valid only while KB authors are the SMEs themselves ("merged = approved") —
+# see docs/superpowers/specs/2026-07-11-review-automation-design.md §2.
+name: kb-review
+on:
+  push:
+    branches: [main]
+    paths: [".kb/**"]
+
+# Serialize runs: two quick merges must not race each other's push.
+# Note: GitHub keeps only the newest queued run per group — in a rapid
+# burst of merges an intermediate push's flips may wait until its
+# sections are next touched. Acceptable at this team's merge frequency.
+concurrency:
+  group: kb-review
+  cancel-in-progress: false
+
+permissions:
+  contents: write
+
+jobs:
+  approve:
+    runs-on: ubuntu-latest
+    # Loop guard (layer 3): skip pushes authored by the bot itself.
+    if: github.event.head_commit.author.name != 'github-actions[bot]'
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          # Full history so `--against BEFORE` is always reachable.
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install -e .
+      - name: Approve sections changed by this push
+        run: |
+          BEFORE="${{ github.event.before }}"
+          # Zero-SHA on force-push/branch-create → fall back to the merge
+          # commit's first parent; no parent at all → nothing to compare.
+          if [ "$BEFORE" = "0000000000000000000000000000000000000000" ] \
+              || ! git rev-parse --verify --quiet "$BEFORE^{commit}" > /dev/null; then
+            if git rev-parse --verify --quiet "HEAD^" > /dev/null; then
+              BEFORE="HEAD^"
+            else
+              echo "No previous commit to compare against — skipping."
+              exit 0
+            fi
+          fi
+          kb approve --all-changed --against "$BEFORE"
+      - name: Commit status flips back to main
+        run: |
+          if git diff --quiet -- .kb; then
+            echo "No status changes to commit."
+            exit 0
+          fi
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          SHORT_SHA="$(git rev-parse --short HEAD)"
+          git add .kb
+          # Loop guard (layer 1): [skip ci]. Layer 2: pushes made with
+          # GITHUB_TOKEN do not trigger new workflow runs.
+          git commit -m "review: auto-mark reviewed @ ${SHORT_SHA} [skip ci]"
+          git push

center_kb-0.2.0/.github/workflows/release.yml

@@ -0,0 +1,101 @@
+name: release
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install -e .[dev]
+      - run: pytest
+        env:
+          # e2e tests exercise `kb publish`/`gitio.commit_*` against real git
+          # clones — those commits need an identity and CI runners have none
+          # configured anywhere (no ~/.gitconfig), unlike dev machines. Same
+          # env vars kb-publish.yml sets for real hub publishes.
+          GIT_AUTHOR_NAME: ci-test
+          GIT_AUTHOR_EMAIL: ci-test@local
+          GIT_COMMITTER_NAME: ci-test
+          GIT_COMMITTER_EMAIL: ci-test@local
+
+  build:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install build
+      - run: python -m build
+      - name: Verify wheel is self-contained (templates + kb init + doctor)
+        run: |
+          python -m venv /tmp/venv
+          /tmp/venv/bin/pip install dist/*.whl
+          mkdir /tmp/kbtest && cd /tmp/kbtest
+          /tmp/venv/bin/kb init
+          /tmp/venv/bin/kb doctor
+          /tmp/venv/bin/python -c "from importlib import resources; resources.files('center_kb').joinpath('templates/web/base.html').read_text(encoding='utf-8')"
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  pypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  docker:
+    needs: test
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build image
+        run: docker build -t ghcr.io/vuonglq01685/center-kb:${GITHUB_REF_NAME} .
+      - name: Smoke test — serve an empty KB, health must answer, API must 401
+        run: |
+          mkdir -p /tmp/data/.kb
+          echo "docs: []" > /tmp/data/.kb/index.yaml
+          docker run -d --name kb -p 8321:8321 \
+            -e CENTER_KB_HTTP_TOKEN=smoke-test-token \
+            -v /tmp/data:/data \
+            ghcr.io/vuonglq01685/center-kb:${GITHUB_REF_NAME}
+          for i in $(seq 1 30); do
+            curl -sf http://localhost:8321/api/health && break
+            sleep 2
+          done
+          curl -sf http://localhost:8321/api/health
+          code=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:8321/api/docs)
+          test "$code" = "401"
+          docker rm -f kb
+      - name: Login to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - name: Push tags
+        run: |
+          docker tag ghcr.io/vuonglq01685/center-kb:${GITHUB_REF_NAME} ghcr.io/vuonglq01685/center-kb:latest
+          docker push ghcr.io/vuonglq01685/center-kb:${GITHUB_REF_NAME}
+          docker push ghcr.io/vuonglq01685/center-kb:latest

center_kb-0.2.0/.gitignore

@@ -0,0 +1,24 @@
+# ~/.gitignore_global của máy ignore *.md — repo này là docs-as-code,
+# markdown là sản phẩm chính nên phải bỏ chặn tại đây
+!*.md
+
+# Tài liệu gốc có bản quyền (ARINC, ICAO) — tuyệt đối không commit
+sources/
+
+# Sản phẩm trung gian của pipeline (Docling JSON, summarize jobs)
+.kb-work/
+
+# Python
+__pycache__/
+*.pyc
+.venv/
+venv/
+*.egg-info/
+dist/
+build/
+
+# macOS
+.DS_Store
+
+# SDD scratch
+.superpowers/