@pennixrv/trellis 0.6.34 → 0.6.35

package/dist/migrations/manifests/0.6.34.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.6.34",
+  "description": "Records the published 0.6.34 release before the sealed-handoff lifecycle release.",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Internal:**\n- Restores the published 0.6.34 release manifest so adjacent-version update paths remain complete.",
+  "migrations": [],
+  "notes": "No project migration is required. Existing projects can run the normal `trellis update` flow."
+}

package/dist/templates/trellis/scripts/common/active_task.py

@@ -781,6 +781,22 @@ def clear_active_task(
     return previous
 
 
+def clear_active_task_for_context(
+    context_key: str,
+    task_path: str,
+    repo_root: Path,
+) -> str:
+    """Clear one exact session pointer, refusing an unexpected replacement."""
+    context_path = _context_path(repo_root, context_key)
+    context = _read_json(context_path)
+    if context is None or not _string_value(context.get("current_task")):
+        return "absent"
+    current = _string_value(context.get("current_task"))
+    if not _task_refs_match(current, task_path, repo_root):
+        return "changed"
+    return "cleared" if context_path.is_file() and _remove_file(context_path) else "absent"
+
+
 def clear_task_from_sessions(task_path: str, repo_root: Path) -> int:
     """Delete all session runtime files that point at a task."""
     target = _canonical_task_ref(task_path, repo_root) or normalize_task_ref(task_path)

package/dist/templates/trellis/scripts/common/ownership_record.py

@@ -10,7 +10,7 @@ from datetime import datetime, timezone
 from pathlib import Path
 from typing import Any
 
-from .active_task import clear_active_task, resolve_active_task, resolve_context_key, set_active_task
+from .active_task import clear_active_task, clear_active_task_for_context, resolve_active_task, resolve_context_key, set_active_task
 from .continuation_record import (
     ContinuationError,
     SAFE_ID,
@@ -290,6 +290,32 @@ def retire(root: Path, task_id: str, handoff_id: str, core_digest: str, expected
     return _public(record) | {"record_digest": digest}
 
 
+def retire_handoff(root: Path, task_id: str, handoff_id: str, core_digest: str) -> dict[str, Any]:
+    """Release one sealed handoff without requiring the departed source context."""
+    path, record = _load(root, task_id, handoff_id)
+    with _record_lock(path):
+        record = _decode(path)
+        if record["core_digest"] != core_digest:
+            raise OwnershipError("core_digest does not match")
+        if record["state"] == "ready":
+            return _public(record)
+        if record["state"] not in {"sealed", "retiring"}:
+            raise OwnershipError("ownership record is not a sealed handoff")
+        if record["state"] == "sealed":
+            record["previous_event_digest"] = record["integrity"]["record_digest"]
+            record["state"] = "retiring"
+            record["generation"] += 1
+            _write(path, record)
+        cleared = clear_active_task_for_context(record["source_context_key"], record["task"]["path"], root)
+        if cleared == "changed":
+            raise OwnershipError("source task pointer changed during handoff retirement")
+        record["previous_event_digest"] = record["integrity"]["record_digest"]
+        record["state"] = "ready"
+        record["generation"] += 1
+        digest = _write(path, record)
+    return _public(record) | {"record_digest": digest}
+
+
 def claim(root: Path, task_id: str, task_path: str, handoff_id: str, core_digest: str, expected_generation: int) -> dict[str, Any]:
     actor, active = _direct_context(root)
     path, record = _load(root, task_id, handoff_id)
@@ -410,5 +436,4 @@ def assert_task_mutation_allowed(root: Path, task_path: Path) -> None:
             raise OwnershipError("ownership record task path does not match current task")
         if record.get("consumer_session_id") == actor:
             continue
-        if record["source_session_id"] == actor or record["state"] in {"retiring", "ready", "claiming", "claimed", "consumed", "archived"}:
-            raise OwnershipError("fencing_conflict: task is owned by another handoff session")
+        raise OwnershipError("fencing_conflict: task is owned by another handoff session")

package/dist/templates/trellis/scripts/task.py

@@ -90,6 +90,7 @@ from common.ownership_record import (
     consume as consume_ownership,
     quiesce as quiesce_ownership,
     retire as retire_ownership,
+    retire_handoff as retire_handoff_ownership,
     seal as seal_ownership,
     status as ownership_status,
 )
@@ -436,6 +437,10 @@ def cmd_ownership(args: argparse.Namespace) -> int:
                 repo_root, args.task_id, args.handoff_id, args.core_digest,
                 args.expected_generation, args.archive_observation,
             )
+        elif command == "retire-handoff":
+            result = retire_handoff_ownership(
+                repo_root, args.task_id, args.handoff_id, args.core_digest,
+            )
         elif command == "claim":
             result = claim_ownership(
                 repo_root, args.task_id, args.task, args.handoff_id, args.core_digest, args.expected_generation
@@ -840,6 +845,9 @@ def main() -> int:
     ownership_retire.add_argument("--archive-observation", required=True, choices=("not_required", "observed"))
     add_ownership_common(ownership_retire, expected=True)
 
+    ownership_retire_handoff = ownership_sub.add_parser("retire-handoff", help="Release one sealed handoff by exact id")
+    add_ownership_common(ownership_retire_handoff)
+
     ownership_claim = ownership_sub.add_parser("claim", help="Claim a ready handoff as this session")
     ownership_claim.add_argument("--task", required=True, help="Task path to bind to this session")
     add_ownership_common(ownership_claim, expected=True)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pennixrv/trellis",
-  "version": "0.6.34",
+  "version": "0.6.35",
   "description": "AI capabilities grow like ivy — Trellis provides the structure to guide them along a disciplined path",
   "type": "module",
   "main": "./dist/index.js",
@@ -34,7 +34,7 @@
     "inquirer": "^9.3.7",
     "undici": "^6.21.0",
     "zod": "^4.4.2",
-    "@pennixrv/trellis-core": "0.6.34"
+    "@pennixrv/trellis-core": "0.6.35"
   },
   "devDependencies": {
     "@eslint/js": "^9.18.0",