worktree-controller 1.33.0__tar.gz → 1.34.0__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 (81) hide show
  1. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/PKG-INFO +1 -1
  2. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/docs/build-resources.md +7 -0
  3. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/pyproject.toml +1 -1
  4. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/pyproject.toml.orig +1 -1
  5. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/__init__.py +1 -1
  6. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/branch_retirement.py +143 -5
  7. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/build_resources.py +9 -2
  8. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/cli.py +1 -0
  9. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/integration_cleanup.py +2 -2
  10. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/tool_cli_contract.json +9 -1
  11. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/tool_cli_contract.json +9 -1
  12. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/LICENSE +0 -0
  13. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/README.md +0 -0
  14. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/docs/architecture.md +0 -0
  15. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/docs/client-integration.md +0 -0
  16. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/docs/daily-workflow.md +0 -0
  17. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/docs/first-change.md +0 -0
  18. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/docs/getting-started.md +0 -0
  19. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/docs/integration-boundaries.md +0 -0
  20. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/docs/operations.md +0 -0
  21. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/docs/publishing.md +0 -0
  22. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/docs/reference.md +0 -0
  23. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/docs/roadmap.md +0 -0
  24. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/docs/scope.md +0 -0
  25. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/examples/change_task.py +0 -0
  26. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/examples/client_continuation.py +0 -0
  27. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/examples/quickstart.py +0 -0
  28. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/activation_layout.py +0 -0
  29. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/canonical_refresh.py +0 -0
  30. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/canonical_transition.py +0 -0
  31. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/cleanup_attempts.py +0 -0
  32. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/cleanup_evidence.py +0 -0
  33. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/cleanup_recovery.py +0 -0
  34. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/controller.py +0 -0
  35. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/convergence.py +0 -0
  36. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/delivered_closeout.py +0 -0
  37. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/disposable.py +0 -0
  38. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/environment.py +0 -0
  39. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/frozen_recovery.py +0 -0
  40. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/git_backend.py +0 -0
  41. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/governance.py +0 -0
  42. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/hardlinks.py +0 -0
  43. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/integration_conflict.py +0 -0
  44. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/integration_retry.py +0 -0
  45. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/keyed_document_scope.py +0 -0
  46. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/lifecycle.py +0 -0
  47. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/lifecycle_history.py +0 -0
  48. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/lifecycle_observation.py +0 -0
  49. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/metadata_codec.py +0 -0
  50. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/metadata_relocation.py +0 -0
  51. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/models.py +0 -0
  52. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/mount_diagnostics.py +0 -0
  53. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/multiple_cleanup_recovery.py +0 -0
  54. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/namespace_migration.py +0 -0
  55. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/native_session_recovery.py +0 -0
  56. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/owner_actions.py +0 -0
  57. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/policy.py +0 -0
  58. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/preservation.py +0 -0
  59. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/preserved_cleanup.py +0 -0
  60. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/publication_execution.py +0 -0
  61. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/reconciler.py +0 -0
  62. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/record_updates.py +0 -0
  63. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/recovery_guidance.py +0 -0
  64. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/registration_backfill.py +0 -0
  65. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/registration_prune.py +0 -0
  66. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/release_intents.py +0 -0
  67. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/rendering.py +0 -0
  68. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/resource_admission.py +0 -0
  69. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/retirement_adapters.py +0 -0
  70. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/retirement_execution.py +0 -0
  71. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/semantics.py +0 -0
  72. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/session.py +0 -0
  73. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/session_admission.py +0 -0
  74. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/source_cleanup.py +0 -0
  75. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/source_preservation.py +0 -0
  76. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/source_recovery.py +0 -0
  77. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/store.py +0 -0
  78. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/task_workflow.py +0 -0
  79. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/transaction_scope.py +0 -0
  80. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/src/worktree_controller/writer_lease.py +0 -0
  81. {worktree_controller-1.33.0 → worktree_controller-1.34.0}/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.33.0
3
+ Version: 1.34.0
4
4
  Summary: Govern Git worktree budgets, authority, ownership, and lifecycle
5
5
  License-Expression: Apache-2.0
6
6
  License-File: LICENSE
