worktree-controller 1.32.13__tar.gz → 1.32.15__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (79) hide show
  1. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/PKG-INFO +5 -5
  2. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/README.md +4 -4
  3. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/pyproject.toml +1 -1
  4. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/pyproject.toml.orig +1 -1
  5. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/__init__.py +1 -1
  6. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/controller.py +12 -1
  7. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/lifecycle.py +10 -6
  8. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/tool_cli_contract.json +1 -1
  9. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/tool_cli_contract.json +1 -1
  10. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/LICENSE +0 -0
  11. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/docs/architecture.md +0 -0
  12. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/docs/client-integration.md +0 -0
  13. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/docs/daily-workflow.md +0 -0
  14. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/docs/first-change.md +0 -0
  15. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/docs/getting-started.md +0 -0
  16. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/docs/integration-boundaries.md +0 -0
  17. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/docs/operations.md +0 -0
  18. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/docs/publishing.md +0 -0
  19. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/docs/reference.md +0 -0
  20. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/docs/roadmap.md +0 -0
  21. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/docs/scope.md +0 -0
  22. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/examples/change_task.py +0 -0
  23. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/examples/client_continuation.py +0 -0
  24. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/examples/quickstart.py +0 -0
  25. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/activation_layout.py +0 -0
  26. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/branch_retirement.py +0 -0
  27. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/canonical_refresh.py +0 -0
  28. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/canonical_transition.py +0 -0
  29. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/cleanup_attempts.py +0 -0
  30. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/cleanup_evidence.py +0 -0
  31. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/cleanup_recovery.py +0 -0
  32. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/cli.py +0 -0
  33. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/convergence.py +0 -0
  34. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/delivered_closeout.py +0 -0
  35. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/disposable.py +0 -0
  36. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/environment.py +0 -0
  37. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/frozen_recovery.py +0 -0
  38. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/git_backend.py +0 -0
  39. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/governance.py +0 -0
  40. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/hardlinks.py +0 -0
  41. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/integration_cleanup.py +0 -0
  42. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/integration_conflict.py +0 -0
  43. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/integration_retry.py +0 -0
  44. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/keyed_document_scope.py +0 -0
  45. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/lifecycle_history.py +0 -0
  46. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/lifecycle_observation.py +0 -0
  47. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/metadata_codec.py +0 -0
  48. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/metadata_relocation.py +0 -0
  49. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/models.py +0 -0
  50. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/mount_diagnostics.py +0 -0
  51. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/multiple_cleanup_recovery.py +0 -0
  52. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/namespace_migration.py +0 -0
  53. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/native_session_recovery.py +0 -0
  54. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/owner_actions.py +0 -0
  55. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/policy.py +0 -0
  56. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/preservation.py +0 -0
  57. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/preserved_cleanup.py +0 -0
  58. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/publication_execution.py +0 -0
  59. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/reconciler.py +0 -0
  60. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/record_updates.py +0 -0
  61. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/recovery_guidance.py +0 -0
  62. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/registration_backfill.py +0 -0
  63. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/registration_prune.py +0 -0
  64. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/release_intents.py +0 -0
  65. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/rendering.py +0 -0
  66. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/resource_admission.py +0 -0
  67. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/retirement_adapters.py +0 -0
  68. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/retirement_execution.py +0 -0
  69. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/semantics.py +0 -0
  70. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/session.py +0 -0
  71. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/session_admission.py +0 -0
  72. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/source_cleanup.py +0 -0
  73. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/source_preservation.py +0 -0
  74. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/source_recovery.py +0 -0
  75. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/store.py +0 -0
  76. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/task_workflow.py +0 -0
  77. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/transaction_scope.py +0 -0
  78. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/writer_lease.py +0 -0
  79. {worktree_controller-1.32.13 → worktree_controller-1.32.15}/src/worktree_controller/writer_session.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: worktree-controller
3
- Version: 1.32.13
3
+ Version: 1.32.15
4
4
  Summary: Govern Git worktree budgets, authority, ownership, and lifecycle
5
5
  License-Expression: Apache-2.0
6
6
  License-File: LICENSE
@@ -23,7 +23,7 @@ It checks repository policy before allocating a worktree, grants writing authori
23
23
  process, and records handoff, integration, recovery and release evidence. Git remains the source
24
24
  of truth for files, branches, commits and registered worktrees.
25
25
 
26
- **Current release: 1.32.13 · Linux · Python 3.12 · Apache-2.0**
26
+ **Current release: 1.32.14 · Linux · Python 3.12 · Apache-2.0**
27
27
 
28
28
  ## Install
29
29
 
