manta-node 0.6b5.dev705__py3-none-any.whl → 0.6b5.dev706__py3-none-any.whl

manta_node/cli/_version_generated.py

@@ -4,7 +4,7 @@ This file is auto-generated at build time by scripts/generate_version.py.
 Do not edit manually.
 """
 
-__version__ = "2026.09.24.d60eab69"
+__version__ = "2026.09.24.8d51d71c"
 __build_date__ = "2026.09.24"
-__commit_id__ = "d60eab69"
+__commit_id__ = "8d51d71c"
 __package_version__ = "0.6b5"

manta_node/supervisor/lifecycle.py

@@ -28,6 +28,11 @@ from .bounds import Bounds
 from .inflight import InFlight, clear_inflight, deadline_from_now, write_inflight
 from .switch import VersionTreeError
 
+# The free-space floor to stage a version dir. A version dir holds a full
+# dependency closure, so the check refuses well before the disk is full rather
+# than half-staging (NF-12). Operator-overridable via `run_switch`'s argument.
+MIN_FREE_BYTES = 500 * 1024 * 1024
+
 
 class LifecycleError(Exception):
     """A lifecycle step failed; the node stays on its current version (NF-3)."""
@@ -88,6 +93,7 @@ def run_switch(
     is_back: ReturnProbe,
     bounds: Bounds | None = None,
     now: Callable[[], float] = time.time,
+    min_free_bytes: int = MIN_FREE_BYTES,
 ) -> SwitchOutcome:
     """Run the lifecycle for one request and return its terminal outcome.
 
