webbee 0.7.8__tar.gz → 0.7.9__tar.gz

{webbee-0.7.8 → webbee-0.7.9}/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.7.9
+
+Field report 06.11 #3 (a folder of nine repositories on Kubuntu):
+* A failed `checkpoint` says why: the 30 s budget of a big folder, or git's own error. Before, every failure read
+  "checkpoint failed (shadow git error)".
+* An upgrade while a session runs (pipx, uv, another terminal) is shown in the toolbar until you restart webbee.
+  Before, the old process ran on and `webbee --version` read the new one from disk.
+* Needs imperal-mcp 0.9.6 and imperal-sdk 6.5.3. With them, `contract_slice` reaches endpoints through their
+  handlers' calls, and `graph_slice` / `contract_slice` work at a folder of repositories.
+* The kernel side of the same report: co-changed files stand apart from real users in `impact_of_change`,
+  `search_code` follows one score, `orient` shows matches first, repository rows are named, `contract_slice` is in
+  the agent's tools, and `checkpoint` / `diff` / `rollback` come with the code tools.
+
 ## 0.7.8
 
 * The webbee beside the shell's imperal-mcp (its code tools) follows webbee's releases. Live: webbee 0.7.7 was out,

{webbee-0.7.8 → webbee-0.7.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: webbee
-Version: 0.7.8
+Version: 0.7.9
 Summary: Webbee 🐝 — the Imperal Cloud coding agent in your terminal
 Project-URL: Homepage, https://imperal.io
 Project-URL: Documentation, https://docs.imperal.io
@@ -31,8 +31,8 @@ Requires-Python: >=3.7
 Requires-Dist: asyncssh>=2.14; python_version >= '3.10'
 Requires-Dist: httpx-sse>=0.4; python_version >= '3.10'
 Requires-Dist: httpx>=0.27; python_version >= '3.10'
-Requires-Dist: imperal-mcp>=0.9.5; python_version >= '3.10'
-Requires-Dist: imperal-sdk[universal-index]>=6.5.2; python_version >= '3.10'
+Requires-Dist: imperal-mcp>=0.9.6; python_version >= '3.10'
+Requires-Dist: imperal-sdk[universal-index]>=6.5.3; python_version >= '3.10'
 Requires-Dist: model2vec>=0.8.2; python_version >= '3.10' and (sys_platform != 'darwin' or platform_machine != 'x86_64' or python_version < '3.13')
 Requires-Dist: numpy>=2; python_version >= '3.10' and (sys_platform != 'darwin' or platform_machine != 'x86_64' or python_version < '3.13')
 Requires-Dist: prompt-toolkit>=3; python_version >= '3.10'

{webbee-0.7.8 → webbee-0.7.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "webbee"
-version = "0.7.8"
+version = "0.7.9"
 description = "Webbee 🐝 — the Imperal Cloud coding agent in your terminal"
 readme = "README.md"
 license = "GPL-3.0-or-later"
@@ -13,8 +13,8 @@ dependencies = [
     # release on a Python 3.12 it sets up once with uv -- `uv` comes as a wheel on 3.8+,
     # 3.7 fetches it with uv's own installer.
     'uv>=0.4; python_version >= "3.8" and python_version < "3.10"',
-    'imperal-mcp>=0.9.5; python_version >= "3.10"',   # raised to the newest at each release
-    'imperal-sdk[universal-index]>=6.5.2; python_version >= "3.10"',
+    'imperal-mcp>=0.9.6; python_version >= "3.10"',   # raised to the newest at each release
+    'imperal-sdk[universal-index]>=6.5.3; python_version >= "3.10"',
     'asyncssh>=2.14; python_version >= "3.10"',
     'httpx>=0.27; python_version >= "3.10"',
     'httpx-sse>=0.4; python_version >= "3.10"',

webbee-0.7.9/src/webbee/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.7.9"

{webbee-0.7.8 → webbee-0.7.9}/src/webbee/checkpoints.py

@@ -75,6 +75,12 @@ class _Budget(Exception):
     """The snapshot ran past _SNAPSHOT_BUDGET_S."""
 
 
+def _why(r) -> str:
+    """A failed git run's own words, one short line."""
+    text = " ".join(str(getattr(r, "stderr", "") or getattr(r, "stdout", "") or "").split())
+    return (text[:240] or f"git exited {getattr(r, 'returncode', '?')}")
+
+
 class ShadowGit:
     _DIFF_CAP = 20000
 
@@ -86,6 +92,9 @@ class ShadowGit:
         self.auto_ok = True        # auto-checkpointing enabled (F8 latch below)
         self._auto_fail_streak = 0  # consecutive failed AUTO snapshots
         self.pause_reason = ""      # why auto-checkpointing stopped at once (a too-slow snapshot)
+        # why the last checkpoint failed, said to the agent (field report 06.11 #3: five "checkpoint failed (shadow git
+        # error)" at a folder of nine repositories, the cause -- a budget, a git error -- never shown)
+        self.last_error = ""
 
     def _git(self, *args: str) -> "subprocess.CompletedProcess":
         return self._git_io(list(args))
@@ -243,15 +252,20 @@ class ShadowGit:
         keep, nested, uncovered = self._collect(deadline)
         r = self._git_io(["ls-files", "-z", "-c"], deadline=deadline)
         if r.returncode != 0:
+            self.last_error = f"listing the shadow index failed: {_why(r)}"
             return False, nested, uncovered
         gone = sorted(set(_split_z(r.stdout)) - set(keep))
         for i in range(0, len(gone), _CHUNK):        # first: a gitlink must leave before its files come in
-            if self._git_io(["update-index", "-z", "--force-remove", "--stdin"],
-                            stdin="\0".join(gone[i:i + _CHUNK]) + "\0", deadline=deadline).returncode != 0:
+            g = self._git_io(["update-index", "-z", "--force-remove", "--stdin"],
+                             stdin="\0".join(gone[i:i + _CHUNK]) + "\0", deadline=deadline)
+            if g.returncode != 0:
+                self.last_error = f"removing gone files from the snapshot failed: {_why(g)}"
                 return False, nested, uncovered
         for i in range(0, len(keep), _CHUNK):
-            if self._git_io(["update-index", "-z", "--add", "--remove", "--stdin"],
-                            stdin="\0".join(keep[i:i + _CHUNK]) + "\0", deadline=deadline).returncode != 0:
+            a = self._git_io(["update-index", "-z", "--add", "--remove", "--stdin"],
+                             stdin="\0".join(keep[i:i + _CHUNK]) + "\0", deadline=deadline)
+            if a.returncode != 0:
+                self.last_error = f"adding {len(keep)} files to the snapshot failed: {_why(a)}"
                 return False, nested, uncovered
         return True, nested, uncovered
 
@@ -294,7 +308,9 @@ class ShadowGit:
         `force=True` always records a new checkpoint even with nothing dirty
         -- used by rollback() for its mandatory pre-rollback safety snapshot,
         which must exist even when the workspace already matches HEAD."""
+        self.last_error = ""
         if not self.available:
+            self.last_error = "the shadow history could not be set up for this workspace"
             return None
         try:
             deadline = time.monotonic() + _SNAPSHOT_BUDGET_S
@@ -320,6 +336,7 @@ class ShadowGit:
                 args.append("--allow-empty")      # first-ever baseline / forced snapshot
             c = self._git(*args)
             if c.returncode != 0:
+                self.last_error = f"the snapshot commit failed: {_why(c)}"
                 return None
             sha = self._git("rev-parse", "--short", "HEAD").stdout.strip()
             n = self._count() + 1
@@ -332,8 +349,11 @@ class ShadowGit:
             self._drop_stale_lock()
             self.auto_ok = False
             self.pause_reason = (f"a snapshot of this workspace took longer than {int(_SNAPSHOT_BUDGET_S)}s")
+            self.last_error = (self.pause_reason + " (the staged part is kept: checkpoint again to go on, or "
+                               "checkpoint inside one repository of this folder)")
             return None
-        except Exception:
+        except Exception as exc:
+            self.last_error = f"{type(exc).__name__}: {str(exc)[:200]}"
             return None
 
     def list_checkpoints(self, limit: int = 10) -> list:

{webbee-0.7.8 → webbee-0.7.9}/src/webbee/repl.py

@@ -669,6 +669,28 @@ async def _live_session_watch(cfg, token_provider, workspace, live: dict,
         await _sleep(interval)
 
 
+async def _installed_watch(update_state: dict, *, invalidate=None, every: float = 300.0, read=None,
+                           sleep=None) -> None:
+    """Every few minutes: the webbee on disk against the one running -- an upgrade during the session (pipx, uv, another
+    terminal's start) is said in the toolbar until the restart (field report 06.11 #3). Never raises."""
+    from webbee import __version__
+    from webbee.update import installed_version, restart_notice
+    read = read or installed_version
+    sleep = sleep or asyncio.sleep
+    while True:
+        try:
+            await sleep(every)
+            notice = restart_notice(__version__, await asyncio.to_thread(read))
+            if notice and update_state.get("notice") != notice:
+                update_state["notice"] = notice
+                if invalidate is not None:
+                    invalidate()
+        except asyncio.CancelledError:
+            raise
+        except Exception:
+            pass
+
+
 async def _check_update_bg(update_state: dict, *, invalidate=None,
                            fetch=None, cache_path=None) -> None:
     """One-shot background PyPI freshness check for the toolbar's version
@@ -1928,6 +1950,8 @@ async def run_repl(cfg, mode: str = "default", *, once: bool = False, sink=None,
                 _update_state: dict = {"notice": "", "checked": None}
                 home_slot.bg_tasks.append(asyncio.ensure_future(
                     _check_update_bg(_update_state, invalidate=_invalidate_dock)))
+                home_slot.bg_tasks.append(asyncio.ensure_future(
+                    _installed_watch(_update_state, invalidate=_invalidate_dock)))
 
                 async def _on_line(text: str, slot: SessionSlot) -> None:
                     if await _handle(text, slot) == "exit":

{webbee-0.7.8 → webbee-0.7.9}/src/webbee/tools.py

@@ -724,7 +724,8 @@ class LocalToolExecutor:
             return {"ok": False, "content": "reversibility is unavailable (no shadow git)"}
         cp = self.shadow.checkpoint(str(a.get("label", "") or "manual"))
         if cp is None:
-            return {"ok": False, "content": "checkpoint failed (shadow git error)"}
+            why = str(getattr(self.shadow, "last_error", "") or "") or "shadow git error"
+            return {"ok": False, "content": f"checkpoint failed: {why}"}
         note = "created" if cp.get("changed") else "no changes since the last checkpoint"
         # what it holds and what it does not, said (2026-10-30: a checkpoint of a folder of repositories held none of
         # their files and said "created")

{webbee-0.7.8 → webbee-0.7.9}/src/webbee/update.py

@@ -80,3 +80,27 @@ def check_for_update(current: str, *, cache_path, now: float, fetch, ttl: float
     Kept as-is (boot's banner path); `check_update_status` adds the verdict."""
     return _notice_for(current, _resolve_latest(
         current, cache_path=cache_path, now=now, fetch=fetch, ttl=ttl)) or None
+
+
+def installed_version(python: str = "", run=None) -> str:
+    """The webbee version on disk now, read by a fresh interpreter (this process's own metadata is what it started
+    with). "" when it cannot be read. Never raises."""
+    import subprocess
+    import sys
+    run = run or subprocess.run
+    try:
+        got = run([python or sys.executable, "-c", "import sys; sys.path[:] = [p for p in sys.path if p not in ('', '.')]; "
+                   "import importlib.metadata as m; print(m.version('webbee'))"],
+                  capture_output=True, text=True, timeout=20)
+        return str(got.stdout or "").strip() if got.returncode == 0 else ""
+    except Exception:
+        return ""
+
+
+def restart_notice(running: str, installed: str) -> str:
+    """Field report 06.11 #3: a pipx upgrade during a session left the old process running, and `webbee --version`
+    (read from disk) said the new one. Said in the toolbar until the session restarts."""
+    if installed and _ver(installed) and _ver(installed) != _ver(running):
+        return (f"\U0001f41d webbee v{installed} is installed, this session still runs v{running} "
+                "\u2014 restart webbee to use it")
+    return ""

{webbee-0.7.8 → webbee-0.7.9}/tests/test_checkpoints.py

@@ -309,3 +309,26 @@ def test_a_path_keeps_its_first_letter_when_the_first_line_is_unstaged(tmp_path,
         return real(*args)
     monkeypatch.setattr(sg, "_git", fake)
     assert sg.checkpoint("x")["paths"] == ["imperal_kernel/x.py", "tests/t.py"]
+
+
+# ── field report 06.11 #3: "checkpoint failed (shadow git error)" five times, its cause never shown ──
+def test_a_failed_checkpoint_says_why(tmp_path, monkeypatch):
+    from webbee import checkpoints as cpm
+    from webbee.tools import LocalToolExecutor
+    sg, root = _sg(tmp_path)
+    _write(root, "a.py", "x = 1\n")
+
+    def slow(deadline):
+        raise cpm._Budget()
+    monkeypatch.setattr(sg, "_stage", slow)
+    assert sg.checkpoint("x") is None and "took longer than" in sg.last_error
+    out = LocalToolExecutor(str(root), shadow=sg).run("checkpoint", {"label": "x"})
+    assert out["ok"] is False and "took longer than" in out["content"] and "shadow git error" not in out["content"]
+
+    def git_fails(deadline):
+        sg.last_error = "adding 3 files to the snapshot failed: fatal: unable to index file"
+        return False, [], []
+    monkeypatch.setattr(sg, "_stage", git_fails)
+    assert sg.checkpoint("y") is None and "unable to index file" in sg.last_error
+    monkeypatch.undo()
+    assert sg.checkpoint("z") and sg.last_error == ""                # a good one clears it

{webbee-0.7.8 → webbee-0.7.9}/tests/test_update_badge_0340.py

@@ -68,3 +68,27 @@ def test_check_update_bg_reuses_the_same_cache_file_home_uses(tmp_path):
     asyncio.run(_check_update_bg(state2, fetch=_fetch, cache_path=cache))
     assert calls["n"] == 1
     assert state2["checked"] is True
+
+
+# ── field report 06.11 #3: upgraded during the session, the old process ran on unsaid ──
+def test_an_upgrade_during_the_session_is_said_until_the_restart():
+    import asyncio
+
+    from webbee import __version__
+    from webbee.repl import _installed_watch
+    from webbee.update import installed_version, restart_notice
+    assert restart_notice("0.7.8", "0.7.9").startswith("\U0001f41d webbee v0.7.9 is installed, this session still runs v0.7.8")
+    assert restart_notice("0.7.8", "0.7.8") == "" and restart_notice("0.7.8", "") == ""
+    assert installed_version()                                  # this test's own environment answers
+    state, said = {"notice": ""}, []
+    ticks = iter([None, asyncio.CancelledError()])
+
+    async def sleep(_s):
+        t = next(ticks)
+        if t is not None:
+            raise t
+    try:
+        asyncio.run(_installed_watch(state, invalidate=lambda: said.append(1), read=lambda: "99.0.0", sleep=sleep))
+    except asyncio.CancelledError:
+        pass
+    assert f"v99.0.0 is installed, this session still runs v{__version__}" in state["notice"] and said

webbee-0.7.8/src/webbee/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.7.8"