@@ -32,7 +32,7 @@ Use a virtual environment in a new directory:
32
32
  ```bash
33
33
  python3.12 -m venv .venv
34
34
  . .venv/bin/activate
35
- python -m pip install worktree-controller==1.32.13
35
+ python -m pip install worktree-controller==1.32.14
36
36
  worktree-controller --version
37
37
  worktree-controller capabilities --json
38
38
  ```
@@ -41,7 +41,7 @@ WC requires Git and readable Linux `/proc`. Other operating systems and Python v
41
41
  supported by this release. Its one runtime dependency is `websockets>=15,<16`.
42
42
  On Ubuntu, if creating the environment reports that `ensurepip` is unavailable, install the
43
43
  distribution's `python3.12-venv` package first (for example, `sudo apt install python3.12-venv`).
44
- Software version 1.32.13 uses CLI contract **61** and storage layout **5**.
44
+ Software version 1.32.14 uses CLI contract **61** and storage layout **5**.
45
45
 
46
46
  ## Try it in a disposable repository
47
47
 
@@ -50,7 +50,7 @@ With the environment above active:
50
50
  ```bash
51
51
  git clone https://github.com/xuanheng-tech/worktree-controller.git wc
52
52
  cd wc
53
- git checkout v1.32.13
53
+ git checkout v1.32.14
54
54
  python examples/quickstart.py --workspace "$HOME/wc-first-run"
55
55
  ```
56
56
 
@@ -6,7 +6,7 @@ It checks repository policy before allocating a worktree, grants writing authori
6
6
  process, and records handoff, integration, recovery and release evidence. Git remains the source
7
7
  of truth for files, branches, commits and registered worktrees.
8
8
 
9
- **Current release: 1.32.13 · Linux · Python 3.12 · Apache-2.0**
9
+ **Current release: 1.32.14 · Linux · Python 3.12 · Apache-2.0**
10
10
 
11
11
  ## Install
12
12
 
@@ -15,7 +15,7 @@ Use a virtual environment in a new directory:
15
15
  ```bash
16
16
  python3.12 -m venv .venv
17
17
  . .venv/bin/activate
18
- python -m pip install worktree-controller==1.32.13
18
+ python -m pip install worktree-controller==1.32.14
19
19
  worktree-controller --version
20
20
  worktree-controller capabilities --json
21
21
  ```
@@ -24,7 +24,7 @@ WC requires Git and readable Linux `/proc`. Other operating systems and Python v
24
24
  supported by this release. Its one runtime dependency is `websockets>=15,<16`.
25
25
  On Ubuntu, if creating the environment reports that `ensurepip` is unavailable, install the
26
26
  distribution's `python3.12-venv` package first (for example, `sudo apt install python3.12-venv`).
27
- Software version 1.32.13 uses CLI contract **61** and storage layout **5**.
27
+ Software version 1.32.14 uses CLI contract **61** and storage layout **5**.
28
28
 
29
29
  ## Try it in a disposable repository
30
30
 
@@ -33,7 +33,7 @@ With the environment above active:
33
33
  ```bash
34
34
  git clone https://github.com/xuanheng-tech/worktree-controller.git wc
35
35
  cd wc
36
- git checkout v1.32.13
36
+ git checkout v1.32.14
37
37
  python examples/quickstart.py --workspace "$HOME/wc-first-run"
38
38
  ```
39
39
 
@@ -4,7 +4,7 @@ build-backend = "uv_build"
4
4
 
5
5
  [project]
6
6
  name = "worktree-controller"
7
- version = "1.32.13"
7
+ version = "1.32.15"
8
8
  description = "Govern Git worktree budgets, authority, ownership, and lifecycle"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.12,<3.13"
@@ -4,7 +4,7 @@ build-backend = "uv_build"
4
4
 
5
5
  [project]
6
6
  name = "worktree-controller"
7
- version = "1.32.13"
7
+ version = "1.32.15"
8
8
  description = "Govern Git worktree budgets, authority, ownership, and lifecycle"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.12,<3.13"
@@ -1,3 +1,3 @@
1
1
  """Worktree lifecycle controller."""
2
2
 