@@ -61,6 +61,13 @@ the separate guarded release. Release keeps the retained branch and is not an
61
61
  integration or publication receipt. The QP maintenance owner performs the live
62
62
  single-checkout canary and decides whether to proceed with its exact batch.
63
63
 
64
+ From 1.33.1, registration uses the same `allocation-runtime-authority/v1` runtime
65
+ classification as typed cleanup. Its response includes fresh `runtime_evidence`
66
+ and `HOST_VISIBILITY_GAP` warnings for unassociated host permission gaps. This is
67
+ not proof of host-wide absence of references. Managed or observed references and
68
+ managed/scan uncertainties still block; apply reobserves runtime even after a
69
+ successful plan. It does not run the additional legacy host-wide strict scan.
70
+
64
71
  ## Integrity and recovery
65
72
 
66
73
  Cleanup rechecks the registered input identities, all resource content and the
@@ -4,7 +4,7 @@ build-backend = "uv_build"
4
4
 
5
5
  [project]
6
6
  name = "worktree-controller"
7
- version = "1.33.0"
7
+ version = "1.34.0"
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.33.0"
7
+ version = "1.34.0"
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.33.0"
3
+ __version__ = "1.34.0"
@@ -119,6 +119,8 @@ def _plan_identity(plan: Mapping[str, Any]) -> dict[str, Any]:
119
119
  identity = {field: plan.get(field) for field in fields}
120
120
  if "canonical_transition_evidence" in plan:
121
121
  identity["canonical_transition_evidence"] = plan["canonical_transition_evidence"]
122
+ if "aborted_ancestor_evidence" in plan:
123
+ identity["aborted_ancestor_evidence"] = plan["aborted_ancestor_evidence"]
122
124
  return identity
123
125
 
124
126
 
@@ -392,6 +394,122 @@ def _integration_publication_verified(
392
394
  )
393
395
 
394
396
 
