The distribution pack ships the framework toolkit only — 68 skills, 7 domain agents, hooks, schemas, platform_lib, rules, and rubrics. It ships zero character corpus: a non-removable safety filter enforced after the manifest globs drops every file that could contain real-character PII. The same source + same manifest produces a byte-identical archive every time.Gói phân phối ship chỉ bộ framework toolkit — 68 skill, 7 agent domain, hook, schema, platform_lib, rule, và rubric. Nó ship không corpus nhân vật: một safety filter không-thể-gỡ được ép sau manifest glob loại mọi file có thể chứa PII nhân vật thật. Cùng nguồn + cùng manifest tạo ra một archive byte-identical mỗi lần.

The pack pipelineQuy trình đóng gói

Four deterministic stages. Each stage is a discrete script; they compose into a single CI step triggered only on frameworks-v* tags.Bốn giai đoạn tất định. Mỗi giai đoạn là một script rời nhau; chúng kết hợp thành một bước CI duy nhất chỉ kích hoạt trên tag frameworks-v*.

Stage detailChi tiết từng giai đoạn

What the safety filter dropsSafety filter loại cái gì

Live build outputĐầu ra build trực tiếp

The token below is injected by the showcase build pipeline with the actual output of build_pack.py from the last tagged release:Token bên dưới được build pipeline showcase chèn với đầu ra thực tế của build_pack.py từ lần release được tag gần nhất:

$ pytest -k 'pack and (determin or safety)'
6 passed, 1128 deselected in 0.90s

→ byte-identical tarball · per-file SHA256 MANIFEST · non-removable PII safety_filter

CI-only tagged releaseRelease được tag chỉ qua CI

The pack build runs only in CI, triggered exclusively by a frameworks-v* tag push — never by a manual run or a PR. This prevents accidental releases and ensures the artifact in the GitHub Release matches what the reproducibility check produces.Build gói chạy chỉ trong CI, chỉ kích hoạt bởi push tag frameworks-v* — không bao giờ bởi chạy thủ công hay PR. Điều này ngăn release vô tình và đảm bảo artifact trong GitHub Release khớp với kết quả kiểm tra tính tái tạo.

install.sh — verify then provisioninstall.sh — xác minh rồi cấp phát

The installer is a standalone shell script that ships as a separate release asset — it does not live inside the .tar.gz it verifies. It runs five phases in order, fail-fast at the first problem:Trình cài là shell script độc lập ship như release asset riêng biệt — nó không nằm trong .tar.gz mà nó xác minh. Nó chạy năm pha theo thứ tự, dừng ngay ở lỗi đầu tiên:

Reproducibility checkKiểm tra tính tái tạo

Any user can reproduce the exact release artifact from their local clone:Bất kỳ người dùng nào cũng có thể tái tạo artifact release chính xác từ clone cục bộ của họ:

The three determinism invariants (PAX format, mtime=0, sorted entries) ensure no OS, filesystem, or time-of-day variance affects the output. If your local SHA differs from the published one, the build inputs changed — check git status and pack.manifest.yaml version field.Ba bất biến tất định (định dạng PAX, mtime=0, mục đã sắp xếp) đảm bảo không có OS, filesystem, hoặc phương sai thời-điểm-trong-ngày nào ảnh hưởng đến đầu ra. Nếu SHA cục bộ của bạn khác với SHA đã đăng, đầu vào build đã thay đổi — kiểm tra git status và trường phiên bản pack.manifest.yaml.

Public mirror structureCấu trúc gương công khai