worktree-controller 1.32.0__tar.gz → 1.32.1__tar.gz

{worktree_controller-1.32.0 → worktree_controller-1.32.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: worktree-controller
-Version: 1.32.0
+Version: 1.32.1
 Summary: Govern Git worktree budgets, authority, ownership, and lifecycle
 License-Expression: Apache-2.0
 License-File: LICENSE

{worktree_controller-1.32.0 → worktree_controller-1.32.1}/docs/client-integration.md

@@ -105,6 +105,33 @@ This demonstrates two CLI consumers, not actual invocation or discovery by two A
 Vendor-specific discovery and live-client use require their own observed acceptance, as described
 in [checks and deployment evidence](operations.md#checks-and-deployment).
 
+## Accept a real AI client
+
+Accept a client by observing it use the installed WC interface during a real task,
+including a pause and continuation in a later native session. Running the offline
+protocol example checks the CLI workflow; it does not establish that an AI client
+discovers or invokes WC correctly. Keep the actual session identities and checkpoint
+evidence with the acceptance result, and limit claims to the client and workflow observed.
+
+Use the separate `worktree-session-end` executable for session closeout. Keep a practical
+evidence checklist:
+
+- Capture actual native-client WC invocations, raw results and exit codes, client version,
+  and distinct native session/run/holder identities before and after interruption.
+- Verify the raw checkpoint digest and unchanged Task/authority/owner, allocation, path,
+  branch, HEAD and scope; compare exact file SHA256 values before the next session edits.
+- Resume the original Task, acquire a fresh live writer, and pass its check and write guard;
+  record refusal of the previous identity without reviving it or bypassing a refusal.
+- While leases are recorded, check and end with the exact client/session/run/holder selector.
+  Include every allocation via `--expected-allocation-id`; retain every per-tree decision
+  and require `summary.terminal_complete` with `--require-complete` before claiming closeout.
+- Follow the [first-change workflow](first-change.md) to finish; keep separate Finalizer,
+  handoff, integration/publication and release evidence before claiming task completion.
+  A retained checkpoint preserves unfinished work; it is not delivery evidence.
+
+One tested vendor does not prove another vendor's discovery or invocation of WC; accept each
+client and workflow using its own observed evidence.
+
 ## Upgrade an existing managed installation
 
 A public package installation in a new environment is separate from activation of a shared

{worktree_controller-1.32.0 → worktree_controller-1.32.1}/docs/reference.md

@@ -1478,9 +1478,10 @@ checkout rejects feature writes. `READY_TO_PUBLISH` is write-fenced until explic
 out-of-band HEAD, content, record, or binding drift makes old evidence unusable.
 
 The bounded `integration-keyed-document-scope/v1` refinement applies only when the entire
-overlap is the exact `docs/handbook/business-progress.json` path. Every pair of frozen source
-commits must have one non-ancestor merge base and the same committed `.gitattributes` declaring
-`merge=qp-handbook-progress`. QP schema 2 records are compared by whole `tasks.authority_key`
+overlap is exactly `docs/nexus/business-progress.json` with `merge=qp-nexus-progress`, or
+the historical `docs/handbook/business-progress.json` with `merge=qp-handbook-progress`.
+Cross-path moves retain the ordinary file fence. Every pair of frozen source commits must have
+one non-ancestor merge base and the same committed `.gitattributes` declaring the matching profile. QP schema 2 records are compared by whole `tasks.authority_key`
 or `development_lines/modules/decisions.id`, including additions and deletions. All changed key
 sets must be disjoint. Metadata, schema, ordering, duplicate keys, missing/oversized/non-regular
 blobs, unknown evidence, broad paths and code overlaps keep the ordinary file fence. Explicit

{worktree_controller-1.32.0 → worktree_controller-1.32.1}/pyproject.toml

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

{worktree_controller-1.32.0 → worktree_controller-1.32.1}/pyproject.toml.orig

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

{worktree_controller-1.32.0 → worktree_controller-1.32.1}/src/worktree_controller/__init__.py

@@ -1,3 +1,3 @@
 """Worktree lifecycle controller."""
 
-__version__ = "1.32.0"
+__version__ = "1.32.1"

{worktree_controller-1.32.0 → worktree_controller-1.32.1}/src/worktree_controller/keyed_document_scope.py

@@ -1,4 +1,4 @@
-"""Prove independent Handbook records from frozen Git objects, never working files.
+"""Prove independent Nexus records from frozen Git objects, never working files.
 
 This refines only the known keyed-document overlap. It does not choose merge results,
 change declared ownership, or replace candidate validation and main publication CAS.
@@ -13,8 +13,11 @@ from pathlib import Path
 from .git_backend import _git
 from .models import ControllerError
 
-PROGRESS_PATH = "docs/handbook/business-progress.json"
-_ATTRIBUTE = f"{PROGRESS_PATH} merge=qp-handbook-progress"
+PROGRESS_PATH = "docs/nexus/business-progress.json"
+PROGRESS_PROFILES = {
+    PROGRESS_PATH: "qp-nexus-progress",
+    "docs/handbook/business-progress.json": "qp-handbook-progress",
+}
 _COLLECTIONS = {
     "tasks": "authority_key",
     "development_lines": "id",
@@ -105,11 +108,11 @@ def _blob(repo: Path, commit: str, path: str, *, limit: int = _MAX_BYTES) -> byt
     return raw
 
 
-def _progress(repo: Path, commit: str) -> tuple[str, bytes]:
+def _progress(repo: Path, commit: str, path: str) -> tuple[str, bytes]:
     attributes = _blob(repo, commit, ".gitattributes", limit=64 * 1024).decode("utf-8")
-    if _ATTRIBUTE not in attributes.splitlines():
+    if f"{path} merge={PROGRESS_PROFILES[path]}" not in attributes.splitlines():
         raise ValueError("keyed merge protocol is not declared")
-    return attributes, _blob(repo, commit, PROGRESS_PATH)
+    return attributes, _blob(repo, commit, path)
 
 
 def independent_progress_scopes(
@@ -133,7 +136,10 @@ def independent_progress_scopes(
         for right in right_paths
         if left == right or left.startswith(right + "/") or right.startswith(left + "/")
     }
-    if overlaps != {(PROGRESS_PATH, PROGRESS_PATH)}:
+    if len(overlaps) != 1:
+        return False
+    path, other = next(iter(overlaps))
+    if path != other or path not in PROGRESS_PROFILES:
         return False
     if len(left_sources) > 8 or len(right_sources) > 8:
         return False
@@ -148,9 +154,9 @@ def independent_progress_scopes(
                 base = bases[0].decode("ascii")
                 if not _OID.fullmatch(base) or base in (left, right):
                     return False
-                attributes, original = _progress(repo, base)
-                left_attributes, left_document = _progress(repo, left)
-                right_attributes, right_document = _progress(repo, right)
+                attributes, original = _progress(repo, base, path)
+                left_attributes, left_document = _progress(repo, left, path)
+                right_attributes, right_document = _progress(repo, right, path)
                 if attributes != left_attributes or attributes != right_attributes:
                     return False
                 left_keys = _changed_keys(original, left_document)

{worktree_controller-1.32.0 → worktree_controller-1.32.1}/src/worktree_controller/tool_cli_contract.json

@@ -468,7 +468,7 @@
     "contract": "integration-keyed-document-scope/v1",
     "entry_points": "normal enqueue, claim, reconcile and retry scope checks",
     "identity": "original frozen source commits, scopes and queue sequence; no mutable checkout evidence",
-    "supported_document": "docs/handbook/business-progress.json, quant-platform schema 2, unchanged committed qp-handbook-progress merge profile",
+    "supported_document": "docs/nexus/business-progress.json with qp-nexus-progress, or historical docs/handbook/business-progress.json with qp-handbook-progress; quant-platform schema 2, unchanged committed merge profile",
     "proof": "unique non-ancestor merge base for every frozen source pair; whole-record changed keys must be disjoint across tasks.authority_key and development_lines/modules/decisions.id",
     "bounds": "at most 8 sources per intent, 2 MiB regular document blobs, 64 KiB attributes blobs",
     "fail_closed": "shared record, metadata/schema/order changes, broad paths, code overlap, duplicate keys, invalid/missing/oversized Git evidence, ancestry dependency, explicit prerequisite or earlier publishing/recovery/attention state",
@@ -1071,7 +1071,7 @@
   "session_launcher_entrypoint": "worktree-session",
   "session_entrypoint": "worktree-session-end",
   "tool_name": "worktree-controller",
-  "tool_version": "1.32.0",
+  "tool_version": "1.32.1",
   "delivered_closeout_version": 1,
   "retained_archive_version": 1,
   "retention_convergence_version": 2,

{worktree_controller-1.32.0 → worktree_controller-1.32.1}/tool_cli_contract.json

@@ -468,7 +468,7 @@
     "contract": "integration-keyed-document-scope/v1",
     "entry_points": "normal enqueue, claim, reconcile and retry scope checks",
     "identity": "original frozen source commits, scopes and queue sequence; no mutable checkout evidence",
-    "supported_document": "docs/handbook/business-progress.json, quant-platform schema 2, unchanged committed qp-handbook-progress merge profile",
+    "supported_document": "docs/nexus/business-progress.json with qp-nexus-progress, or historical docs/handbook/business-progress.json with qp-handbook-progress; quant-platform schema 2, unchanged committed merge profile",
     "proof": "unique non-ancestor merge base for every frozen source pair; whole-record changed keys must be disjoint across tasks.authority_key and development_lines/modules/decisions.id",
     "bounds": "at most 8 sources per intent, 2 MiB regular document blobs, 64 KiB attributes blobs",
     "fail_closed": "shared record, metadata/schema/order changes, broad paths, code overlap, duplicate keys, invalid/missing/oversized Git evidence, ancestry dependency, explicit prerequisite or earlier publishing/recovery/attention state",
@@ -1071,7 +1071,7 @@
   "session_launcher_entrypoint": "worktree-session",
   "session_entrypoint": "worktree-session-end",
   "tool_name": "worktree-controller",
-  "tool_version": "1.32.0",
+  "tool_version": "1.32.1",
   "delivered_closeout_version": 1,
   "retained_archive_version": 1,
   "retention_convergence_version": 2,