stage-cli 1.1.2__tar.gz → 1.1.3__tar.gz

{stage_cli-1.1.2 → stage_cli-1.1.3}/.gitignore

@@ -88,5 +88,3 @@ desktop.ini
 $RECYCLE.BIN/
 *.lnk
 
-# Local-only release runbook
-packaging/RELEASING.md

{stage_cli-1.1.2 → stage_cli-1.1.3}/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to this project are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project
 follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.3] - 2026-09-09
+
+### Fixed
+
+- `doctor` said greenhouse stored nothing on a run that stored 138. A source
+  left out of a run writes a row of zeroes, and the volume check read those as
+  real while discarding every run that deferred a board. Greenhouse defers on
+  all of them. A run counts now only if the source ran, and a deferred run is
+  measured against other deferred runs.
+- Haize Labs and Odin Dynamics are off. Both boards 404 with nowhere to move to.
+  The two internships they published were already quarantined as non-CS.
+- The PyPI page showed no author. A name and an email in one metadata field get
+  folded into a single header, leaving the author line blank.
+
 ## [1.1.2] - 2026-09-09
 
 ### Fixed
@@ -107,6 +121,7 @@ them in a SQLite database on your own machine.
 
 Python 3.12, 3.13 or 3.14 on macOS, Linux or Windows.
 
+[1.1.3]: https://github.com/NicholasXydis/Stage/releases/tag/v1.1.3
 [1.1.2]: https://github.com/NicholasXydis/Stage/releases/tag/v1.1.2
 [1.1.1]: https://github.com/NicholasXydis/Stage/releases/tag/v1.1.1
 [1.1.0]: https://github.com/NicholasXydis/Stage/releases/tag/v1.1.0

{stage_cli-1.1.2 → stage_cli-1.1.3}/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.5
 Name: stage-cli
-Version: 1.1.2
+Version: 1.1.3
 Summary: Aggregates CS internship postings (Canada/US, EN + FR) into a local SQLite database
 Project-URL: Homepage, https://github.com/NicholasXydis/Stage
 Project-URL: Repository, https://github.com/NicholasXydis/Stage
 Project-URL: Issues, https://github.com/NicholasXydis/Stage/issues
 Project-URL: Changelog, https://github.com/NicholasXydis/Stage/blob/main/CHANGELOG.md
-Author-email: Nicholas Xydis <NicholasXydis@outlook.com>
+Author: Nicholas Xydis
+Maintainer-email: Nicholas Xydis <NicholasXydis@outlook.com>
 License: MIT
 License-File: LICENSE
 Keywords: cli,co-op,internship,python,stage,student,tui