397
+ def _aborted_ancestor_evidence(
398
+ store: MetadataStore,
399
+ snapshot: MetadataSnapshot,
400
+ record: MetadataRecord,
401
+ release_receipt: ReleaseReceipt,
402
+ *,
403
+ expected_oid: str,
404
+ ) -> dict[str, str] | None:
405
+ """Return pinned abort proof for an abandoned ancestor, or None.
406
+
407
+ None keeps the publication blocker. This does not accept cherry-equivalence,
408
+ a retryable abort, or a branch whose commits are not already in the
409
+ publication ref.
410
+ """
411
+
412
+ if (
413
+ record.role != "integration"
414
+ or record.lifecycle != "RELEASED"
415
+ or record.task_commit != expected_oid
416
+ or release_receipt.allocation_id != record.allocation_id
417
+ or release_receipt.released_head != expected_oid
418
+ ):
419
+ return None
420
+ releases = [
421
+ item for item in snapshot.release_receipts.values()
422
+ if item.allocation_id == record.allocation_id
423
+ ]
424
+ if len(releases) != 1 or releases[0].receipt_id != release_receipt.receipt_id:
425
+ return None
426
+ if any(
427
+ item.allocation_id == record.allocation_id
428
+ for item in snapshot.publication_receipts.values()
429
+ ):
430
+ return None
431
+ positions = [
432
+ index for index, event in enumerate(record.history)
433
+ if event.get("event") == "INTEGRATION_ABORTED"
434
+ ]
435
+ if len(positions) != 1:
436
+ return None
437
+ position = positions[0]
438
+ event = record.history[position]
439
+ owner = event.get("owner")
440
+ bound = event.get("abort_receipt")
441
+ if (
442
+ not isinstance(owner, str)
443
+ or not owner.strip()
444
+ or event.get("from") not in {"ACTIVE", "QUARANTINED"}
445
+ or event.get("to") != "INTEGRATION_ABORTED"
446
+ or not isinstance(bound, dict)
447
+ ):
448
+ return None
449
+ receipt_id = bound.get("receipt_id")
450
+ digest = bound.get("sha256")
451
+ if not isinstance(receipt_id, str) or not isinstance(digest, str):
452
+ return None
453
+ try:
454
+ if str(UUID(receipt_id)) != receipt_id:
455
+ return None
456
+ except ValueError:
457
+ return None
458
+ from .integration_cleanup import resource_tail_valid
459
+
460
+ try:
461
+ if not resource_tail_valid(
462
+ record, type("Item", (), {"path": Path(release_receipt.target_path)})(), position
463
+ ):
464
+ return None
465
+ value, actual = e.read(store.completion_receipts_dir / f"{receipt_id}.json", digest)
466
+ except (ControllerError, OSError, ValueError, KeyError, TypeError):
467
+ return None
468
+ if actual != digest:
469
+ return None
470
+ intent_id = value.get("intent_id")
471
+ if (
472
+ value.get("kind") != "integration_abort"
473
+ or value.get("schema_version") != 1
474
+ or value.get("receipt_id") != receipt_id
475
+ or value.get("repository_id") != snapshot.repository_id
476
+ or value.get("allocation_id") != record.allocation_id
477
+ or value.get("task_key") != record.task_key
478
+ or value.get("authority_key") != record.authority_key
479
+ or value.get("owner") != owner
480
+ or value.get("branch") != release_receipt.branch
481
+ or value.get("candidate_oid") != expected_oid
482
+ or not isinstance(value.get("failure_reason"), str)
483
+ or not str(value.get("failure_reason")).strip()
484
+ or not isinstance(intent_id, str)
485
+ ):
486
+ return None
487
+ try:
488
+ if str(UUID(intent_id)) != intent_id:
489
+ return None
490
+ except ValueError:
491
+ return None
492
+ intent = snapshot.integration_intents.get(intent_id)
493
+ if (
494
+ intent is None
495
+ or not integration_intent_abandoned(intent)
496
+ or intent.owner != owner
497
+ or intent.task_key != record.task_key
498
+ or intent.candidate_oid != expected_oid
499
+ or intent.published_at is not None
500
+ or any(item.intent_id == intent_id for item in snapshot.publication_receipts.values())
501
+ or not any(row.get("event") == "PREPARATION_ABORTED" for row in intent.history)
502
+ ):
503
+ return None
504
+ return {
505
+ "contract": "aborted-ancestor-branch-retirement/v1",
506
+ "abort_receipt_id": receipt_id,
507
+ "abort_receipt_sha256": digest,
508
+ "intent_id": intent_id,
509
+ "candidate_oid": expected_oid,
510
+ }
511
+
512
+
395
513
  def _release_intent_resolved(
396
514
  snapshot: MetadataSnapshot,
397
515
  record: MetadataRecord | None,
@@ -562,6 +680,7 @@ def _evaluate(
562
680
  blockers.append("BRANCH_CHECKED_OUT")
563
681
 
564
682
  record = snapshot.records.get(resolved_allocation or "")
683
+ aborted_ancestor_evidence = None
565
684
  if release_receipt is not None or transition_evidence is not None:
566
685
  if record is None:
567
686
  blockers.append("ALLOCATION_RECORD_MISSING")
@@ -576,12 +695,29 @@ def _evaluate(
576
695
  if record.lifecycle != "RELEASED":
577
696
  blockers.append("ALLOCATION_NOT_RELEASED")
578
697
  if record.role == "integration":
579
- if remote != policy.publication_remote or not _integration_publication_verified(
580
- snapshot,
581
- record,
582
- release_receipt,
583
- target_ref=f"refs/heads/{policy.publication_branch}",
698
+ published = (
699
+ remote == policy.publication_remote
700
+ and _integration_publication_verified(
701
+ snapshot,
702
+ record,
703
+ release_receipt,
704
+ target_ref=f"refs/heads/{policy.publication_branch}",
705
+ )
706
+ )
707
+ if (
708
+ not published
709
+ and remote == policy.publication_remote
710
+ and classification == "ANCESTRY"
711
+ and record.lifecycle == "RELEASED"
584
712
  ):
713
+ aborted_ancestor_evidence = _aborted_ancestor_evidence(
714
+ store,
715
+ snapshot,
716
+ record,
717
+ release_receipt,
718
+ expected_oid=expected_oid,
719
+ )
720
+ if not published and aborted_ancestor_evidence is None:
585
721
  blockers.append("INTEGRATION_PUBLICATION_NOT_VERIFIED")
586
722
  elif record.role not in {"feature", "audit"}:
587
723
  blockers.append("UNSUPPORTED_ALLOCATION_ROLE")
@@ -651,6 +787,8 @@ def _evaluate(
651
787
  }
652
788
  if transition_evidence is not None:
653
789
  core["canonical_transition_evidence"] = transition_evidence
790
+ if aborted_ancestor_evidence is not None:
791
+ core["aborted_ancestor_evidence"] = aborted_ancestor_evidence
654
792
  observed_plan_id = _sha256_json(_plan_identity(core))
655
793
  if plan_id is not None and observed_plan_id != plan_id:
656
794
  core["eligible"] = False
@@ -114,8 +114,8 @@ def register(
114
114
  raise ControllerError("MISSING_RETAINED_REF", "registration requires an exact retained branch")
115
115
  if life._release_transaction(store, target_path=str(item.path), allocation_id=record.allocation_id):
116
116
  raise ControllerError("TRANSACTION_PENDING", "finish existing cleanup before registration")
117
- life._validate_runtime_clear(item, strict=True)
118
- blockers = life._typed_runtime_blockers(life._typed_runtime_evidence(item, record, snapshot))
117
+ runtime_evidence = life._typed_runtime_evidence(item, record, snapshot)
118
+ blockers = life._typed_runtime_blockers(runtime_evidence)
119
119
  if blockers:
120
120
  raise ControllerError(blockers[0]["code"], blockers[0]["message"])
121
121
  inputs = project_inputs(item.path, project, recipe)
@@ -152,5 +152,12 @@ def register(
152
152
  result = envelope("build-resource-register")
153
153
  result["decision"] = {"code": "BUILD_RESOURCE_PLAN" if dry_run else EVENT,
154
154
  "plan_id": plan_id, "registration": proof,
155
+ "runtime_evidence": runtime_evidence,
155
156
  "record_version": record.record_version if dry_run else updated.record_version}
157
+ if runtime_evidence.get("host_visibility_gaps"):
158
+ result["warnings"].append({
159
+ "code": "HOST_VISIBILITY_GAP",
160
+ "pids": [row["pid"] for row in runtime_evidence["host_visibility_gaps"]],
161
+ "message": "unassociated host procfs permission gaps are outside managed-runtime authority; no claim of host-wide absence of references",
162
+ })
156
163
  return result
@@ -1063,6 +1063,7 @@ def _main(argv: list[str] | None) -> int:
1063
1063
  "preservation_supersession_version": 1,
1064
1064
  "retained_typed_cleanup_version": 1,
1065
1065
  "aborted_integration_preserved_cleanup_version": 2,
1066
+ "aborted_integration_branch_retirement_version": 1,
1066
1067
  "terminal_preserved_cleanup_version": 1,
1067
1068
  "preservation_leaf_version": 1,
1068
1069
  "integration_publication_execution_version": 1,
@@ -10,7 +10,7 @@ from .models import ControllerError
10
10
  CONTRACT = "aborted-integration-preserved-cleanup/v1"
11
11
 
12
12
 
13
- def _resource_tail_valid(record, item, position: int) -> bool:
13
+ def resource_tail_valid(record, item, position: int) -> bool:
14
14
  """Verify terminal resource-only transitions without reissuing an abort.
15
15
 
16
16
  Legacy producers recorded no per-event resource payload. Their contract only
@@ -110,7 +110,7 @@ def abort_evidence(store, snapshot, item, record) -> dict[str, str]:
110
110
  if (
111
111
  event.get("owner") != record.owner
112
112
  or event.get("to") != "INTEGRATION_ABORTED"
113
- or not _resource_tail_valid(record, item, position)
113
+ or not resource_tail_valid(record, item, position)
114
114
  ):
115
115
  raise invalid()
116
116
  if record.quarantine_observed_commit and record.quarantine_observed_commit != item.head:
@@ -1078,7 +1078,7 @@
1078
1078
  "session_launcher_entrypoint": "worktree-session",
1079
1079
  "session_entrypoint": "worktree-session-end",
1080
1080
  "tool_name": "worktree-controller",
1081
- "tool_version": "1.33.0",
1081
+ "tool_version": "1.34.0",
1082
1082
  "delivered_closeout_version": 1,
1083
1083
  "retained_archive_version": 1,
1084
1084
  "retention_convergence_version": 2,
@@ -1531,6 +1531,7 @@
1531
1531
  },
1532
1532
  "retained_typed_cleanup_version": 1,
1533
1533
  "aborted_integration_preserved_cleanup_version": 2,
1534
+ "aborted_integration_branch_retirement_version": 1,
1534
1535
  "aborted_integration_preserved_cleanup_contract": {
1535
1536
  "contract": "aborted-integration-preserved-cleanup/v1",
1536
1537
  "entrypoints": ["integration-abort", "python -m worktree_controller.preservation", "resource-clean --typed", "release", "integration-claim"],
@@ -1546,6 +1547,13 @@
1546
1547
  "result": "cleanup only; never publication, source adoption, branch retirement or task completion",
1547
1548
  "storage_layout_version": 5
1548
1549
  },
1550
+ "aborted_integration_branch_retirement_contract": {
1551
+ "contract": "aborted-ancestor-branch-retirement/v1",
1552
+ "entrypoint": "branch-retirement-plan",
1553
+ "eligible": "released integration allocation with one exact abort receipt, an abandoned detached intent, no publication receipt, and direct ancestry of the publication branch",
1554
+ "execution": "existing plan-id expected-OID CAS; the plan pins abort receipt id, raw SHA-256 and intent id",
1555
+ "refusal": "retryable, drifted, missing or non-ancestor evidence keeps INTEGRATION_PUBLICATION_NOT_VERIFIED; cherry-equivalence is not authority"
1556
+ },
1549
1557
  "multiple_preservation_recovery_version": 1,
1550
1558
  "multiple_preservation_recovery_contract": {
1551
1559
  "contract": "multiple-preservation-cleanup-recovery/v1",
@@ -1078,7 +1078,7 @@
1078
1078
  "session_launcher_entrypoint": "worktree-session",
1079
1079
  "session_entrypoint": "worktree-session-end",
1080
1080
  "tool_name": "worktree-controller",
1081
- "tool_version": "1.33.0",
1081
+ "tool_version": "1.34.0",
1082
1082
  "delivered_closeout_version": 1,
1083
1083
  "retained_archive_version": 1,
1084
1084
  "retention_convergence_version": 2,
@@ -1531,6 +1531,7 @@
1531
1531
  },
1532
1532
  "retained_typed_cleanup_version": 1,
1533
1533
  "aborted_integration_preserved_cleanup_version": 2,
1534
+ "aborted_integration_branch_retirement_version": 1,
1534
1535
  "aborted_integration_preserved_cleanup_contract": {
1535
1536
  "contract": "aborted-integration-preserved-cleanup/v1",
1536
1537
  "entrypoints": ["integration-abort", "python -m worktree_controller.preservation", "resource-clean --typed", "release", "integration-claim"],
@@ -1546,6 +1547,13 @@
1546
1547
  "result": "cleanup only; never publication, source adoption, branch retirement or task completion",
1547
1548
  "storage_layout_version": 5
1548
1549
  },
1550
+ "aborted_integration_branch_retirement_contract": {
1551
+ "contract": "aborted-ancestor-branch-retirement/v1",
1552
+ "entrypoint": "branch-retirement-plan",
1553
+ "eligible": "released integration allocation with one exact abort receipt, an abandoned detached intent, no publication receipt, and direct ancestry of the publication branch",
1554
+ "execution": "existing plan-id expected-OID CAS; the plan pins abort receipt id, raw SHA-256 and intent id",
1555
+ "refusal": "retryable, drifted, missing or non-ancestor evidence keeps INTEGRATION_PUBLICATION_NOT_VERIFIED; cherry-equivalence is not authority"
1556
+ },
1549
1557
  "multiple_preservation_recovery_version": 1,
1550
1558
  "multiple_preservation_recovery_contract": {
1551
1559
  "contract": "multiple-preservation-cleanup-recovery/v1",