orbitquant 0.1.2__tar.gz → 0.1.3__tar.gz

{orbitquant-0.1.2 → orbitquant-0.1.3}/.github/workflows/publish-pypi.yml

@@ -6,7 +6,7 @@ on:
       version:
         description: Version to publish
         required: true
-        default: "0.1.2"
+        default: "0.1.3"
 
 jobs:
   build:

{orbitquant-0.1.2 → orbitquant-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: orbitquant
-Version: 0.1.2
+Version: 0.1.3
 Summary: Clean-room OrbitQuant implementation for diffusion transformers
 Project-URL: Homepage, https://github.com/iamwavecut/OrbitQuant
 Project-URL: Repository, https://github.com/iamwavecut/OrbitQuant
@@ -39,7 +39,7 @@ Requires-Dist: diffusers>=0.35; extra == 'hf'
 Requires-Dist: transformers>=4.53; extra == 'hf'
 Provides-Extra: kernels
 Requires-Dist: kernels>=0.16; extra == 'kernels'
-Requires-Dist: triton>=3.5; extra == 'kernels'
+Requires-Dist: triton>=3.5; (platform_system == 'Linux') and extra == 'kernels'
 Description-Content-Type: text/markdown
 
 # OrbitQuant
@@ -402,6 +402,42 @@ reproduction targets:
 User-facing comparison assets are generated at the native settings above. Small
 low-resolution checks are not accepted as published quality evidence.
 
+To create a local original-vs-OrbitQuant evidence bundle without writing raw
+samples into the model artifact repository, run `compare-native` against a local
+OrbitQuant artifact:
+
+```bash
+orbitquant compare-native \
+  --suite flux2-native \
+  --artifact ./artifacts/flux2-klein-w4a4 \
+  --prompt-id simple-object \
+  --output ./reports/native/flux2-klein-w4a4-comparison \
+  --device cuda \
+  --dtype bfloat16 \
+  --runtime-mode auto_fused
+```
+
+The output directory contains the BF16 sample, the OrbitQuant sample, a
+side-by-side WebP comparison, per-split metadata, and `summary.json` with native
+settings, wall time, peak VRAM, requested runtime mode, and available local
+kernel backends. By default `compare-native` validates the completed bundle
+before returning and includes the validation report in its JSON output. Use
+`--skip-comparison-validation` only when you intentionally want to inspect or
+repair an incomplete bundle.
+
+Validate a copied or previously generated comparison bundle before using it as
+evidence:
+
+```bash
+orbitquant validate-comparison \
+  --input ./reports/native/flux2-klein-w4a4-comparison
+```
+
+The validator accepts bundles copied from a remote GPU host, checks native
+settings and metadata, resolves remote absolute paths by local filename, rejects
+blank-like images, and reports timing, VRAM, and selected OrbitQuant runtime
+counts when the bundle was generated by a recent `compare-native`.
+
 ## Release Metrics
 
 Full GenEval and VBench runs are release evidence for paper reproduction,

{orbitquant-0.1.2 → orbitquant-0.1.3}/README.md

@@ -358,6 +358,42 @@ reproduction targets:
 User-facing comparison assets are generated at the native settings above. Small
 low-resolution checks are not accepted as published quality evidence.
 
+To create a local original-vs-OrbitQuant evidence bundle without writing raw
+samples into the model artifact repository, run `compare-native` against a local
+OrbitQuant artifact:
+
+```bash
+orbitquant compare-native \
+  --suite flux2-native \
+  --artifact ./artifacts/flux2-klein-w4a4 \
+  --prompt-id simple-object \
+  --output ./reports/native/flux2-klein-w4a4-comparison \
+  --device cuda \
+  --dtype bfloat16 \
+  --runtime-mode auto_fused
+```
+
+The output directory contains the BF16 sample, the OrbitQuant sample, a
+side-by-side WebP comparison, per-split metadata, and `summary.json` with native
+settings, wall time, peak VRAM, requested runtime mode, and available local
+kernel backends. By default `compare-native` validates the completed bundle
+before returning and includes the validation report in its JSON output. Use
+`--skip-comparison-validation` only when you intentionally want to inspect or
+repair an incomplete bundle.
+
+Validate a copied or previously generated comparison bundle before using it as
+evidence:
+
+```bash
+orbitquant validate-comparison \
+  --input ./reports/native/flux2-klein-w4a4-comparison
+```
+
+The validator accepts bundles copied from a remote GPU host, checks native
+settings and metadata, resolves remote absolute paths by local filename, rejects
+blank-like images, and reports timing, VRAM, and selected OrbitQuant runtime
+counts when the bundle was generated by a recent `compare-native`.
+
 ## Release Metrics
 
 Full GenEval and VBench runs are release evidence for paper reproduction,

{orbitquant-0.1.2 → orbitquant-0.1.3}/docs/kernel-audit.md

@@ -21,9 +21,9 @@ for the current artifact format and runtime modes.
   the current environment.
 - `scripts/run_cuda_kernel_checks.sh` is the CUDA correctness and benchmark
   gate for GPU hosts. It first tries to load a prebuilt
-  `native_packed_matmul` package through Hugging Face `kernels`,
-  `LOCAL_KERNELS`, or an importable package. If no compatible prebuilt package
-  is available, it fails before starting a source build unless
+  `native_packed_matmul` package from an importable `orbitquant_packed_matmul`
+  module, then through Hugging Face `kernels`/`LOCAL_KERNELS`. If no compatible
+  prebuilt package is available, it fails before starting a source build unless
   `ORBITQUANT_ALLOW_NATIVE_KERNEL_BUILD=1` is set. With that explicit opt-in,
   it builds the exact
   `native-kernels/orbitquant-packed-matmul` kernel-builder redistributable
@@ -284,6 +284,13 @@ for the current artifact format and runtime modes.
   snapshot model repo resolved to commit
   `cb0ceb1a4d070556c52cfba691aba3f6647c246b`. The native loader therefore
   still requires `LOCAL_KERNELS`, an importable package, or Kernel Hub approval.
+- A 2026-07-09T15:06Z live refresh found no new reviewer reply after the
+  2026-07-09T14:00Z model-artifact numbers. Discussion 15 remains open,
+  `repo_info("WaveCut/orbitquant-packed-matmul", repo_type="model")` resolves
+  to commit `cb0ceb1a4d070556c52cfba691aba3f6647c246b`, and
+  `repo_info("WaveCut/orbitquant-packed-matmul", repo_type="kernel")` still
+  returns 404. Do not describe the native package as remotely loadable until a
+  kernel-type repository exists and `get_kernel(...)` has been verified.
 
 ## Packaging Boundary
 

{orbitquant-0.1.2 → orbitquant-0.1.3}/docs/kernel-hub-approval-request.md

@@ -170,6 +170,16 @@ approval blocker.
 On 2026-07-09T14:00Z, `WaveCut` posted those actual model artifact numbers in
 discussion 15.
 
+Live status refresh:
+
+On 2026-07-09T15:06Z, discussion 15 was still open and no newer reviewer reply
+was present after the 2026-07-09T14:00Z model-artifact numbers. The public
+source snapshot repo still resolved as a model repo at commit
+`cb0ceb1a4d070556c52cfba691aba3f6647c246b`; the kernel-type repository still
+returned 404. The remaining action is Hugging Face Kernel Hub publish approval,
+followed by `kernel-builder build-and-upload` and `get_kernel(...)`
+verification.
+
 ## Title
 
 Request Kernel Hub publish access for `WaveCut/orbitquant-packed-matmul`

{orbitquant-0.1.2 → orbitquant-0.1.3}/docs/release-gates.md

@@ -196,7 +196,13 @@ URL, or signed-off audit note.
   source build unless `ORBITQUANT_ALLOW_NATIVE_KERNEL_BUILD=1` is set. A
   2026-07-09 prebuilt-only loader check still returned 404 for the Kernel Hub
   repo while the public source snapshot model repo resolved to commit
-  `cb0ceb1a4d070556c52cfba691aba3f6647c246b`.
+  `cb0ceb1a4d070556c52cfba691aba3f6647c246b`. A 2026-07-09T15:06Z live
+  refresh confirmed discussion 15 remains open, the public source snapshot
+  model repo still resolves to commit
+  `cb0ceb1a4d070556c52cfba691aba3f6647c246b`, and
+  `repo_info("WaveCut/orbitquant-packed-matmul", repo_type="kernel")` still
+  returns 404. The loadable Kernel Hub package therefore remains an external
+  approval gate, not a completed release artifact.
 - [x] Final paper conformance audit is complete against arXiv 2607.02461, with
   documented deviations, implementation notes, and evidence that accepted
   deviations are intentional. The required audit checklist is
@@ -228,7 +234,11 @@ URL, or signed-off audit note.
   metadata, zero remote checksum mismatches, zero README mismatches, and zero
   forbidden remote files. It also reported `public_count=14`,
   `private_count=0`, 14/14 policy-inventory-ready, and 144 missing
-  release-grade metrics.
+  release-grade metrics. A 2026-07-09T15:06Z rerun with `--summary-only` and
+  the same policy inventory root again passed `--fail-on-artifact-regression`
+  with 14/14 artifact-ready, native-smoke-ready, metadata-complete, and
+  policy-inventory-ready; it reported `release_eval_applicable_count=10`,
+  `release_eval_ready_count=0`, and `missing_required_metric_count=144`.
 - [x] Full-model module classification inventories are captured for FLUX.2
   Klein, FLUX.1-schnell, Z-Image-Turbo, and Wan2.1. Raw inventory JSON may
   remain unpublished, but each published artifact manifest must be
@@ -258,7 +268,9 @@ URL, or signed-off audit note.
   `repo_count=14`, `artifact_ready_count=14`, `metadata_complete_ready_count=14`,
   `native_smoke_ready_count=14`, `remote_checksum_mismatch_count=0`,
   `readme_mismatch_count=0`, `forbidden_file_count=0`, `public_count=14`, and
-  `private_count=0`.
+  `private_count=0`. A 2026-07-09T15:06Z `--summary-only` rerun preserved the
+  same compact artifact counts and still reported `forbidden_file_count=0`,
+  `remote_checksum_mismatch_count=0`, and `readme_mismatch_count=0`.
 - [x] The GitHub repository is public, tagged, released, and includes the
   release docs, license, source distribution expectations, and reproducible
   verification commands.
@@ -289,7 +301,17 @@ URL, or signed-off audit note.
   `5972b6cfd1d89653fb9ac17668f72818c61a0e3cc5ea1cdd46e59d54405dc1ff` and
   `orbitquant-0.1.1-py3-none-any.whl` SHA256
   `b829c5df00093e697872ca24104e6ef38dbe7e7d70b2c2e33560bfaec224cde1`.
-- [x] The PyPI package is published as `orbitquant==0.1.1`.
+  Patch release notes for compact artifact audit output are
+  [release-0.1.2.md](release-0.1.2.md). GitHub CI for commit `f18feb9`
+  passed as run `29025114082`, tag `v0.1.2` points at commit
+  `f18feb95f7595965f046b3455997d6ce9b8e8e4a`, and GitHub Release
+  `https://github.com/iamwavecut/OrbitQuant/releases/tag/v0.1.2` was published
+  on 2026-07-09 with exact PyPI-matching assets:
+  `orbitquant-0.1.2.tar.gz` SHA256
+  `4afc15589fe713345dfa47be30dc078d943484a1f4bbd4861a413532a6ec8377` and
+  `orbitquant-0.1.2-py3-none-any.whl` SHA256
+  `3bdddebaa46f60307ed50e2ebf4b7ff4fef7817845b512ecfbb6fbf8ba71c91c`.
+- [x] The PyPI package is published as `orbitquant==0.1.2`.
   Evidence: commit `ce5c232` added the manual
   `.github/workflows/publish-pypi.yml` Trusted Publishing workflow. A PyPI
   pending publisher was registered for project `orbitquant`, owner
@@ -316,6 +338,19 @@ URL, or signed-off audit note.
   `OrbitQuantConfig().runtime_mode == "auto_fused"`,
   `OrbitQuantConfig().packed_matmul_block_n == 128`, and
   `orbitquant --version == "0.1.1"`.
+  Patch publish run `29025225397` completed successfully on 2026-07-09 from
+  head SHA `f18feb95f7595965f046b3455997d6ce9b8e8e4a`, including full pytest,
+  `ruff check`, package build, `twine check`, wheel smoke, OIDC publication,
+  and PyPI digital attestations. The PyPI JSON API reports version `0.1.2` with
+  `orbitquant-0.1.2.tar.gz` SHA256
+  `4afc15589fe713345dfa47be30dc078d943484a1f4bbd4861a413532a6ec8377` and
+  `orbitquant-0.1.2-py3-none-any.whl` SHA256
+  `3bdddebaa46f60307ed50e2ebf4b7ff4fef7817845b512ecfbb6fbf8ba71c91c`; a fresh
+  venv installed `orbitquant==0.1.2` from PyPI and verified
+  `orbitquant.__version__ == "0.1.2"`,
+  `OrbitQuantConfig().runtime_mode == "auto_fused"`,
+  `orbitquant --version == "0.1.2"`, and `orbitquant audit-hf-artifacts --help`
+  includes `--summary-only`.
 - [x] ComfyUI compatibility is verified after the relevant schema stabilizes,
   including load, graph execution, artifact metadata behavior, and kernel extra
   install guidance for the default `auto_fused` runtime.
@@ -332,7 +367,37 @@ URL, or signed-off audit note.
   `ruff`, package build, and `twine check`, and passed GitHub CI run
   `29020564152` on 2026-07-09. A live GitHub check then reported
   `iamwavecut/ComfyUI-OrbitQuant` as `PUBLIC`, Apache-2.0 licensed, with
-  default branch `main`.
+  default branch `main`. Follow-up commit `85527ee` required
+  `orbitquant>=0.1.1` after the packed-matmul default update and passed
+  GitHub CI run `29022774661`. Current commit `4832d4a` requires
+  `orbitquant>=0.1.2`, updates the README install commands for both
+  `orbitquant>=0.1.2` and `orbitquant[kernels]>=0.1.2`, refreshes `uv.lock`
+  to the PyPI `orbitquant` 0.1.2 release hashes, and passed GitHub CI run
+  `29027011708` on 2026-07-09. GitHub Release
+  `https://github.com/iamwavecut/ComfyUI-OrbitQuant/releases/tag/v0.1.0` was
+  published on 2026-07-09T15:12Z from commit
+  `4832d4addb39681e82f38e07627a2bb682e4332d` with assets
+  `comfyui_orbitquant-0.1.0.tar.gz` SHA256
+  `630628c56e5ed35626cd7cca6749c51056cb78a0041b7c1268cf0b5e995d28c0` and
+  `comfyui_orbitquant-0.1.0-py3-none-any.whl` SHA256
+  `0c774c20a6759bea18d5d02b598035c3446a72ee4efaa0be6c1f325f4b3e928b`.
+  Before release, local `uv run pytest -q`, `uv run ruff check .`, package
+  build, and `twine check` passed for the node pack. Follow-up commit
+  `ca62b7a` added the manual `.github/workflows/publish-pypi.yml` Trusted
+  Publishing workflow for a future `comfyui-orbitquant` PyPI release. GitHub
+  reported both `CI` and `Publish PyPI` workflows as active, and ComfyUI CI run
+  `29028857599` passed on 2026-07-09 with node-pack tests, lint, package
+  build, package metadata check, and wheel smoke. The GitHub `pypi`
+  environment was created on 2026-07-09T15:21Z. After PyPI password
+  confirmation, the pending publisher for `comfyui-orbitquant` was registered
+  and workflow run `29029534070` published `comfyui-orbitquant==0.1.0` through
+  Trusted Publishing on 2026-07-09. The PyPI version JSON for `0.1.0` reports
+  `comfyui_orbitquant-0.1.0-py3-none-any.whl` SHA256
+  `0c774c20a6759bea18d5d02b598035c3446a72ee4efaa0be6c1f325f4b3e928b` and
+  `comfyui_orbitquant-0.1.0.tar.gz` SHA256
+  `9a2c1e23e7c7674bb8fb7c350473c9ad636c952c5495b71d805a91996a00b51f`. A fresh
+  venv installed `comfyui-orbitquant==0.1.0` from PyPI and imported
+  `comfyui_orbitquant.NODE_CLASS_MAPPINGS`.
 - [x] MPS shader-only gate can be run independently from the native packed
   matmul package gate. Evidence: on 2026-07-09,
   `ORBITQUANT_RUN_NATIVE_KERNEL_PACKAGE_CI=0` with tiny benchmark dimensions

{orbitquant-0.1.2 → orbitquant-0.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "orbitquant"
-version = "0.1.2"
+version = "0.1.3"
 description = "Clean-room OrbitQuant implementation for diffusion transformers"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -38,7 +38,7 @@ hf = [
 ]
 kernels = [
   "kernels>=0.16",
-  "triton>=3.5",
+  "triton>=3.5; platform_system == 'Linux'",
 ]
 eval = [
   "imageio>=2.37",

{orbitquant-0.1.2 → orbitquant-0.1.3}/scripts/run_cuda_kernel_checks.sh

@@ -237,14 +237,14 @@ PY
       printf '%s\n' \
         "native kernel package CI could not load a compatible prebuilt native packed-matmul kernel." \
         "The script will not start a kernel-builder/Nix source build unless ORBITQUANT_ALLOW_NATIVE_KERNEL_BUILD=1 is set, because uncached CUDA builds can compile the CUDA/NCCL stack on paid GPU hosts." \
-        "Use a loadable Hugging Face Kernel Hub artifact, set LOCAL_KERNELS to a compatible built CUDA variant, or rerun with ORBITQUANT_ALLOW_NATIVE_KERNEL_BUILD=1 only on a host where the build cache/toolchain is intentional." \
+        "Make a compatible orbitquant_packed_matmul package importable, use a loadable Hugging Face Kernel Hub artifact, set LOCAL_KERNELS to a compatible built CUDA variant, or rerun with ORBITQUANT_ALLOW_NATIVE_KERNEL_BUILD=1 only on a host where the build cache/toolchain is intentional." \
         >&2
       exit 1
     fi
     if ! command -v nix >/dev/null 2>&1; then
       printf '%s\n' \
         "native kernel package CI requires either a loadable prebuilt native packed-matmul kernel or nix for kernel-builder." \
-        "Install nix, use a GPU image with nix, set LOCAL_KERNELS to a compatible built variant, wait for the Hugging Face kernel repo to become loadable, or set ORBITQUANT_RUN_NATIVE_KERNEL_PACKAGE_CI=0 only when intentionally skipping native package closure." \
+        "Install nix, make a compatible orbitquant_packed_matmul package importable, set LOCAL_KERNELS to a compatible built variant, wait for the Hugging Face kernel repo to become loadable, or set ORBITQUANT_RUN_NATIVE_KERNEL_PACKAGE_CI=0 only when intentionally skipping native package closure." \
         >&2
       exit 1
     fi

{orbitquant-0.1.2 → orbitquant-0.1.3}/scripts/run_mps_kernel_checks.sh

@@ -94,7 +94,7 @@ if [[ "$RUN_NATIVE_KERNEL_PACKAGE_CI" == "1" && -z "${LOCAL_KERNELS:-}" ]]; then
     stage "native-packed-matmul-local-variant-missing status=$native_kernel_variant_status"
     printf '%s\n' \
       "native packed matmul local variant was not found for this MPS runtime." \
-      "Set LOCAL_KERNELS=$NATIVE_KERNEL_REPO_ID=/absolute/path/to/a/built/variant containing metadata.json, build the matching kernel-builder variant, or set ORBITQUANT_RUN_NATIVE_KERNEL_PACKAGE_CI=0 to run only the inline Metal shader checks." \
+      "Make a compatible orbitquant_packed_matmul package importable, set LOCAL_KERNELS=$NATIVE_KERNEL_REPO_ID=/absolute/path/to/a/built/variant containing metadata.json, build the matching kernel-builder variant, or set ORBITQUANT_RUN_NATIVE_KERNEL_PACKAGE_CI=0 to run only the inline Metal shader checks." \
       >&2
   fi
 fi

{orbitquant-0.1.2 → orbitquant-0.1.3}/src/orbitquant/__init__.py

@@ -12,7 +12,7 @@ from orbitquant.pipeline import (
 )
 from orbitquant.quantizer import register_hf_quantizers
 
-__version__ = "0.1.2"
+__version__ = "0.1.3"
 
 register_hf_quantizers()