unalloc 0.2.2__tar.gz → 0.2.3__tar.gz

{unalloc-0.2.2 → unalloc-0.2.3}/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.2.3 — 2026-09-21
+
+### Fixed
+- Figure 9's within-run spread is drawn as its own vertical bar rather than an error bar hung off the whole-run point. The old form had to clip whenever the whole-run share fell outside the window quartiles, which it does at three of the eight plotted points — the whole-run share is weighted by each window's traffic, so it need not lie inside the quartiles of its own windows.
+- §9 no longer presents the window statistics as a bootstrap confidence interval or as a bound on uncertainty. Consecutive windows of one run are not independent observations, so the paragraph now reports median, interquartile range and sign as descriptive statistics of that run, and the cross-reference matches what the figure actually draws. `bootstrap_ci` is renamed `resample_range`, and the metrics key `divergence_mean_ci95` becomes `divergence_mean_resample_range`.
+- arXiv kit refreshed against the built PDF: 14 pages, AI-use disclosure on page 13, and the concept DOI in the Comments field. The standalone abstract gained the synthetic-scenario qualification and the session-initial arrival-rate clarification that the paper's abstract already carried.
+
+### Added
+- `tests/test_paper_numbers.py` also checks the submission kit: the page, figure and table counts against the committed PDF, the concept DOI in both the kit and the paper, and the standalone abstract's length and scope wording.
+
 ## 0.2.2 — 2026-09-21
 
 ### Fixed

{unalloc-0.2.2 → unalloc-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: unalloc
-Version: 0.2.2
+Version: 0.2.3
 Summary: Find the AI spend nobody owns. Joins OpenCost allocation data with LLM provider bills and reports what's unattributed.
 Project-URL: Homepage, https://github.com/timurista/unalloc
 Project-URL: Issues, https://github.com/timurista/unalloc/issues
@@ -261,14 +261,14 @@ ruff check . && pytest
 
 If you use unalloc or its case studies, please cite the archived release. GitHub's "Cite this repository" button produces the same entry from [`CITATION.cff`](https://github.com/timurista/unalloc/blob/main/CITATION.cff).
 
-- **All versions:** [doi:10.5281/zenodo.22761012](https://doi.org/10.5281/zenodo.22761012), which always resolves to the latest release — currently 0.2.2, the code the paper describes
+- **All versions:** [doi:10.5281/zenodo.22761012](https://doi.org/10.5281/zenodo.22761012), which always resolves to the latest release — currently 0.2.3, the code the paper describes
 - **Version 0.2.1:** [doi:10.5281/zenodo.22761013](https://doi.org/10.5281/zenodo.22761013)
 
 ```bibtex
 @software{urista_unalloc_2026,
   author  = {Urista, Timothy},
   title   = {unalloc: find the AI spend nobody owns},
-  version = {0.2.2},
+  version = {0.2.3},
   year    = {2026},
   doi     = {10.5281/zenodo.22761012},
   url     = {https://github.com/timurista/unalloc}

{unalloc-0.2.2 → unalloc-0.2.3}/README.md

@@ -219,14 +219,14 @@ ruff check . && pytest
 
 If you use unalloc or its case studies, please cite the archived release. GitHub's "Cite this repository" button produces the same entry from [`CITATION.cff`](https://github.com/timurista/unalloc/blob/main/CITATION.cff).
 
-- **All versions:** [doi:10.5281/zenodo.22761012](https://doi.org/10.5281/zenodo.22761012), which always resolves to the latest release — currently 0.2.2, the code the paper describes
+- **All versions:** [doi:10.5281/zenodo.22761012](https://doi.org/10.5281/zenodo.22761012), which always resolves to the latest release — currently 0.2.3, the code the paper describes
 - **Version 0.2.1:** [doi:10.5281/zenodo.22761013](https://doi.org/10.5281/zenodo.22761013)
 
 ```bibtex
 @software{urista_unalloc_2026,
   author  = {Urista, Timothy},
   title   = {unalloc: find the AI spend nobody owns},
-  version = {0.2.2},
+  version = {0.2.3},
   year    = {2026},
   doi     = {10.5281/zenodo.22761012},
   url     = {https://github.com/timurista/unalloc}

{unalloc-0.2.2 → unalloc-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "unalloc"
-version = "0.2.2"
+version = "0.2.3"
 description = "Find the AI spend nobody owns. Joins OpenCost allocation data with LLM provider bills and reports what's unattributed."
 readme = "README.md"
 requires-python = ">=3.11"

{unalloc-0.2.2 → unalloc-0.2.3}/src/unalloc/__init__.py

@@ -2,5 +2,5 @@
 
 from __future__ import annotations
 
-__version__ = "0.2.2"
+__version__ = "0.2.3"
 __all__ = ["__version__"]

{unalloc-0.2.2 → unalloc-0.2.3}/tests/test_paper_numbers.py

@@ -110,3 +110,53 @@ def test_configured_rate_is_distinguished_from_completed_traffic(rows):
     assert "session-initial" in text
     done = [run["requests"] / run["wall_s"] for _, run in rows]
     assert f"{min(done):.1f} to {max(done):.1f} completed requests per second" in text
+
+
+# --- the arXiv submission kit must describe the PDF that is actually committed ---
+
+PDF = ROOT / "paper" / "unalloc-case-studies.pdf"
+KIT = ROOT / "paper" / "arxiv" / "SUBMISSION.md"
+ABSTRACT = ROOT / "paper" / "arxiv" / "abstract.txt"
+
+
+def _pdf_pages(path: Path) -> int:
+    """Page count from the PDF's page tree, without a PDF library."""
+    blob = path.read_bytes()
+    counts = re.findall(rb"/Type\s*/Pages[^>]*?/Count\s+(\d+)", blob)
+    assert counts, "no page tree found in the PDF"
+    return max(int(c) for c in counts)
+
+
+@pytest.mark.skipif(not PDF.exists() or not KIT.exists(), reason="paper artifacts not present")
+def test_submission_comments_match_the_built_pdf():
+    kit = KIT.read_text()
+    pages = _pdf_pages(PDF)
+    assert f"| Comments | {pages} pages," in kit, (
+        f"SUBMISSION.md Comments claims a different length; the PDF has {pages} pages"
+    )
+    source = SOURCE.read_text()
+    figures = source.count("#figure(image(")
+    tables = len(re.findall(r"^#figure\($", source, re.MULTILINE))
+    assert f"{pages} pages, {figures} figures, {tables} tables" in kit
+
+
+@pytest.mark.skipif(not KIT.exists(), reason="submission kit not present")
+def test_submission_kit_cites_the_concept_doi():
+    """A version DOI goes stale on the next release; the concept DOI does not."""
+    kit = KIT.read_text()
+    concept = "10.5281/zenodo.22761012"
+    assert f"Software: doi:{concept}" in kit
+    assert concept in SOURCE.read_text(), "the paper itself should cite the same DOI"
+
+
+@pytest.mark.skipif(not ABSTRACT.exists(), reason="abstract not present")
+def test_standalone_abstract_carries_the_same_qualifications_as_the_paper():
+    text = ABSTRACT.read_text().strip()
+    assert len(text) <= 1920, f"arXiv caps the abstract at 1920 characters; this is {len(text)}"
+    # The two scope corrections must survive in the copy that readers see first.
+    assert "constructed multi-pod deployment scenario" in text
+    assert "synthetic OpenCost allocations" in text
+    assert "session-initial" in text
+    assert "completed requests per second" in text
+    # The bare claim the review flagged must not come back.
+    assert "97-99% from 2 to 16 requests per second" not in text