@@ -59,7 +60,7 @@ Free and open source. No account, no server, no telemetry.
 
 ![python](https://img.shields.io/static/v1?label=python&message=3.12%20%7C%203.13%20%7C%203.14&color=4a9eff&logo=python&logoColor=white)
 
-![tests](https://img.shields.io/static/v1?label=tests&message=2%2C414&color=44bb00) ![coverage](https://img.shields.io/static/v1?label=coverage&message=89%25&color=44bb00) [![ci](https://img.shields.io/github/actions/workflow/status/NicholasXydis/Stage/ci.yml?branch=main&label=ci&logo=githubactions&logoColor=white)](https://github.com/NicholasXydis/Stage/actions/workflows/ci.yml)
+![tests](https://img.shields.io/static/v1?label=tests&message=2%2C420&color=44bb00) ![coverage](https://img.shields.io/static/v1?label=coverage&message=89%25&color=44bb00) [![ci](https://img.shields.io/github/actions/workflow/status/NicholasXydis/Stage/ci.yml?branch=main&label=ci&logo=githubactions&logoColor=white)](https://github.com/NicholasXydis/Stage/actions/workflows/ci.yml)
 
 <br>
 
@@ -90,7 +91,7 @@ Internships disappear fast. By the time you find the right posting, hundreds of
 
 Stage scans 1,450+ employer career boards and finds internships CS undergrads in Canada and the U.S. can actually apply to. Every rejected posting is logged with the exact reason it was filtered out.
 
-It has kept **3,577** postings out of **166,298** screened so far.
+It has kept **4,024** postings out of **188,284** screened so far.
 
 ## A look at it
 
@@ -272,7 +273,7 @@ Stage/
 │  ├─ http/                 rate posture, circuit breaker, validator cache
 │  ├─ storage/              SQLite repository, migrations, FTS
 │  └─ data/                 packaged registry (a directory) and lexicons
-├─ tests/                   2,414 tests, 89% branch coverage
+├─ tests/                   2,420 tests, 89% branch coverage
 └─ .github/workflows/       CI, CodeQL, scheduled canary, release
 ```
 
@@ -299,7 +300,7 @@ Stage/
                ▼                               ▼
         ┌─────────────┐                 ┌─────────────┐
         │    jobs     │                 │ quarantine  │
-        │    5,495    │                 │   160,803   │
+        │    6,219    │                 │   182,065   │
         └──────┬──────┘                 └─────────────┘
                │  dedup collapses the same posting across sources
                ▼
@@ -318,7 +319,7 @@ Stage/
 
 | Workflow | File | Purpose |
 | --- | --- | --- |
-| CI | `.github/workflows/ci.yml` | Ruff, format, mypy strict, 2,414 tests, coverage floor, badge drift |
+| CI | `.github/workflows/ci.yml` | Ruff, format, mypy strict, 2,420 tests, coverage floor, badge drift |
 | Supported Pythons | `.github/workflows/ci.yml` | The full suite again on 3.13 and 3.14 |
 | Wheel | `.github/workflows/ci.yml` | Builds and smoke-tests the wheel on Ubuntu, Windows and macOS |
 | CodeQL | `.github/workflows/codeql.yml` | Static analysis for Python and the workflows themselves |

{stage_cli-1.1.2 → stage_cli-1.1.3}/README.md

@@ -20,7 +20,7 @@ Free and open source. No account, no server, no telemetry.
 
 ![python](https://img.shields.io/static/v1?label=python&message=3.12%20%7C%203.13%20%7C%203.14&color=4a9eff&logo=python&logoColor=white)
 
-![tests](https://img.shields.io/static/v1?label=tests&message=2%2C414&color=44bb00) ![coverage](https://img.shields.io/static/v1?label=coverage&message=89%25&color=44bb00) [![ci](https://img.shields.io/github/actions/workflow/status/NicholasXydis/Stage/ci.yml?branch=main&label=ci&logo=githubactions&logoColor=white)](https://github.com/NicholasXydis/Stage/actions/workflows/ci.yml)
+![tests](https://img.shields.io/static/v1?label=tests&message=2%2C420&color=44bb00) ![coverage](https://img.shields.io/static/v1?label=coverage&message=89%25&color=44bb00) [![ci](https://img.shields.io/github/actions/workflow/status/NicholasXydis/Stage/ci.yml?branch=main&label=ci&logo=githubactions&logoColor=white)](https://github.com/NicholasXydis/Stage/actions/workflows/ci.yml)
 
 <br>
 
@@ -51,7 +51,7 @@ Internships disappear fast. By the time you find the right posting, hundreds of
 
 Stage scans 1,450+ employer career boards and finds internships CS undergrads in Canada and the U.S. can actually apply to. Every rejected posting is logged with the exact reason it was filtered out.
 
-It has kept **3,577** postings out of **166,298** screened so far.
+It has kept **4,024** postings out of **188,284** screened so far.
 
 ## A look at it
 
@@ -233,7 +233,7 @@ Stage/
 │  ├─ http/                 rate posture, circuit breaker, validator cache
 │  ├─ storage/              SQLite repository, migrations, FTS
 │  └─ data/                 packaged registry (a directory) and lexicons
-├─ tests/                   2,414 tests, 89% branch coverage
+├─ tests/                   2,420 tests, 89% branch coverage
 └─ .github/workflows/       CI, CodeQL, scheduled canary, release
 ```
 
@@ -260,7 +260,7 @@ Stage/
                ▼                               ▼
         ┌─────────────┐                 ┌─────────────┐
         │    jobs     │                 │ quarantine  │
-        │    5,495    │                 │   160,803   │
+        │    6,219    │                 │   182,065   │
         └──────┬──────┘                 └─────────────┘
                │  dedup collapses the same posting across sources
                ▼
@@ -279,7 +279,7 @@ Stage/
 
 | Workflow | File | Purpose |
 | --- | --- | --- |
-| CI | `.github/workflows/ci.yml` | Ruff, format, mypy strict, 2,414 tests, coverage floor, badge drift |
+| CI | `.github/workflows/ci.yml` | Ruff, format, mypy strict, 2,420 tests, coverage floor, badge drift |
 | Supported Pythons | `.github/workflows/ci.yml` | The full suite again on 3.13 and 3.14 |
 | Wheel | `.github/workflows/ci.yml` | Builds and smoke-tests the wheel on Ubuntu, Windows and macOS |
 | CodeQL | `.github/workflows/codeql.yml` | Static analysis for Python and the workflows themselves |

{stage_cli-1.1.2 → stage_cli-1.1.3}/SECURITY.md

@@ -4,7 +4,7 @@
 
 | Version | Supported |
 | --- | --- |
-| 1.1.2 | ✅ |
+| 1.1.3 | ✅ |
 
 Only the latest release receives security fixes.
 

{stage_cli-1.1.2 → stage_cli-1.1.3}/assets/ci-flow.svg

@@ -22,7 +22,7 @@
 
     <rect x="240" y="42" width="180" height="58" rx="12" fill="#111C30" stroke="#3B82F6" stroke-width="2"/>
     <text x="330" y="66" fill="#F0F6FC" font-size="14">ruff, format, mypy</text>
-    <text x="330" y="86" fill="#F0F6FC" font-size="14">2,414 tests, 89%</text>
+    <text x="330" y="86" fill="#F0F6FC" font-size="14">2,420 tests, 89%</text>
 
     <path d="M420 71H470" stroke="#3B82F6" stroke-width="3" marker-end="url(#arrow)"/>
 

{stage_cli-1.1.2 → stage_cli-1.1.3}/pyproject.toml

@@ -5,7 +5,8 @@ description = "Aggregates CS internship postings (Canada/US, EN + FR) into a loc
 readme = "README.md"
 requires-python = ">=3.12,<3.15"
 license = { text = "MIT" }
-authors = [{ name = "Nicholas Xydis", email = "NicholasXydis@outlook.com" }]
+authors = [{ name = "Nicholas Xydis" }]
+maintainers = [{ name = "Nicholas Xydis", email = "NicholasXydis@outlook.com" }]
 keywords = [
     "internship",
     "stage",

stage_cli-1.1.3/src/stage/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.1.3"

{stage_cli-1.1.2 → stage_cli-1.1.3}/src/stage/data/companies/h.yaml

@@ -11,6 +11,8 @@
   slug: haizelabs
   source_of_record: discover
   last_verified: &id004 2026-08-14
+  enabled: false
+  notes: '2026-09-09: greenhouse/haizelabs 404s and their board page 500s; no ashby or lever board exists'
 - name: Halcyon
   platform: greenhouse
   slug: halcyon

{stage_cli-1.1.2 → stage_cli-1.1.3}/src/stage/data/companies/o.yaml

@@ -43,9 +43,8 @@
   source_of_record: discover
   last_verified: &id004 2026-08-14
   name_gate_exempt: true
-  notes: '2026-08-14: board token taken from this employer''s own application URL
-    in a feed posting, not from slug guessing; ashby publishes no board name, so the
-    name gate cannot confirm it and provenance is the evidence (12 job(s))'
+  enabled: false
+  notes: '2026-09-09: ashby/odin-dynamics 404s while the ashby API is healthy; the employer removed the board'
 - name: Off world studios
   platform: bamboohr
   slug: owi

{stage_cli-1.1.2 → stage_cli-1.1.3}/src/stage/domain/__init__.py

@@ -65,6 +65,7 @@ from stage.domain.filters import DEFAULT_LIMIT, DEFAULT_WINDOW_DAYS, JobFilters
 from stage.domain.health import (
     MIN_VOLUME_HISTORY,
     STALE_AFTER_DAYS,
+    UNRECORDED_FETCH,
     UNRECORDED_VOLUME,
     VOLUME_DROP_RATIO,
     IntegrityFinding,
@@ -210,6 +211,7 @@ __all__ = [
     "rotate",
     "MIN_VOLUME_HISTORY",
     "STALE_AFTER_DAYS",
+    "UNRECORDED_FETCH",
     "UNRECORDED_VOLUME",
     "VOLUME_DROP_RATIO",
     "IntegrityFinding",

{stage_cli-1.1.2 → stage_cli-1.1.3}/src/stage/domain/health.py

@@ -7,6 +7,7 @@ MIN_VOLUME_HISTORY = 3
 VOLUME_DROP_RATIO = 0.5
 STALE_AFTER_DAYS = 14
 UNRECORDED_VOLUME = -1
+UNRECORDED_FETCH = -1
 
 
 class VolumeVerdict(StrEnum):
@@ -27,10 +28,21 @@ class VolumePoint:
     stored: int
     deferred: int = 0
     blocked: bool = False
+    fetched: int = UNRECORDED_FETCH
+    requests: int = UNRECORDED_FETCH
+    not_modified: int = UNRECORDED_FETCH
+
+    @property
+    def ran(self) -> bool:
+        return self.fetched != 0 or self.requests != 0 or self.not_modified != 0
+
+    @property
+    def rotated(self) -> bool:
+        return self.deferred > 0
 
     @property
     def is_evidence(self) -> bool:
-        return self.stored > UNRECORDED_VOLUME and self.deferred == 0 and not self.blocked
+        return self.stored > UNRECORDED_VOLUME and not self.blocked and self.ran
 
 
 @dataclass(frozen=True, slots=True)
@@ -59,8 +71,9 @@ def assess_volume(source: str, history: list[VolumePoint]) -> VolumeSignal:
             detail=_unproven_reason(history),
         )
 
-    latest = evidence[0].stored
-    prior = [point.stored for point in evidence[1:]]
+    newest = evidence[0]
+    latest = newest.stored
+    prior = [point.stored for point in evidence[1:] if point.rotated == newest.rotated]
     if len(prior) < MIN_VOLUME_HISTORY:
         return VolumeSignal(
             source=source,
@@ -114,10 +127,10 @@ def assess_volume(source: str, history: list[VolumePoint]) -> VolumeSignal:
 def _unproven_reason(history: list[VolumePoint]) -> str:
     if not history:
         return "no runs on record"
-    if any(point.blocked for point in history):
+    if not any(point.ran for point in history):
+        return "no run fetched this source, so none of them can show a drop"
+    if all(point.blocked for point in history if point.ran):
         return "every run was blocked, which is a throttle not a drop"
-    if any(point.deferred for point in history):
-        return "every run deferred members, so rotation explains it"
     return "no run has recorded a stored count yet"
 
 
@@ -157,6 +170,7 @@ class IntegrityFinding:
 __all__ = [
     "MIN_VOLUME_HISTORY",
     "STALE_AFTER_DAYS",
+    "UNRECORDED_FETCH",
     "UNRECORDED_VOLUME",
     "VOLUME_DROP_RATIO",
     "IntegrityFinding",

{stage_cli-1.1.2 → stage_cli-1.1.3}/src/stage/storage/sqlite_repo.py

@@ -1381,7 +1381,8 @@ class SqliteRepository:
 
     def volume_history(self, limit: int) -> Mapping[str, list[VolumePoint]]:
         rows = self._conn.execute(
-            "SELECT source, stored, deferred, blocked FROM sync_run_sources "
+            "SELECT source, stored, deferred, blocked, fetched, requests, not_modified "
+            "FROM sync_run_sources "
             "WHERE run_id IN (SELECT id FROM sync_runs ORDER BY id DESC LIMIT ?) "
             "ORDER BY run_id DESC",
             (limit,),
@@ -1393,6 +1394,9 @@ class SqliteRepository:
                     stored=int(row["stored"]),
                     deferred=int(row["deferred"]),
                     blocked=bool(row["blocked"]),
+                    fetched=int(row["fetched"]),
+                    requests=int(row["requests"]),
+                    not_modified=int(row["not_modified"]),
                 )
             )
         return history

{stage_cli-1.1.2 → stage_cli-1.1.3}/tests/test_health.py

@@ -58,6 +58,50 @@ def test_a_blocked_run_cannot_raise_a_volume_alert() -> None:
     assert signal.verdict is not VolumeVerdict.COLLAPSED, "a throttle is not drift"
 
 
+def _idle(count: int) -> list[VolumePoint]:
+    return [VolumePoint(stored=0, fetched=0, requests=0, not_modified=0)] * count
+
+
+def _ran(*stored: int) -> list[VolumePoint]:
+    return [VolumePoint(stored=value, fetched=value, requests=4) for value in stored]
+
+
+def test_a_source_left_out_of_a_run_is_not_a_source_that_collapsed() -> None:
+    signal = assess_volume("greenhouse", _idle(1) + _ran(74, 74, 74, 74))
+    assert signal.verdict is not VolumeVerdict.COLLAPSED
+
+
+def test_a_source_left_out_of_a_run_cannot_drag_the_baseline_down() -> None:
+    signal = assess_volume("greenhouse", _ran(138) + _idle(3) + _ran(231, 223, 219))
+    assert signal.verdict is VolumeVerdict.HEALTHY
+    assert signal.samples == 3
+
+
+def test_a_source_that_never_ran_proves_nothing() -> None:
+    signal = assess_volume("ashby", _idle(5))
+    assert signal.verdict is VolumeVerdict.UNPROVEN
+    assert "fetched" in signal.detail
+
+
+def test_a_source_that_fetched_rows_and_stored_none_still_collapses() -> None:
+    live = VolumePoint(stored=0, fetched=44, requests=1)
+    signal = assess_volume("quebec-emploi", [live] + _ran(40, 41, 40))
+    assert signal.verdict is VolumeVerdict.COLLAPSED
+
+
+def test_a_source_blocked_on_every_run_is_a_throttle_not_a_drop() -> None:
+    history = [VolumePoint(stored=0, blocked=True, requests=4)] * 4
+    signal = assess_volume("workday", history)
+    assert signal.verdict is VolumeVerdict.UNPROVEN
+    assert "throttle" in signal.detail
+
+
+def test_a_run_that_was_all_cache_hits_still_counts_as_having_run() -> None:
+    cached = VolumePoint(stored=0, fetched=0, requests=0, not_modified=12)
+    signal = assess_volume("lever", [cached] + _ran(40, 41, 40))
+    assert signal.verdict is VolumeVerdict.COLLAPSED
+
+
 def test_a_run_predating_the_stored_column_is_not_a_baseline_of_zero() -> None:
     history = [VolumePoint(stored=12)] + _points(*([UNRECORDED_VOLUME] * 6))
     signal = assess_volume("greenhouse", history)
@@ -143,7 +187,7 @@ async def test_doctor_names_the_source_whose_volume_collapsed(db_path: Path) ->
                     started_at=NOW,
                     finished_at=NOW,
                     outcome=SyncOutcome.SUCCESS,
-                    sources=(SourceRunStats(source="lever", stored=stored),),
+                    sources=(SourceRunStats(source="lever", stored=stored, requests=4),),
                 )
             )
         report = await doctor(repository, now=NOW)

stage_cli-1.1.2/src/stage/__init__.py

@@ -1 +0,0 @@
-__version__ = "1.1.2"