worktree-controller 1.32.4__tar.gz → 1.32.5__tar.gz

{worktree_controller-1.32.4 → worktree_controller-1.32.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: worktree-controller
-Version: 1.32.4
+Version: 1.32.5
 Summary: Govern Git worktree budgets, authority, ownership, and lifecycle
 License-Expression: Apache-2.0
 License-File: LICENSE
@@ -23,7 +23,7 @@ It checks repository policy before allocating a worktree, grants writing authori
 process, and records handoff, integration, recovery and release evidence. Git remains the source
 of truth for files, branches, commits and registered worktrees.
 
-**Current release: 1.32.2 · Linux · Python 3.12 · Apache-2.0**
+**Current release: 1.32.5 · Linux · Python 3.12 · Apache-2.0**
 
 ## Install
 
@@ -32,7 +32,7 @@ Use a virtual environment in a new directory:
 ```bash
 python3.12 -m venv .venv
 . .venv/bin/activate
-python -m pip install worktree-controller==1.32.2
+python -m pip install worktree-controller==1.32.5
 worktree-controller --version
 worktree-controller capabilities --json
 ```
@@ -41,7 +41,7 @@ WC requires Git and readable Linux `/proc`. Other operating systems and Python v
 supported by this release. Its one runtime dependency is `websockets>=15,<16`.
 On Ubuntu, if creating the environment reports that `ensurepip` is unavailable, install the
 distribution's `python3.12-venv` package first (for example, `sudo apt install python3.12-venv`).
-Software version 1.32.2 uses CLI contract **61** and storage layout **5**.
+Software version 1.32.5 uses CLI contract **61** and storage layout **5**.
 
 ## Try it in a disposable repository
 
@@ -50,7 +50,7 @@ With the environment above active:
 ```bash
 git clone https://github.com/xuanheng-tech/worktree-controller.git wc
 cd wc
-git checkout v1.32.2
+git checkout v1.32.5
 python examples/quickstart.py --workspace "$HOME/wc-first-run"
 ```
 

{worktree_controller-1.32.4 → worktree_controller-1.32.5}/README.md

@@ -6,7 +6,7 @@ It checks repository policy before allocating a worktree, grants writing authori
 process, and records handoff, integration, recovery and release evidence. Git remains the source
 of truth for files, branches, commits and registered worktrees.
 
-**Current release: 1.32.2 · Linux · Python 3.12 · Apache-2.0**
+**Current release: 1.32.5 · Linux · Python 3.12 · Apache-2.0**
 
 ## Install
 
@@ -15,7 +15,7 @@ Use a virtual environment in a new directory:
 ```bash
 python3.12 -m venv .venv
 . .venv/bin/activate
-python -m pip install worktree-controller==1.32.2
+python -m pip install worktree-controller==1.32.5
 worktree-controller --version
 worktree-controller capabilities --json
 ```
@@ -24,7 +24,7 @@ WC requires Git and readable Linux `/proc`. Other operating systems and Python v
 supported by this release. Its one runtime dependency is `websockets>=15,<16`.
 On Ubuntu, if creating the environment reports that `ensurepip` is unavailable, install the
 distribution's `python3.12-venv` package first (for example, `sudo apt install python3.12-venv`).
-Software version 1.32.2 uses CLI contract **61** and storage layout **5**.
+Software version 1.32.5 uses CLI contract **61** and storage layout **5**.
 
 ## Try it in a disposable repository
 
@@ -33,7 +33,7 @@ With the environment above active:
 ```bash
 git clone https://github.com/xuanheng-tech/worktree-controller.git wc
 cd wc
-git checkout v1.32.2
+git checkout v1.32.5
 python examples/quickstart.py --workspace "$HOME/wc-first-run"
 ```
 

{worktree_controller-1.32.4 → worktree_controller-1.32.5}/docs/architecture.md

@@ -83,3 +83,7 @@ mutation helpers, clock, lock scope, cancellation and history append unchanged.
 uses the same query directly; lifecycle retains its existing internal aliases. A changed HEAD
 or record version still renews immediately, and repeated unchanged expiries retain the existing
 one-day backoff cap. This extraction changes no CLI, capability or storage contract.
+
+Scope digest and overlap queries live in `semantics` alongside scope normalization. Integration
+retry calls these shared pure helpers directly; lifecycle retains compatibility aliases. Their
+serialization, empty-scope interpretation and parent/child path rules remain unchanged.

{worktree_controller-1.32.4 → worktree_controller-1.32.5}/docs/publishing.md

@@ -102,3 +102,16 @@ Receipts distinguish a read-only audit, `PUBLISHED_VERIFIED`, and `FRESH_INSTALL
 Skipped tests remain skipped. Local installation or activation of a maintainer's WC runtime is a
 separate operation; publishing a package does not update that runtime or authorize a production
 release in any repository governed by WC.
+
+## Publication visibility
+
+Successful writes can precede their visibility through GitHub or PyPI queries. After a successful
+create, upload or publish command, the publisher polls only the missing observation. All phases
+share one five-minute monotonic deadline, including draft, asset, PyPI and public-release visibility.
+Each network command retains its own timeout; an in-flight request can finish after that deadline.
+Metadata requests ask caches to revalidate. This does not guarantee immediate upstream visibility.
+
+Every poll rechecks the immutable tag and main containment; normal inventory and byte/hash checks
+remain active. Command errors, unknown assets, yanked files and identity/checksum drift stop
+immediately. Polls never repeat writes. If visibility still times out, the job fails and keeps the
+original bundle and current release. Audit destinations and rerun failed jobs in the same run as above.

{worktree_controller-1.32.4 → worktree_controller-1.32.5}/docs/roadmap.md

@@ -5,12 +5,12 @@ direction. Each stage needs its own tested deliverable; later ideas are not curr
 
 ## Current baseline
 
-WC 1.32.4 retains CLI contract 61 and storage layout 5. The scope and architecture documents
-are already on main. Two previous extractions reduced private cross-module imports from 93 to
-82; this batch moves pure release-intent selection/backoff queries into one module, reducing
-the baseline to 80. It retains lifecycle mutation helpers, clocks and internal aliases.
+WC 1.32.5 retains CLI contract 61 and storage layout 5. The scope and architecture documents
+are already on main. Previous extractions reduced private cross-module imports from 93 to
+82 and then 80. This batch moves pure scope hashing/overlap queries into `semantics`, reducing
+the baseline to 78. It retains lifecycle mutation helpers, clocks and internal aliases.
 
-GF 1.9.7 already consumes SR's public read API and WC's versioned publication/retirement
+GF 1.9.8 already consumes SR's public read API and WC's versioned publication/retirement
 protocols. CL 1.3.10 and SR 2.5.12 already use main on both hosting platforms. These completed
 items are not prerequisites still waiting to happen.
 
@@ -24,7 +24,7 @@ acceptance gates, and historical temporary-file impact. No historical evidence i
 | --- | --- | --- | --- |
 | Now: boundaries | Current protocol and consumer inventory, including legacy adapters | Named owner per interface, source references, explicit unknowns; no changes to supported commands | Conflicting evidence keeps the interface supported |
 | Now: WC structure | One cohesive pure release-intent query extraction | Full integration gate; existing renewal/cancellation/recovery behavior; CLI 61/storage 5 unchanged | Revert the isolated extraction if behavior differs |
-| Pilot: shared quality checks | Local release-tools candidate and CL integration packet with a full commit pin | Workflow lint, CL local quality check, then all supported Python versions on real hosted CI after publication | Restore the pinned original CL workflow; PyPI/Gitea flows remain owned by consumers |
+| Shared quality checks: delivered | CL/SR adopt release-tools with a reviewed full commit pin | Both hosted parallel pilots and final three-version checks passed; SR retains its package check | Restore the pinned original consumer workflow; PyPI/Gitea flows remain owned by consumers |
 | Next 2–6 weeks | Further WC extraction only where a shared responsibility is clear; measure maintenance burden and failures | One behavior-preserving batch at a time, consumer gates, shrinking private-import baseline | Keep injected clocks, transaction and crash hooks with their owner until an explicit migration is tested |
 | Following 6–12 weeks | Evaluate moving manifests, compatibility catalog and shared Skills from GF to a dedicated toolchain owner | Full ownership inventory, staged installer/migration, exactly one active writer, historical pin and rollback tests | No second simultaneous Skill authority; no ownership switch on file-copy evidence |
 | Following 3–6 months | Evaluate a staged GF Python core migration | Characterization of exit/status/ref effects, isolated old/new comparisons, interruption recovery and real consumer gates | No dual production writes; preserve scanner refusals and existing installation until replacement passes |
@@ -44,3 +44,8 @@ Do not introduce a shared runtime Python dependency into CL/SR, merge the tools,
 Python floor, move host-specific defaults without migration, or replace existing WC/GF protocols.
 GitHub-first release consolidation and a future toolchain repository remain design decisions,
 not permission to disable existing Gitea delivery or platform controls.
+
+This maintenance batch moves pure scope hashing and overlap queries to `semantics`, lowering
+the private-import baseline from 80 to 78. Publication metadata readback now shares a bounded
+visibility window; exact bytes, identities, failed-command outcomes and same-bundle recovery stay
+mandatory. CL/SR shared quality checks have passed their hosted parallel and final matrices.

{worktree_controller-1.32.4 → worktree_controller-1.32.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "worktree-controller"
-version = "1.32.4"
+version = "1.32.5"
 description = "Govern Git worktree budgets, authority, ownership, and lifecycle"
 readme = "README.md"
 requires-python = ">=3.12,<3.13"

{worktree_controller-1.32.4 → worktree_controller-1.32.5}/pyproject.toml.orig

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "worktree-controller"
-version = "1.32.4"
+version = "1.32.5"
 description = "Govern Git worktree budgets, authority, ownership, and lifecycle"
 readme = "README.md"
 requires-python = ">=3.12,<3.13"

{worktree_controller-1.32.4 → worktree_controller-1.32.5}/src/worktree_controller/__init__.py

@@ -1,3 +1,3 @@
 """Worktree lifecycle controller."""
 
-__version__ = "1.32.4"
+__version__ = "1.32.5"

{worktree_controller-1.32.4 → worktree_controller-1.32.5}/src/worktree_controller/integration_retry.py

@@ -17,6 +17,8 @@ from .semantics import (
     integration_intent_abandoned,
     integration_prerequisite,
     integration_queue_order,
+    scope_digest,
+    scopes_overlap,
     unallocated_integration_conflict,
 )
 from .store import MetadataStore
@@ -57,7 +59,7 @@ def _sources(
     *,
     require_idle: bool = True,
 ) -> dict[str, Any]:
-    from .lifecycle import _resolve_integration_sources, _scope_digest
+    from .lifecycle import _resolve_integration_sources
 
     observed = _resolve_integration_sources(
         repository,
@@ -74,7 +76,7 @@ def _sources(
         intent.source_finalizer_record_ids,
         intent.source_snapshot_ids,
     )
-    if observed != expected or _scope_digest(intent.scope_paths) != intent.scope_digest:
+    if observed != expected or scope_digest(intent.scope_paths) != intent.scope_digest:
         raise ControllerError("SOURCE_EVIDENCE_MISMATCH", "retry cannot replace source or scope")
     evidence = {}
     for allocation, branch, head in zip(
@@ -227,7 +229,6 @@ def _prerequisite(
     parent: IntegrationIntent,
     child: IntegrationIntent,
 ) -> dict[str, Any]:
-    from .lifecycle import _scopes_overlap
     from .semantics import effective_intent_state
 
     if (
@@ -258,7 +259,7 @@ def _prerequisite(
         and other.allocation_id is not None
         and effective_intent_state(snapshot, other) not in {"RELEASED", "ABANDONED"}
         and other.queue_sequence > parent.queue_sequence
-        and _scopes_overlap(other.scope_paths, child.scope_paths)
+        and scopes_overlap(other.scope_paths, child.scope_paths)
         for other in snapshot.integration_intents.values()
     ):
         raise ControllerError(

{worktree_controller-1.32.4 → worktree_controller-1.32.5}/src/worktree_controller/lifecycle.py

@@ -100,6 +100,8 @@ from .semantics import integration_reconciliation as _integration_reconciliation
 from .semantics import managed_record as _managed_record
 from .semantics import publication_receipt_lease_released as _publication_receipt_lease_released
 from .semantics import record_for as _record_for
+from .semantics import scope_digest as _scope_digest
+from .semantics import scopes_overlap as _scopes_overlap
 from .store import (
     INTEGRATION_INTENT_CONTRACT_VERSION,
     INTEGRATION_INTENT_SCHEMA_VERSION,
@@ -152,31 +154,12 @@ def _crash_point(name: str) -> None:
         os._exit(97)
 
 
-def _scope_digest(scope_paths: tuple[str, ...]) -> str:
-    encoded = json.dumps(list(scope_paths), ensure_ascii=True, separators=(",", ":"))
-    return hashlib.sha256(encoded.encode("utf-8")).hexdigest()
-
-
 def _intent_order(intent: IntegrationIntent) -> tuple[int, int | str, str]:
     if intent.queue_sequence > 0:
         return (1, intent.queue_sequence, intent.intent_id)
     return (0, intent.enqueued_at, intent.intent_id)
 
 
-def _scopes_overlap(left: tuple[str, ...], right: tuple[str, ...]) -> bool:
-    if not left or not right:
-        return True
-    for left_path in left:
-        for right_path in right:
-            if (
-                left_path == right_path
-                or left_path.startswith(f"{right_path}/")
-                or right_path.startswith(f"{left_path}/")
-            ):
-                return True
-    return False
-
-
 def _released_intent_evidence(
     snapshot: MetadataSnapshot,
     intent: IntegrationIntent,

{worktree_controller-1.32.4 → worktree_controller-1.32.5}/src/worktree_controller/semantics.py

@@ -2,6 +2,8 @@
 
 from __future__ import annotations
 
+import hashlib
+import json
 from dataclasses import replace
 from pathlib import Path, PurePosixPath
 from typing import Any
@@ -204,6 +206,25 @@ def integration_queue_order(
     return (0, anchor.enqueued_at, phase, intent.intent_id)
 
 
+def scope_digest(scope_paths: tuple[str, ...]) -> str:
+    encoded = json.dumps(list(scope_paths), ensure_ascii=True, separators=(",", ":"))
+    return hashlib.sha256(encoded.encode("utf-8")).hexdigest()
+
+
+def scopes_overlap(left: tuple[str, ...], right: tuple[str, ...]) -> bool:
+    if not left or not right:
+        return True
+    for left_path in left:
+        for right_path in right:
+            if (
+                left_path == right_path
+                or left_path.startswith(f"{right_path}/")
+                or right_path.startswith(f"{left_path}/")
+            ):
+                return True
+    return False
+
+
 def normalize_scope_paths(values: tuple[str, ...]) -> tuple[str, ...]:
     normalized: set[str] = set()
     for raw in values:

{worktree_controller-1.32.4 → worktree_controller-1.32.5/src/worktree_controller}/tool_cli_contract.json

@@ -1071,7 +1071,7 @@
   "session_launcher_entrypoint": "worktree-session",
   "session_entrypoint": "worktree-session-end",
   "tool_name": "worktree-controller",
-  "tool_version": "1.32.4",
+  "tool_version": "1.32.5",
   "delivered_closeout_version": 1,
   "retained_archive_version": 1,
   "retention_convergence_version": 2,

{worktree_controller-1.32.4/src/worktree_controller → worktree_controller-1.32.5}/tool_cli_contract.json

@@ -1071,7 +1071,7 @@
   "session_launcher_entrypoint": "worktree-session",
   "session_entrypoint": "worktree-session-end",
   "tool_name": "worktree-controller",
-  "tool_version": "1.32.4",
+  "tool_version": "1.32.5",
   "delivered_closeout_version": 1,
   "retained_archive_version": 1,
   "retention_convergence_version": 2,