@@ -121,6 +127,16 @@ def run_switch(
     if not _within(bounds.verify, lambda: verify(candidate_dir, candidate_python)):
         return _outcome(request, SeamState.FAILED, "verification failed (no switch)")
 
+    # FREE SPACE — refuse before staging when there is no room for a full version
+    # dir (NF-12, §6.2). Refusing here, before any write, is what stops a
+    # half-staged tree: the node stays on its current version.
+    if not version_tree.has_room_for(min_free_bytes):
+        return _outcome(
+            request,
+            SeamState.REFUSED,
+            "insufficient free space to stage a version dir",
+        )
+
     # STAGE — materialise the candidate's version dir (idempotent), bounded.
     staged: dict = {}
 
@@ -161,6 +177,13 @@ def run_switch(
 
     if is_back(record.deadline_epoch):
         clear_inflight()
+        # Reclaim on a SUCCESSFUL switch (NF-12/B-34): the tree stays bounded, and
+        # the current and last-good versions are never removed. No separate
+        # sweeper: reclamation rides the switch that made a version superseded.
+        protect = {target}
+        if last_good_dir is not None:
+            protect.add(last_good_dir)
+        version_tree.reclaim(bounds.retention_dirs, protect)
         return _outcome(
             request,
             SeamState.REPORTING,

manta_node/supervisor/switch.py

@@ -22,6 +22,8 @@ the token, config or datasets.
 from __future__ import annotations
 
 import os
+import shutil
+import sys
 from dataclasses import dataclass
 from datetime import datetime, timezone
 from importlib.metadata import PackageNotFoundError, version
@@ -199,3 +201,72 @@ def is_pointer_target(target: Path) -> bool:
     """True when ``current`` resolves to ``target``."""
     link = current_link()
     return link.is_symlink() and Path(os.path.realpath(link)) == target
+
+
+def list_versions() -> list[Path]:
+    """The version dirs, oldest first.
+
+    Ordered by the manifest's ``created`` (a dir with no readable manifest sorts
+    first, so a corrupt one is reclaimed before a good one). Used by retention to
+    pick what to reclaim.
+    """
+    root = versions_dir()
+    if not root.is_dir():
+        return []
+
+    def created(p: Path) -> str:
+        manifest = read_manifest(p)
+        return manifest.created if manifest else ""
+
+    dirs = [p for p in root.iterdir() if p.is_dir()]
+    return sorted(dirs, key=created)
+
+
+def reclaim(retention_dirs: int, protect: set[Path]) -> list[Path]:
+    """Remove the oldest versions beyond ``retention_dirs``, never a protected one.
+
+    NF-12/B-34: the version tree stays bounded, but the **current** and last-good
+    versions are never removed — ``protect`` names them. Returns the removed dirs.
+    Called on a successful switch, so there is no separate sweeper to start.
+    """
+    versions = list_versions()
+    protected = {os.path.realpath(p) for p in protect}
+    # Oldest first; drop the front until the count is within the bound, skipping
+    # a protected dir (do not count it as removable, but it still occupies a slot).
+    removed: list[Path] = []
+    keep = max(retention_dirs, 2)  # current + last good is the floor
+    for candidate in versions:
+        if len(versions) - len(removed) <= keep:
+            break
+        if os.path.realpath(candidate) in protected:
+            continue
+        try:
+            for child in candidate.iterdir():
+                if child.is_dir():
+                    shutil.rmtree(child)
+                else:
+                    child.unlink()
+            candidate.rmdir()
+            removed.append(candidate)
+        except OSError as exc:
+            # A dir we cannot remove stays: retention is best-effort on a live
+            # node, and failing the switch over a stale dir would be worse.
+            print(f"retention: could not reclaim {candidate}: {exc}", file=sys.stderr)
+    return removed
+
+
+def has_room_for(min_bytes: int) -> bool:
+    """True when the version tree's filesystem has at least ``min_bytes`` free.
+
+    The free-space refusal (NF-12, mechanism §6.2): a node with no room to stage
+    a full version dir refuses the update rather than half-staging. The caller
+    passes the candidate's estimated size.
+    """
+    root = versions_dir()
+    # Check the nearest existing ancestor: the tree may not exist yet on a fresh
+    # node, and the capacity is the filesystem's either way.
+    probe = root
+    while not probe.exists() and probe != probe.parent:
+        probe = probe.parent
+    free = shutil.disk_usage(probe).free
+    return free >= min_bytes

{manta_node-0.6b5.dev705.dist-info → manta_node-0.6b5.dev706.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: manta_node
-Version: 0.6b5.dev705
+Version: 0.6b5.dev706
 Summary: Node side software of the Manta platform. It is responsible for the communication with the Manta Core and the execution of the tasks.
 Author-email: Hugo Miralles <hugo.miralles@manta-tech.io>, Matthew Thompson <matthew.thompson@manta-tech.io>
 License-Expression: AGPL-3.0-or-later

{manta_node-0.6b5.dev705.dist-info → manta_node-0.6b5.dev706.dist-info}/RECORD

@@ -6,7 +6,7 @@ manta_node/task_manager.py,sha256=xRE-yKdUW0FFR8vtX1jDwl1AxTbqVD_JS7QVR62GA00,38
 manta_node/tasks.py,sha256=o837Hi-KFVJg9LF5iOtE8oD6UuTOfrEPWR-JOdhRGeY,6983
 manta_node/utils.py,sha256=Hw4Iw2jYQYsfVLVJuBMt-_rMFBeml3nCDE2jiiXc8YM,1155
 manta_node/cli/__init__.py,sha256=arzO3mXDJ-E2yeeytbZfN7mCswwxdQ43_QjyeL2E5yE,134
-manta_node/cli/_version_generated.py,sha256=Avtgxf4CTYxrwjUmb8TM92DAZRNRqrzV-eNId81M60o,275
+manta_node/cli/_version_generated.py,sha256=rTGRherNt_ty7j_gNSOWg1VAt6h2GPc4Yfxo9cEWRio,275
 manta_node/cli/config_manager.py,sha256=BCju9zqzraviL3KrzRnB-vZQUY__Q5kuEqb7EdB8YdI,4409
 manta_node/cli/main.py,sha256=dZa6zrypWBvpN8hd4qpxevvlyNFhxKINCg1537NJ36w,4318
 manta_node/cli/version.py,sha256=3lrnIWpOosszBN-VsCBVLxDgpvCC7IB0aDIKx_3e7hI,3115
@@ -56,14 +56,14 @@ manta_node/supervisor/__init__.py,sha256=kgdoNce1tM4e7jvdxkdmnNJV1L92-NI2cRfYSdm
 manta_node/supervisor/bounds.py,sha256=MlUfj0tYY-US348JsxYA-Ph5pSpgoOPlRdVTwmrPtZA,3181
 manta_node/supervisor/executor.py,sha256=a0JafVoTmtbIu87nwUtj08KAC-Q-u0Ajdn_ptyu9yoc,6833
 manta_node/supervisor/inflight.py,sha256=JOqwXYM928fpcQtYdoK7596eAg28KM70bh85cyQgX3Q,2663
-manta_node/supervisor/lifecycle.py,sha256=JE74H0ODt5_y997kliiVDiQAf1laYptNjkrnnfGdgK0,7411
+manta_node/supervisor/lifecycle.py,sha256=GDy7d7MHxhabvTRoIkAL-_n0oja-GpmVWYAzOehP_DI,8551
 manta_node/supervisor/process.py,sha256=mWd2C4-S8NpupcLp0YbBEYmqQUQbrfMAZi5TF9UQ_cM,17504
 manta_node/supervisor/records.py,sha256=fUlL1SfmWpGnCbJ9956cuy0H3a7-aEF-B-naqbJiYoU,6405
 manta_node/supervisor/seam.py,sha256=HomMFTDbc0dZQ9VrfGVhQxjiU7E23-zwyjZnLsnq6dc,8031
-manta_node/supervisor/switch.py,sha256=BUSvMdWyUfZmeEVSBmQ7wLNRD7troPxZ3pdg8tOGXo4,7433
-manta_node-0.6b5.dev705.dist-info/licenses/LICENSE,sha256=9mBgLhiB9goQPQjg9XQJ6FjgVxYw9Q8lyOZYkPGwF_c,34484
-manta_node-0.6b5.dev705.dist-info/METADATA,sha256=ajleN4PRTTgRVihXNc2WTZEatE_cgnmro32xQBBd1JY,4231
-manta_node-0.6b5.dev705.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-manta_node-0.6b5.dev705.dist-info/entry_points.txt,sha256=uCwggRApalLEsYs1YxwTBN0-e9oMJAkMoBp01HaSdoY,110
-manta_node-0.6b5.dev705.dist-info/top_level.txt,sha256=nbT5J5WETuXM9UPoQckl29uUOq8wMYdRb9QDx5kAFeo,11
-manta_node-0.6b5.dev705.dist-info/RECORD,,
+manta_node/supervisor/switch.py,sha256=HQcNULUf6JafDGoKIh1mrw-4m9pxvz1hMLUPnwkY6mc,10173
+manta_node-0.6b5.dev706.dist-info/licenses/LICENSE,sha256=9mBgLhiB9goQPQjg9XQJ6FjgVxYw9Q8lyOZYkPGwF_c,34484
+manta_node-0.6b5.dev706.dist-info/METADATA,sha256=uSttKoedT1orqAsgzeEQzdiwXS8i8HW1Jdv2ni9q3rE,4231
+manta_node-0.6b5.dev706.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+manta_node-0.6b5.dev706.dist-info/entry_points.txt,sha256=uCwggRApalLEsYs1YxwTBN0-e9oMJAkMoBp01HaSdoY,110
+manta_node-0.6b5.dev706.dist-info/top_level.txt,sha256=nbT5J5WETuXM9UPoQckl29uUOq8wMYdRb9QDx5kAFeo,11
+manta_node-0.6b5.dev706.dist-info/RECORD,,