3
- __version__ = "1.32.13"
3
+ __version__ = "1.32.15"
@@ -723,6 +723,17 @@ def _metadata_warnings(
723
723
 
724
724
 
725
725
  def status(repository_path: Path, *, namespace_pid: int | None = None) -> dict[str, Any]:
726
+ return status_observation(repository_path, namespace_pid=namespace_pid)[0]
727
+
728
+
729
+ def status_observation(
730
+ repository_path: Path, *, namespace_pid: int | None = None
731
+ ) -> tuple[dict[str, Any], MetadataSnapshot]:
732
+ """Return status and its validated metadata for one query.
733
+
734
+ Callers must not retain this observation across requests or use it to
735
+ authorize a mutation, which must recheck under its own lock.
736
+ """
726
737
  result = envelope("status")
727
738
  repository = inventory(repository_path)
728
739
  diagnostics = diagnose_mounts(repository, namespace_pid=namespace_pid)
@@ -745,7 +756,7 @@ def status(repository_path: Path, *, namespace_pid: int | None = None) -> dict[s
745
756
  + _metadata_warnings(repository, policy, snapshot)
746
757
  + (_lock_warnings(store) if diagnosis["code"] == "HEALTHY" else [])
747
758
  )
748
- return result
759
+ return result, snapshot
749
760
 
750
761
 
751
762
  def _resolve_target(
@@ -16,7 +16,7 @@ from datetime import datetime, timedelta
16
16
  from pathlib import Path, PurePosixPath
17
17
  from typing import Any
18
18
 
19
- from .controller import _warning, envelope, plan, status
19
+ from .controller import _warning, envelope, plan, status, status_observation
20
20
  from .disposable import CONTRACT as TYPED_RESOURCE_CONTRACT
21
21
  from .disposable import classify_resources, delete_typed_resource, resource_evidence
22
22
  from .environment import (
@@ -43,6 +43,7 @@ from .git_backend import (
43
43
  path_is_ignored,
44
44
  public_refs,
45
45
  resolve_commit,
46
+ resolve_repository,
46
47
  tracked_paths,
47
48
  update_branch_ref,
48
49
  validate_branch_name,
@@ -544,13 +545,11 @@ def _intent_payload(intent: IntegrationIntent) -> dict[str, Any]:
544
545
 
545
546
 
546
547
  def integration_queue(repository_path: Path) -> dict[str, Any]:
547
- repository = inventory(repository_path)
548
- snapshot = MetadataStore(repository.common_dir).load()
548
+ payload, snapshot = status_observation(repository_path)
549
549
  intents = sorted(
550
550
  snapshot.integration_intents.values(),
551
551
  key=_intent_order,
552
552
  )
553
- payload = status(repository_path)
554
553
  payload["command"] = "integration-queue"
555
554
  payload["decision"] = {
556
555
  "code": "INTEGRATION_QUEUE_STATUS",
@@ -571,8 +570,8 @@ def integration_queue(repository_path: Path) -> dict[str, Any]:
571
570
 
572
571
 
573
572
  def lifecycle_events(repository_path: Path, *, consumer: str) -> dict[str, Any]:
574
- repository = inventory(repository_path)
575
- store = MetadataStore(repository.common_dir)
573
+ _requested, common_dir = resolve_repository(repository_path)
574
+ store = MetadataStore(common_dir)
576
575
  events = store.list_lifecycle_events(consumer)
577
576
  payload = status(repository_path)
578
577
  payload["command"] = "lifecycle-events"
@@ -1772,6 +1771,11 @@ def _acquire_once(
1772
1771
  target_path = (target or _default_target(repository_initial, task_key)).expanduser().absolute()
1773
1772
  if target_path.exists() or target_path.is_symlink():
1774
1773
  raise ControllerError("TARGET_EXISTS", f"target path already exists: {target_path}")
1774
+ # Refusing an unconfigured repository must not create a governance marker.
1775
+ # The authoritative check is repeated under the lock in
1776
+ # _assert_allocation_allowed to catch policy changes during admission.
1777
+ if not load_policy(repository_initial.canonical_path).present:
1778
+ raise ControllerError("BLOCK_DRIFT", "repository policy is missing")
1775
1779
  store = MetadataStore(repository_initial.common_dir)
1776
1780
  transaction_id = str(uuid.uuid4())
1777
1781
  transaction_created = now_iso()
@@ -1071,7 +1071,7 @@
1071
1071
  "session_launcher_entrypoint": "worktree-session",
1072
1072
  "session_entrypoint": "worktree-session-end",
1073
1073
  "tool_name": "worktree-controller",
1074
- "tool_version": "1.32.13",
1074
+ "tool_version": "1.32.15",
1075
1075
  "delivered_closeout_version": 1,
1076
1076
  "retained_archive_version": 1,
1077
1077
  "retention_convergence_version": 2,
@@ -1071,7 +1071,7 @@
1071
1071
  "session_launcher_entrypoint": "worktree-session",
1072
1072
  "session_entrypoint": "worktree-session-end",
1073
1073
  "tool_name": "worktree-controller",
1074
- "tool_version": "1.32.13",
1074
+ "tool_version": "1.32.15",
1075
1075
  "delivered_closeout_version": 1,
1076
1076
  "retained_archive_version": 1,
1077
1077
  "retention_convergence_version": 2,