alissa-tools-github-devloop 0.8.45__py3-none-any.whl → 0.8.46__py3-none-any.whl

alissa/tools/github/devloop/parking.py

@@ -25,7 +25,7 @@ serves it on ``GET /api/state`` and runs the drain handshake):
   null as a refusal.
 * **The drain.** A flag with a TTL in `state.db` (`State.set_drain`), cleared
   when the daemon boots. While it holds, every spawn path stands down before
-  its first side effect (`DevWatcher._drain_gate`).
+  its first side effect (`DevWatcher._drain_gated`).
 """
 
 from __future__ import annotations

alissa/tools/github/devloop/version

@@ -1 +1 @@
-0.8.45
+0.8.46

alissa/tools/github/devloop/webui/server.py

@@ -234,7 +234,16 @@ class App:
         down and the answer is `drained: false` with the reasons. When the
         drain holds, a vitals snapshot carrying `idle.drainedAt` is pushed
         BEFORE the answer, because that snapshot is what Studio re-checks
-        before it removes anything; the answer says how the push went."""
+        before it removes anything; the answer says how the push went.
+
+        A refused drain lowers the flag, not just its own raise: the clear is
+        unscoped (`State.clear_drain`). A refused RE-drain therefore also
+        lowers an earlier drain that held and had answered `drained: true`,
+        and so does a second, overlapping `/action/drain` that is refused.
+        That is intended (seat-parking §2.4: when the block breaks D2 "the
+        seat clears the flag itself and answers `drained: false`"): a seat
+        that is no longer idle must not stay drained, whoever raised the
+        flag."""
         if ttl_s is None:
             ttl = parking.DRAIN_TTL_DEFAULT
         elif (
@@ -265,7 +274,7 @@ class App:
         except sqlite3.Error as exc:
             self._audit("drain", {"ok": False, "error": str(exc)})
             return 503, {"drained": False, "error": "state_unavailable"}
-        listing = self.sources._safe_json(["alissa", "tmux", "ls", "--json"])
+        listing = self.sources.listing()
         idle = self.sources.idle(listing=listing)
         refusals = parking.idle_refusals(
             idle, poll_interval=self.sources.config.poll_interval, now=now,
@@ -305,13 +314,18 @@ class App:
     def undrain(self) -> "tuple[int, dict]":
         """`POST /action/undrain`: lower the drain flag -- orcloop's step 4
         on any failure of a park. Idempotent: undraining a seat that is not
-        drained answers `cleared: false`. (status, payload), audited."""
+        drained answers `cleared: false`. (status, payload), audited.
+
+        A ledger that cannot be written answers 503 with `drained: null`:
+        nobody knows then whether the flag is up (there may be no drain at
+        all), and unknown is never a value (design D2). The 503 already says
+        the undrain did not land; the TTL still bounds any flag left up."""
         try:
             with State(self.sources.config.state_db) as st:
                 cleared = st.clear_drain()
         except sqlite3.Error as exc:
             self._audit("undrain", {"ok": False, "error": str(exc)})
-            return 503, {"drained": True, "error": "state_unavailable"}
+            return 503, {"drained": None, "error": "state_unavailable"}
         self._audit("undrain", {"ok": True, "cleared": cleared})
         return 200, {"drained": False, "cleared": cleared}
 

alissa/tools/github/devloop/webui/sources.py

@@ -384,6 +384,15 @@ class Sources:
         except ValueError:
             return None
 
+    def listing(self) -> "object":
+        """The parsed ``alissa tmux ls --json`` listing, or None when it could
+        not be read (the command failed, printed nothing, or printed something
+        that is not JSON). The console's one reader of the tmux roster: the
+        sessions panel, the idle block, the dashboard and the drain handshake
+        all read it here. The value is whatever the CLI printed -- callers
+        check it is a list before trusting its shape."""
+        return self._safe_json(["alissa", "tmux", "ls", "--json"])
+
     def sessions(self, listing: "list[dict] | None" = None) -> "list[dict]":
         """The managed sessions with their edge, age and `/proc` footprint.
 
@@ -393,9 +402,7 @@ class Sources:
         console (no listing) lists for itself. Either way the rows go
         through the same shaping, so the two never disagree about what a
         session record looks like."""
-        raw = listing if listing is not None else (
-            self._safe_json(["alissa", "tmux", "ls", "--json"]) or []
-        )
+        raw = listing if listing is not None else (self.listing() or [])
         if not isinstance(raw, list):
             return []
         now = int(self._wall())
@@ -463,7 +470,7 @@ class Sources:
             snaps = self.snapshots(1)
             latest = snaps[0] if snaps else None
         if listing is _UNREAD:
-            listing = self._safe_json(["alissa", "tmux", "ls", "--json"])
+            listing = self.listing()
         roster = listing if isinstance(listing, list) else None
         snapshot = latest if isinstance(latest, dict) else None
         queues = self._safe_json(["alissa", "tmux", "queue", "ls", "--json"])
@@ -678,7 +685,7 @@ class Sources:
         latest = snaps[0] if snaps else None
         ledgers = self.ledgers()
         # One listing feeds both the sessions panel and the idle block.
-        listing = self._safe_json(["alissa", "tmux", "ls", "--json"])
+        listing = self.listing()
         sessions = self.sessions(
             listing=listing if isinstance(listing, list) else []
         )

{alissa_tools_github_devloop-0.8.45.dist-info → alissa_tools_github_devloop-0.8.46.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alissa-tools-github-devloop
-Version: 0.8.45
+Version: 0.8.46
 Summary: ALISSA-TOOLS-GITHUB-DEVLOOP
 Home-page: https://alissa.app
 Author: Fahera

{alissa_tools_github_devloop-0.8.45.dist-info → alissa_tools_github_devloop-0.8.46.dist-info}/RECORD

@@ -10,23 +10,23 @@ alissa/tools/github/devloop/hubs.py,sha256=yjnsnSHLG7GNNP8X2hILeAMV6P5n4JGc_IaAx
 alissa/tools/github/devloop/janitor.py,sha256=R8REoHBeY2cfW7fYJVhKr-F5z9Mjlc-vmv-z4KtvBZc,27360
 alissa/tools/github/devloop/loop.py,sha256=I5rZy082JqplmFm1t2XgYkstc7IdkJJdX-FXAfwqcKk,624114
 alissa/tools/github/devloop/loop_events.py,sha256=pKtBl1HK8gYPB2gKiI29xUkx-JuW2A48KwRlbdcf_lo,37942
-alissa/tools/github/devloop/parking.py,sha256=vEf-qprN14-I4vu4M53tIFaA3827FiHLpKetBAgN4LQ,12409
+alissa/tools/github/devloop/parking.py,sha256=7h3Gg2XQ0eqlvn0M6K6NeEg9xbqnlUPrZNs9gRofzxc,12410
 alissa/tools/github/devloop/proc.py,sha256=nzfsxJSHFWRQcrXmfv588KazFysv8dVQrhMPH1q5eRk,3134
 alissa/tools/github/devloop/prompts.py,sha256=VzN6ec5eF2wwg7QSCRg52WLcxo-tGbGRgQbc4HSahUc,55169
 alissa/tools/github/devloop/state.py,sha256=uVwhbkogUTjWXXFq-COKzUeYrpuGbHzi05CjfEzAtPA,88668
-alissa/tools/github/devloop/version,sha256=SvuxweSl5ewBHlA8sLXW9Cnb1QXZFR16TSaeQVx76Nw,7
+alissa/tools/github/devloop/version,sha256=YpzpT7756Lld10FKXeESQnDWJA9HvJScK9ngOSfSk8s,7
 alissa/tools/github/devloop/version.py,sha256=znuuOaitXGrBpbskNy78_rlVpFdtmKmk_3k1ACxZrl0,1418
 alissa/tools/github/devloop/webui/__init__.py,sha256=vdXYoyGYzD7BrJ5lV6XdH8Bpw_pej8-RK0hjfxop7-8,1513
 alissa/tools/github/devloop/webui/__main__.py,sha256=wORyW5AkgsniK0TZcrOrvm_P7Q4Mr-fH-4S6qj9XcgA,6137
 alissa/tools/github/devloop/webui/auth.py,sha256=g9YEDao9nKt-cBEENp7vFqwJ-T8olN6uLiCzVIN8yhA,7890
 alissa/tools/github/devloop/webui/page.py,sha256=4OD3e01ByvVM4Wo04AZyFuyOYTFEMT2lagktZAvyCKk,30862
-alissa/tools/github/devloop/webui/server.py,sha256=YuUmcng5qdWqSurcuyxH3FKKkBBfrpDtvtZLidJOGiU,26226
-alissa/tools/github/devloop/webui/sources.py,sha256=JJXJEkLKh2qRbpTaIyQwCTu90DuKq_Z3nz6DwLhzlr4,38900
+alissa/tools/github/devloop/webui/server.py,sha256=3aGYGesjUSrPrgcpfy-oYDefBNKnAj3lGfRzwsRkv_I,27031
+alissa/tools/github/devloop/webui/sources.py,sha256=Uw_2B5QGSmW6f66WfVbQb6yLLYmSv6uuF7HNJ5OSr_I,39314
 alissa/tools/github/devloop/webui/sysinfo.py,sha256=ptlogH9alFv0vZ-pQfyUaA3w-K7LQS3tQHGv0d8Tdlk,9649
-alissa_tools_github_devloop-0.8.45.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
-alissa_tools_github_devloop-0.8.45.dist-info/licenses/NOTICE,sha256=FKstNs3uw_tQod4_1XcFLD1FUTJQXf4FC0oXJAOA_HE,260
-alissa_tools_github_devloop-0.8.45.dist-info/METADATA,sha256=UUG6d1BW6ztPi_whOMe8pL-eLbLK7LpT8BEFUECIp0s,13628
-alissa_tools_github_devloop-0.8.45.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-alissa_tools_github_devloop-0.8.45.dist-info/entry_points.txt,sha256=8aC7Ajzx4bu9ZRR37a40IDfuStacvZP5KsAxY1dbFKU,145
-alissa_tools_github_devloop-0.8.45.dist-info/top_level.txt,sha256=DodjDg-l-TWQnlxG-Vuc3G5sB4O7cWGQwe6XrVx3u-A,7
-alissa_tools_github_devloop-0.8.45.dist-info/RECORD,,
+alissa_tools_github_devloop-0.8.46.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+alissa_tools_github_devloop-0.8.46.dist-info/licenses/NOTICE,sha256=FKstNs3uw_tQod4_1XcFLD1FUTJQXf4FC0oXJAOA_HE,260
+alissa_tools_github_devloop-0.8.46.dist-info/METADATA,sha256=0V0tseoJcEXAfIvuBYJmDowXYvWG0FaMgnUNbASbxVE,13628
+alissa_tools_github_devloop-0.8.46.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+alissa_tools_github_devloop-0.8.46.dist-info/entry_points.txt,sha256=8aC7Ajzx4bu9ZRR37a40IDfuStacvZP5KsAxY1dbFKU,145
+alissa_tools_github_devloop-0.8.46.dist-info/top_level.txt,sha256=DodjDg-l-TWQnlxG-Vuc3G5sB4O7cWGQwe6XrVx3u-A,7
+alissa_tools_github_devloop-0.8.46.dist-info/RECORD,,