From 59e1b8d8c2b62e35934067606e0ff7a304ead7ea Mon Sep 17 00:00:00 2001 From: gregoryfoster Date: Sun, 15 Nov 2026 20:04:55 +0000 Subject: [PATCH 1/3] #206 chore: raise the co-core floor to >=0.48.0,<0.49 (catch-up) Two minors, locked at 0.48.2, the index's newest with the bound opened to <1. The pin comment carries the 0.46.1 -> 0.48.2 closure report from the locked wheels: two changed files, both Drive, which Replicator has no writer for. tests/test_dependency_index.py's bound moves to >=0.49. Co-Authored-By: Claude Opus 5.5 --- pyproject.toml | 91 +++++++++++++++++++++++----------- tests/test_dependency_index.py | 4 +- uv.lock | 24 ++++----- 3 files changed, 75 insertions(+), 44 deletions(-) diff --git a/pyproject.toml b/pyproject.toml index dc7b5398..113f2607 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -7,54 +7,85 @@ license = "MIT" license-files = ["LICENSE"] requires-python = ">=3.12" dependencies = [ - # Floor is 0.46.0, and it carries no new feature: a one-minor catch-up - # (#199), in #192's shape. The lock takes 0.46.1, the index's newest. The - # floor stays at .0 because nothing here depends on 0.46.1's one change, - # `co-core[extract]`'s soupsieve floor (cannobserv#667), an extra this - # project doesn't declare. `co-core-aio` and `co-core-sync` 0.46.x require - # `co-core>=0.46,<0.47`, so the three move together. 0.46.0's library - # changes are both on co/v1's read path, outside this closure: a CPT-backed - # record's `PostModel.wp_link` reads the server's `permalink` - # (cannobserv#664), and `EventModel.url` drops its `link` fallback - # (cannobserv#663). Its breaking removal, `WordPressMetadata`'s three - # `wp_view_*_url` templates, ships in none of the three wheels locked here. - # - # **`scripts/co_core_closure_diff.py 0.45.0 0.46.1`** (#145), verbatim: - # - # ## Import closure, 0.45.0 → 0.46.1 + # Floor is 0.48.0, and it carries no new feature: a two-minor catch-up + # (#206), in #199's shape. The lock takes 0.48.2, the index's newest with the + # bound opened to `<1` [measured 2026-11-15]. The floor stays at .0 because + # nothing here depends on 0.48.1's or 0.48.2's changes, Drive-only inside this + # closure. `co-core-aio` and `co-core-sync` 0.48.x require + # `co-core>=0.48,<0.49`, so the three move together. Each minor's break misses + # this closure. 0.47.0 renames `TranscriptSpeakerModel.relationship_id` to + # `role_assignment_id`, still reading the old name (cannobserv#469), and its + # WordPress disclosure-block removals (cannobserv#672) ship in none of the + # three wheels. 0.48.0's catalog-only `DisclosureServiceModel.service_type` + # (cannobserv#678) is on a model these wheels didn't have at 0.46.1. + # + # **`scripts/co_core_closure_diff.py 0.46.1 0.48.2`** (#145), verbatim, from + # the wheels this lock pins (their sha256 matched against `uv.lock`): + # + # ## Import closure, 0.46.1 → 0.48.2 # # Roots `src`, `scripts`; packages `co_core`, `co_core_aio`, `co_core_sync`. # - # 58 files at 0.45.0, 58 at 0.46.1. 3 not identical: + # 58 files at 0.46.1, 58 at 0.48.2. 5 not identical: # # - `version-only` co_core/__init__.py + # - `changed` co_core/effects/gdrive.py # - `version-only` co_core_aio/__init__.py # - `version-only` co_core_sync/__init__.py + # - `changed` co_core_sync/drivers/gdrive.py # # **Requires-Dist:** # - # - co_core: removed `soupsieve<3,>=2.0; extra == 'extract'`; added `soupsieve<5,>=4.1; extra == 'extract'` - # - co_core_aio: removed `co-core<0.46,>=0.45`; added `co-core<0.47,>=0.46` - # - co_core_sync: removed `co-core<0.46,>=0.45`; added `co-core<0.47,>=0.46` + # - co_core: unchanged + # - co_core_aio: removed `co-core<0.47,>=0.46`; added `co-core<0.49,>=0.48` + # - co_core_sync: removed `co-core<0.47,>=0.46`; added `co-core<0.49,>=0.48` # - # **Third-party imports** (at 0.46.1): `google`, `google_auth_oauthlib`, `googleapiclient`, `httpx`, `pydantic`, `redis`, `requests`, `urllib3`. + # **Third-party imports** (at 0.48.2): `google`, `google_auth_oauthlib`, `googleapiclient`, `httpx`, `pydantic`, `redis`, `requests`, `urllib3`. # # **Dynamic imports, not followed:** # # - co_core_sync/drivers/__init__.py:89 `import_module(f"{__name__}.{module}")` # - co_core_sync/drivers/blobstore/__init__.py:32 `import_module(f"{__name__}.{module}")` # - # Nothing to read by hand: the three files are `version-only`, and the - # closure is the same with `tests/` as a root. The dynamic imports are the - # same two as at 0.45.0. The soupsieve change is under `[extract]`, and - # soupsieve is not in `uv.lock`. Outside the closure, 0.46.x changed - # `pure/adapters/co_v1/`'s `event.py` and `responses.py`, - # `pure/models/link.py` (docstring) and `co_core_sync/services/event.py` - # (docstring), and added or removed no module. Nothing in `src/`, + # Read by hand (`--diff`), the two `changed` files are Drive only, and + # Replicator has no Drive writer: `KNOWN_PROVIDERS` is `("gcs",)` + # (`src/worker/aliases.py`), so a `gdrive-` alias is refused, and this host's + # alias table names none. + # + # - `effects/gdrive.py` adds the `GdriveDeleteIfPresent` effect, the + # `GdriveDeleteOutcome` enum and the effect's member of `GdriveEffect`. + # - `drivers/gdrive.py` passes `num_retries=DRIVE_NUM_RETRIES` (3) to + # `files().delete`, `.get` and `.list` (0.48.1, cannobserv#601), and adds + # `delete_if_present`, which maps a 404 to `ALREADY_ABSENT` (0.48.2, + # cannobserv#692). + # + # The closure is the same with `tests/` as a root, and the dynamic imports + # are the same two as at 0.46.1. Outside the closure, 0.47 and 0.48 changed + # co/v1's `exceptions.py` and `urls.py`, the transcript models, + # `workflows/upload.py`, co-core-sync's `runner.py` and seven `services/` + # modules, and added the WordPress `blocks`, `disclosure` and `transcript` + # adapters and the disclosure catalog and service modules. Nothing in `src/`, # `scripts/` or `tests/` reaches any of them. # # Previously: # + # Floor was 0.46.0, and it carried no new feature: a one-minor catch-up + # (#199), in #192's shape, locked at 0.46.1. 0.46.1's one change was + # `co-core[extract]`'s soupsieve floor (cannobserv#667), an extra this + # project doesn't declare. 0.46.0's library changes were both on co/v1's read + # path, outside this closure (cannobserv#664, cannobserv#663), and its breaking + # removal, `WordPressMetadata`'s `wp_view_*_url` templates, shipped in none of + # the three wheels. + # + # **Diffing the closure, 0.45.0 → 0.46.1** (58 files, both sides): 3 not + # identical, all `version-only`; Requires-Dist moved the aio/sync `co-core` + # bound and the `[extract]` soupsieve floor. Outside the closure, 0.46.x + # changed `pure/adapters/co_v1/`'s `event.py` and `responses.py`, + # `pure/models/link.py` and `co_core_sync/services/event.py`. Nothing in + # `src/`, `scripts/` or `tests/` reached any of them. + # + # Previously: + # # Floor was 0.45.0, and it carried no new feature: a one-minor catch-up # (#192), in #184's shape. 0.45.0's one library change was co/v1's # `EventModel.url`, which read the Event's `website` link and fell back to @@ -444,9 +475,9 @@ dependencies = [ # at module load, so a skew cannot reach a running worker at all. Additive over # 0.8.0 for everything the fetch path uses — no field on ContentFetchCommand, # BlobAvailableEvent or FetchFailedEvent moved between the two. - "co-core>=0.46.0,<0.47", - "co-core-aio[bus,gcs]>=0.46.0,<0.47", - "co-core-sync[gcs]>=0.46.0,<0.47", + "co-core>=0.48.0,<0.49", + "co-core-aio[bus,gcs]>=0.48.0,<0.49", + "co-core-sync[gcs]>=0.48.0,<0.49", "fastapi>=0.126.0,<1", "pydantic>=2.9,<3", "pydantic-settings>=2.5.0,<3", diff --git a/tests/test_dependency_index.py b/tests/test_dependency_index.py index 17a1cb34..b97084bb 100644 --- a/tests/test_dependency_index.py +++ b/tests/test_dependency_index.py @@ -60,7 +60,7 @@ def test_every_file_from_the_index_is_hashed_and_there_is_a_wheel(): def test_the_locked_versions_sit_inside_the_pin(): - """The index lists nothing past 0.46.1 [measured 2026-11-14, #199]; the pin's + """The index lists nothing past 0.48.2 [measured 2026-11-15, #206]; the pin's upper bound keeps the next minor out until the change that moves it.""" pins = { (r := Requirement(spec)).name: r.specifier @@ -69,7 +69,7 @@ def test_the_locked_versions_sit_inside_the_pin(): } for package in _from_index(): assert package["version"] in pins[package["name"]], package - assert package["version"] not in SpecifierSet(">=0.47"), package + assert package["version"] not in SpecifierSet(">=0.49"), package def test_no_other_source_kind_names_a_wheelhouse(): diff --git a/uv.lock b/uv.lock index 4bce036f..992727c5 100644 --- a/uv.lock +++ b/uv.lock @@ -285,28 +285,28 @@ wheels = [ [[package]] name = "co-core" -version = "0.46.1" +version = "0.48.2" source = { registry = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/simple/" } dependencies = [ { name = "dateparser" }, { name = "pydantic" }, ] -sdist = { url = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/co-core/co_core-0.46.1.tar.gz", hash = "sha256:b54608c1a52b2d7fd2317efb40111d4d20e30490703404c654fd14692f6f9e20" } +sdist = { url = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/co-core/co_core-0.48.2.tar.gz", hash = "sha256:501045fb891e5b6181bc7af7c828843ed2972d4fab7d90c8cd23202d4831c3ca" } wheels = [ - { url = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/co-core/co_core-0.46.1-py3-none-any.whl", hash = "sha256:70848e808df30bacb74b2d7a0627cb44c85e151b0c7521e5338d89e502b9891d" }, + { url = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/co-core/co_core-0.48.2-py3-none-any.whl", hash = "sha256:25a43b746bd5cb4cfc18b3a085ba5f3a7a487fd03c5c50905d0d5585056ca466" }, ] [[package]] name = "co-core-aio" -version = "0.46.1" +version = "0.48.2" source = { registry = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/simple/" } dependencies = [ { name = "co-core" }, { name = "httpx" }, ] -sdist = { url = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/co-core-aio/co_core_aio-0.46.1.tar.gz", hash = "sha256:217a3628dd87342c3164ab4c0bcea1ed58fa49796456181593d54ff4e43c1e0b" } +sdist = { url = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/co-core-aio/co_core_aio-0.48.2.tar.gz", hash = "sha256:56d55e41570bcb19b5c574474c6656ccf6a1da95af4b5f6622a93450e451b678" } wheels = [ - { url = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/co-core-aio/co_core_aio-0.46.1-py3-none-any.whl", hash = "sha256:d732f301bcd0cf7fb0f072a49f16915785fd804b2dda9fc2892e496d7014dc16" }, + { url = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/co-core-aio/co_core_aio-0.48.2-py3-none-any.whl", hash = "sha256:9ed5944d2290ab59cbd74fb28e25c7bf9252f6f35fbd4fd9c2c6448623aa01ac" }, ] [package.optional-dependencies] @@ -320,16 +320,16 @@ gcs = [ [[package]] name = "co-core-sync" -version = "0.46.1" +version = "0.48.2" source = { registry = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/simple/" } dependencies = [ { name = "co-core" }, { name = "requests" }, { name = "urllib3" }, ] -sdist = { url = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/co-core-sync/co_core_sync-0.46.1.tar.gz", hash = "sha256:4f9eafefaf96e68f3c5c5c566b1911be841e53317ee41e5e1290c74db8f948b9" } +sdist = { url = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/co-core-sync/co_core_sync-0.48.2.tar.gz", hash = "sha256:b6b7db7a4b45fc0f1fa5461a9b356b34ffe22ba6f2e790c4bda43af166dacbcb" } wheels = [ - { url = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/co-core-sync/co_core_sync-0.46.1-py3-none-any.whl", hash = "sha256:f61930a1655b530fad4352756c06252c1234c08ddbd7268f1aa6a87e198be8a9" }, + { url = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/co-core-sync/co_core_sync-0.48.2-py3-none-any.whl", hash = "sha256:455432530ad7ea9a44a304cc6ff84b3c4e1487a143a9f84f8ad97143a7440bee" }, ] [package.optional-dependencies] @@ -1354,9 +1354,9 @@ dev = [ [package.metadata] requires-dist = [ - { name = "co-core", specifier = ">=0.46.0,<0.47", index = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/simple/" }, - { name = "co-core-aio", extras = ["bus", "gcs"], specifier = ">=0.46.0,<0.47", index = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/simple/" }, - { name = "co-core-sync", extras = ["gcs"], specifier = ">=0.46.0,<0.47", index = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/simple/" }, + { name = "co-core", specifier = ">=0.48.0,<0.49", index = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/simple/" }, + { name = "co-core-aio", extras = ["bus", "gcs"], specifier = ">=0.48.0,<0.49", index = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/simple/" }, + { name = "co-core-sync", extras = ["gcs"], specifier = ">=0.48.0,<0.49", index = "https://us-west1-python.pkg.dev/co-gcs/co-pypi/simple/" }, { name = "fastapi", specifier = ">=0.126.0,<1" }, { name = "playwright", specifier = "==1.64.1" }, { name = "pydantic", specifier = ">=2.9,<3" }, From cae0dce9364d662e063638d3ca0fed3fac7dc94f Mon Sep 17 00:00:00 2001 From: gregoryfoster Date: Sun, 15 Nov 2026 20:04:56 +0000 Subject: [PATCH 2/3] #206 docs: name the 0.48.0 floor in AGENTS.md, DEPENDENCIES.md and the manifest Co-Authored-By: Claude Opus 5.5 --- .socraticodecontextartifacts.json | 2 +- AGENTS.md | 2 +- docs/DEPENDENCIES.md | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/.socraticodecontextartifacts.json b/.socraticodecontextartifacts.json index aac6e626..38f8b35d 100644 --- a/.socraticodecontextartifacts.json +++ b/.socraticodecontextartifacts.json @@ -163,7 +163,7 @@ { "name": "dependency-contract", "path": "./pyproject.toml", - "description": "Project and tooling contract. The co-core / co-core-aio / co-core-sync pins (>=0.46.0,<0.47 since #199's one-minor catch-up, locked at 0.46.1; 0.45.0 was #192's catch-up; 0.44.0 was #184's three-minor catch-up, the first on the co-pypi index; 0.41.0 was #179's catch-up; 0.40.1 was #177's, for #63's render field; 0.40.0 was #172's catch-up; 0.39 was #153's, ahead of #138's capture consumer; 0.37 was #136's, for FetchPolicyState.generation and fetch_policy_supersedes; 0.36 was #140's catch-up; each raise's wheel diff covers the whole import closure; 0.19.6 brought the content.persist contract, cannobserv#493, and 0.19.3 the shared content-addressed BlobStore, cannobserv#475) with no extra on co-core (its [extract] parsers were unused, dropped by #142) and [bus,gcs] / [gcs] on the other two, the floor history that explains each raise, the explicit co-pypi [[tool.uv.index]] with a [tool.uv.sources] entry per co-core package (#183), the ruff rule set and its skills-vendor exclusion, the ty exclusion, the replicator-worker console script, pytest configuration (asyncio auto mode, the integration and gcs markers both deselected by default, timeout) and the 80% coverage gate. The [build-system] uv_build bound is one minor (>=0.13.0,<0.14 since #195), mirrored by ci.yml's setup-uv version: inputs." + "description": "Project and tooling contract. The co-core / co-core-aio / co-core-sync pins (>=0.48.0,<0.49 since #206's two-minor catch-up, locked at 0.48.2; 0.46.0 was #199's catch-up; 0.45.0 was #192's catch-up; 0.44.0 was #184's three-minor catch-up, the first on the co-pypi index; 0.41.0 was #179's catch-up; 0.40.1 was #177's, for #63's render field; 0.40.0 was #172's catch-up; 0.39 was #153's, ahead of #138's capture consumer; 0.37 was #136's, for FetchPolicyState.generation and fetch_policy_supersedes; 0.36 was #140's catch-up; each raise's wheel diff covers the whole import closure; 0.19.6 brought the content.persist contract, cannobserv#493, and 0.19.3 the shared content-addressed BlobStore, cannobserv#475) with no extra on co-core (its [extract] parsers were unused, dropped by #142) and [bus,gcs] / [gcs] on the other two, the floor history that explains each raise, the explicit co-pypi [[tool.uv.index]] with a [tool.uv.sources] entry per co-core package (#183), the ruff rule set and its skills-vendor exclusion, the ty exclusion, the replicator-worker console script, pytest configuration (asyncio auto mode, the integration and gcs markers both deselected by default, timeout) and the 80% coverage gate. The [build-system] uv_build bound is one minor (>=0.13.0,<0.14 since #195), mirrored by ci.yml's setup-uv version: inputs." }, { "name": "release-deploy-hooks", diff --git a/AGENTS.md b/AGENTS.md index 7599c339..e8f5b20f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -26,7 +26,7 @@ Override vendored `brainstorming`'s defaults: Python ≥3.12, uv, pytest, ruff. `ty` (`uv run ty check`) is a **non-gating** type checker — no pre-commit or CI gate. -**co-core comes from the private co-pypi index, not PyPI.** `uv lock` and a cold `uv sync` need its token: `bash scripts/co-pypi.sh uv …`, never the writer's ADC. Pin the current minor — `>=0.46.0,<0.47` — and raise the **patch** floor with every co-core feature the code starts depending on. Both, and each skew so far: [docs/DEPENDENCIES.md](docs/DEPENDENCIES.md). +**co-core comes from the private co-pypi index, not PyPI.** `uv lock` and a cold `uv sync` need its token: `bash scripts/co-pypi.sh uv …`, never the writer's ADC. Pin the current minor — `>=0.48.0,<0.49` — and raise the **patch** floor with every co-core feature the code starts depending on. Both, and each skew so far: [docs/DEPENDENCIES.md](docs/DEPENDENCIES.md). ## Code Exploration Policy diff --git a/docs/DEPENDENCIES.md b/docs/DEPENDENCIES.md index 30dbf27b..33d9c420 100644 --- a/docs/DEPENDENCIES.md +++ b/docs/DEPENDENCIES.md @@ -93,11 +93,11 @@ fetcher or `uv lock` asks the index. ## The co-core pin, and why the patch floor is load-bearing -Pin the current minor — `>=0.46.0,<0.47`, on all three. The **patch** floor is load-bearing, not tidiness: the change-bus payloads are `extra="ignore"`, so on an older wheel a model constructed with fields it does not have yet succeeds and silently discards them. Raise the floor with every co-core feature the code starts depending on, or a version skew publishes facts that look right and carry nothing (#10). Both floors since fail *loudly* instead — a ValidationError at construction (0.8.0 requires `info_source_id` on all three fetch payloads, #19/#28) or an ImportError at load, never reaching a running worker (0.9.4 cuts the replicate contracts, #29; 0.19.3 ships the shared `BlobStore`, #114; 0.19.6 cuts the persist contract, #114 step 6). +Pin the current minor — `>=0.48.0,<0.49`, on all three. The **patch** floor is load-bearing, not tidiness: the change-bus payloads are `extra="ignore"`, so on an older wheel a model constructed with fields it does not have yet succeeds and silently discards them. Raise the floor with every co-core feature the code starts depending on, or a version skew publishes facts that look right and carry nothing (#10). Both floors since fail *loudly* instead — a ValidationError at construction (0.8.0 requires `info_source_id` on all three fetch payloads, #19/#28) or an ImportError at load, never reaching a running worker (0.9.4 cuts the replicate contracts, #29; 0.19.3 ships the shared `BlobStore`, #114; 0.19.6 cuts the persist contract, #114 step 6). **The 0.10 → 0.13 jump (#77) was the first departure from "pin the current minor", and what justified it is evidence rather than judgement.** The hazard that rule guards is payload fields moving under `extra="ignore"`; every module this service imports proved byte-identical between the two wheels — `pure/models/changes.py`, `pure/adapters/bus/{envelope,exceptions}.py`, `effects/{bus,fetch,gcs}.py`, `pure/util/{hashing,gcs}.py`, and all of `co_core_aio` bar its `__version__`. Only `streams.py` gained anything (`group_name`, `stream_kind` — cannobserv#384), and Replicator imports no `co_v1` adapter, which is where 0.13.2's other changes landed. That `diff -rq` of both wheels from the then-wheelhouse took a minute and turned a deferred change into a safe one. -**Diff the import closure before every pin move**, a single minor included: #136 needed it for one. The version distance is not the risk, the moved surface is, and the import lines are not the surface. At 0.19 → 0.36 (#140), `changes.py`'s import of `extract.canonical` brought in the `pure/extract` package, which had changed (cannobserv#523), and no import line in Replicator names it. `scripts/co_core_closure_diff.py OLD NEW` (#145) walks the closure from `src/` and `scripts/` through all three wheels at each version, fetched first ([Moving the pin](#moving-the-pin)). It prints the counts, a verdict per file that isn't identical, the Requires-Dist delta and the closure's third-party imports, and `--diff` adds each changed file's code diff. Paste the report into the pin comment and write the reasons around it by hand. `version-only` and `docstrings-only` need no reading. `changed` does, a model under `extra="ignore"` above all. `added` and `removed` are modules joining or leaving the closure. An **Unresolved imports** line names a module that is imported but isn't in the wheel, which fails at import. A **Not parsed** line names a file whose imports the walk couldn't follow. Each prints only when there's something to list. The walk follows `TYPE_CHECKING` imports and lists dynamic ones without following them. At 0.46.1 that's co-core-sync's two lazy `__getattr__` sites in `drivers/` and `drivers/blobstore/`. Both are expected, because each target is named again under `TYPE_CHECKING`. A new site whose targets aren't named there is a gap to read by hand. Flags: `--root`, `--package`, `--wheels` (required); the defaults are this repo's. +**Diff the import closure before every pin move**, a single minor included: #136 needed it for one. The version distance is not the risk, the moved surface is, and the import lines are not the surface. At 0.19 → 0.36 (#140), `changes.py`'s import of `extract.canonical` brought in the `pure/extract` package, which had changed (cannobserv#523), and no import line in Replicator names it. `scripts/co_core_closure_diff.py OLD NEW` (#145) walks the closure from `src/` and `scripts/` through all three wheels at each version, fetched first ([Moving the pin](#moving-the-pin)). It prints the counts, a verdict per file that isn't identical, the Requires-Dist delta and the closure's third-party imports, and `--diff` adds each changed file's code diff. Paste the report into the pin comment and write the reasons around it by hand. `version-only` and `docstrings-only` need no reading. `changed` does, a model under `extra="ignore"` above all. `added` and `removed` are modules joining or leaving the closure. An **Unresolved imports** line names a module that is imported but isn't in the wheel, which fails at import. A **Not parsed** line names a file whose imports the walk couldn't follow. Each prints only when there's something to list. The walk follows `TYPE_CHECKING` imports and lists dynamic ones without following them. At 0.48.2 that's co-core-sync's two lazy `__getattr__` sites in `drivers/` and `drivers/blobstore/`. Both are expected, because each target is named again under `TYPE_CHECKING`. A new site whose targets aren't named there is a gap to read by hand. Flags: `--root`, `--package`, `--wheels` (required); the defaults are this repo's. ## The build backend's bound, and CI's uv From 096afd362d605497b52ef9a9f06245ecb3e488db Mon Sep 17 00:00:00 2001 From: gregoryfoster Date: Sun, 15 Nov 2026 20:16:32 +0000 Subject: [PATCH 3/3] =?UTF-8?q?#206=20docs:=20CR=201=20=E2=80=94=20the=20t?= =?UTF-8?q?wo=20changed=20Drive=20modules=20cannot=20load=20here,=20measur?= =?UTF-8?q?ed?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- pyproject.toml | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/pyproject.toml b/pyproject.toml index 113f2607..06ee88eb 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -59,6 +59,13 @@ dependencies = [ # `delete_if_present`, which maps a 404 to `ALREADY_ABSENT` (0.48.2, # cannobserv#692). # + # Neither can load here, which settles it beyond the provider list: the + # closure reaches them only through `drivers/__init__.py`'s `TYPE_CHECKING` + # names and lazy `__getattr__`, importing `src.worker.main` and + # `src.storage.local_store` loads neither, and `drivers/gdrive.py` imports + # `googleapiclient` at module top, which isn't installed (no `[gdrive]` + # extra; not in `uv.lock`) [measured, #206 CR 1]. + # # The closure is the same with `tests/` as a root, and the dynamic imports # are the same two as at 0.46.1. Outside the closure, 0.47 and 0.48 changed # co/v1's `exceptions.py` and `urls.py`, the transcript models,