webbee 0.7.7__tar.gz → 0.7.9__tar.gz

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

@@ -1,5 +1,24 @@
 # 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,
+  imperal-mcp had no new release, and its environment kept webbee 0.7.6 because only imperal-mcp's version was
+  compared.
+
 ## 0.7.7
 
 * `pipx reinstall webbee` brings the newest release for real (live check of 0.7.6: it still gave 0.7.5).

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: webbee
-Version: 0.7.7
+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.7 → webbee-0.7.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "webbee"
-version = "0.7.7"
+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.7 → webbee-0.7.9}/src/webbee/autoupdate.py

@@ -243,16 +243,17 @@ def mcp_installed(which=safe_which, run=subprocess.run) -> dict:
     real = os.path.realpath(exe)
     py = os.path.join(os.path.dirname(real), "python.exe" if _WINDOWS else "python")
     out = {"tool": tool_of(real), "python": py, "prefix": os.path.dirname(os.path.dirname(real)), "version": "",
-           "code": False}
+           "code": False, "webbee": ""}
     # asked twice when it says "no code extra": a reinstall is never made on one odd answer (live 2026-10-25: right after
     # another install the first answer said no webbee, the next ones yes)
     for _ in range(2):
         try:
             got = run([py, "-c", _NO_CWD + "import importlib.metadata as m, importlib.util as u; "
-                                 "print(m.version('imperal-mcp'), u.find_spec('webbee') is not None)"],
+                                 "w = u.find_spec('webbee') is not None; "
+                                 "print(m.version('imperal-mcp'), w, m.version('webbee') if w else '')"],
                       capture_output=True, text=True, timeout=20)
-            version, code = (str(got.stdout or "").split() + ["", ""])[:2]
-            out.update(version=version, code=code == "True")
+            version, code, webbee = (str(got.stdout or "").split() + ["", "", ""])[:3]
+            out.update(version=version, code=code == "True", webbee=webbee)
         except Exception:
             pass
         if out["code"] or not out["version"]:
@@ -260,14 +261,19 @@ def mcp_installed(which=safe_which, run=subprocess.run) -> dict:
     return out
 
 
-def mcp_command(inst: dict, newest, uv, pipx, wheel=None, source: str = "pypi"):
+def mcp_command(inst: dict, newest, uv, pipx, wheel=None, source: str = "pypi", webbee_newest=None):
     """The one command that makes the shell's imperal-mcp the newest with its code extra -- by the tool that installed
     it (uv, else pipx, for a new install) -- or None when it already is, or nothing can do it. ``source`` "git": from
     the stable branches, imperal-sdk and webbee beside it, and an install recorded by a version is moved onto the
-    branch even when its version is the newest (what ``pipx reinstall`` / ``uv tool upgrade`` would put back)."""
+    branch even when its version is the newest (what ``pipx reinstall`` / ``uv tool upgrade`` would put back). The
+    webbee beside it (its code tools) follows webbee's own releases: one newer than it holds upgrades the environment
+    too (live 2026-11-06: webbee 0.7.7 out, imperal-mcp unchanged, its environment kept webbee 0.7.6)."""
     git = source == "git"
     recorded = bool(inst) and on_stable(inst.get("tool") or "", inst.get("prefix") or "", MCP_ENV_SPECS)
-    if inst and inst.get("version") and inst.get("version") == newest and inst.get("code") and (recorded or not git):
+    behind = git and bool(inst) and bool(inst.get("webbee")) and bool(webbee_newest) \
+        and _ver(inst.get("webbee")) < _ver(webbee_newest)
+    if inst and inst.get("version") and inst.get("version") == newest and inst.get("code") and (recorded or not git) \
+            and not behind:
         return None
     if inst and not inst.get("version"):
         return None                         # it did not answer: a working install is never replaced blind
@@ -512,9 +518,13 @@ def upgrade_before_start(argv, current: str, say=print, fetch=latest, which=safe
                     say(f"🐝 webbee could not update itself -- run: {_show(cmd)}")
         mcp_newest, mcp_source = _newest(MCP, git, fetch, stable)
         inst = mcp_installed(which, run)
-        cmd = mcp_command(inst, mcp_newest, uv, pipx, wheel, source=mcp_source)
+        cmd = mcp_command(inst, mcp_newest, uv, pipx, wheel, source=mcp_source,
+                          webbee_newest=newest if source == "git" else None)
         if cmd:
-            what = (f"imperal-mcp {inst.get('version') or '?'} -> {mcp_newest or 'source'}" if inst
+            what = (f"imperal-mcp {inst.get('version') or '?'} -> {mcp_newest or 'source'}"
+                    + (f", webbee beside it {inst.get('webbee')} -> {newest}"
+                       if source == "git" and inst.get("webbee") and _ver(inst.get("webbee")) < _ver(newest) else "")
+                    if inst
                     else f"imperal-mcp {mcp_newest or 'from source'}") + (" (git, stable)" if mcp_source == "git" else "")
             say(f"🐝 updating {what} ...")
             if _run(cmd, run):

{webbee-0.7.7 → 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.7 → 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.7 → 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.7 → 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.7 → webbee-0.7.9}/tests/test_autoupdate.py

@@ -469,3 +469,21 @@ def test_a_git_release_that_does_not_import_is_put_back_by_its_own_tag(tmp_path,
                             stable=lambda d, git: "0.7.5", prefix=venv)
     assert ["/bin/pipx", "install", "--force", au.git_spec("webbee", "v0.7.4")] in run.calls
     assert any("put 0.7.4 back" in s for s in said)
+
+
+def test_the_webbee_beside_imperal_mcp_follows_webbee_s_releases(tmp_path):
+    uv = tmp_path / "uv" / "tools" / "imperal-mcp"
+    uv.mkdir(parents=True)
+    (uv / "uv-receipt.toml").write_text("".join(
+        f'{{ name = "x", git = "{u}?rev=stable" }}\n' for u in au.REPOS.values()))
+    inst = {"tool": "uv", "python": str(uv / "bin" / "python"), "prefix": str(uv), "version": "0.9.5", "code": True,
+            "webbee": "0.7.6"}
+    assert au.mcp_command(inst, "0.9.5", "/bin/uv", None, source="git", webbee_newest="0.7.6") is None
+    assert au.mcp_command(inst, "0.9.5", "/bin/uv", None, source="git", webbee_newest="0.7.7") == [
+        "/bin/uv", "tool", "install", "--force", "--refresh", "--with", SDK_G, "--with", WB, MCP_G]
+    run = _Run(stdout="0.9.5 True 0.7.6")
+    exe = uv / "bin" / "imperal-mcp"
+    exe.parent.mkdir()
+    exe.write_text("")
+    got = au.mcp_installed(which=lambda n: str(exe), run=run)
+    assert got["webbee"] == "0.7.6" and got["code"] is True

{webbee-0.7.7 → 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.7 → 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.7/src/webbee/__init__.py

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