interlatch 0.28.2__tar.gz → 0.28.3__tar.gz

{interlatch-0.28.2 → interlatch-0.28.3}/CHANGELOG.md

@@ -3,6 +3,24 @@
 <!-- Don't add lines here: a pull request puts its line in a new file in changelog.d/ (see changelog.d/README.md),
      and each release moves the files it took into a dated section below. -->
 
+## 0.28.2 (2026-10-20)
+
+- **Several hubs: connect your groups.** `interlatch profile` became `interlatch hubs` and `interlatch group`: add a
+  hub (`interlatch hubs add Acme <address> --code <code>`), then connect a group of projects to it
+  (`interlatch group connect "Acme work" Acme`). What the group holds goes to that hub, and changing the group on the
+  dashboard's Projects page moves its sessions with it. A project taken out of a connected group waits for you
+  instead of going back to Personal. `--profile` is now `--hub`; the old name still works
+  ([Several hubs on one computer](docs/profiles.md)).
+- **Several hubs on the dashboard.** Settings › Devices › Hubs lists this computer's hubs and their groups, adds and
+  joins one, and settles folders that wait for you; a group's page has **Goes to**, which connects the group to a hub
+  ([Several hubs on one computer](docs/profiles.md)).
+- **Moving a folder takes its sessions back from the hub that had them.** When a group, a project or a waiting folder
+  moves to another hub (or a group is disconnected), the hub it left takes back the sessions this computer sent it,
+  before anything goes to the new one. One that can't be reached takes them back at the next send. Home now shows
+  folders that wait for you to choose a hub under **Needs you**
+  ([Moving takes sessions back](docs/profiles.md#moving-takes-sessions-back)). Update your hubs too: an older hub
+  can't take sessions back.
+
 ## 0.28.1 (2026-10-19)
 
 - **Profiles, first stage:** `interlatch profile create Acme --owns ~/work/acme` makes a named profile that owns a

{interlatch-0.28.2 → interlatch-0.28.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: interlatch
-Version: 0.28.2
+Version: 0.28.3
 Summary: Shared memory for your coding agents: records every session (Claude Code, Codex, Copilot, Bob, Antigravity, OpenCode) locally and keeps what they learned, each lesson linked to the session it came from.
 Project-URL: Homepage, https://interlatch.com
 Project-URL: Documentation, https://interlatch.com/docs/

interlatch-0.28.3/changelog.d/hubs-page.md

@@ -0,0 +1,4 @@
+- **Settings › Hubs.** Each hub this computer sends to has its own card: whether sending works, the last share,
+  **Share now**, its dashboard (signed in as that hub's link), joining and leaving it. The Projects sidebar names the
+  hub each group goes to and lists folders waiting for a hub first, and the status bar names every hub
+  ([Several hubs on one computer](docs/profiles.md)).

{interlatch-0.28.2 → interlatch-0.28.3}/docs/ja/profiles.md

@@ -29,7 +29,7 @@
 
 グループのフォルダーですでに記録されたセッションは Acme に移り、それ以降は Acme のハブに送られます。Personal のハブがすでに持っているものは、先にそのハブが取り下げます（[移すとハブから取り下げる](#moving-takes-sessions-back)）。`--dry-run` を付けると、何も変えずに、移るものと、そのうちハブが持っている数を表示します。
 
-**ダッシュボードでは：** **設定 › デバイス › ハブ**でハブを追加し（名前、アドレス、招待コード）、グループのページの**送り先**で、そのグループのセッションを送るハブを選びます。
+**ダッシュボードでは：** **設定 › ハブ**に、ハブごとのカードがあります。送信がうまくいっているか、最後に送った時刻、**今すぐ共有**、ハブのダッシュボード、参加と脱退です。ハブの追加（名前、アドレス、招待コード）もここで行います。グループのページの**送り先**で、そのグループのセッションを送るハブを選びます。**プロジェクト**のサイドバーでは、ハブにつないだグループにそのハブの名前が表示され、選択を待つフォルダーが先頭に並びます。
 
 ほかのコンピューターと同じく、ハブに送られるのは、そのハブのプロジェクトに追加したフォルダーのものだけです（`interlatch --hub Acme hub add-folder ~/work/acme/app --project App`）。`--all-folders` を付けて参加した場合は別です。
 
@@ -67,7 +67,7 @@ interlatch group choose ~/work/acme/notes Acme       # または personal
 interlatch group where ~/work/acme/app               # フォルダーがどのハブに行くか、その理由
 ```
 
-**設定 › デバイス › ハブ**にも一覧があり、それぞれに**選ぶ**ボタンがあります。**ホーム**の**あなたの対応待ち**にも表示されます。あるフォルダーが選択待ちにしているプロジェクト（つないだグループの中にある、どのハブにもつないでいないグループ）は、そのフォルダーの下にまとめて表示します。
+**設定 › ハブ**にも一覧があり、それぞれに**選ぶ**ボタンがあります。**ホーム**の**あなたの対応待ち**にも表示されます。あるフォルダーが選択待ちにしているプロジェクト（つないだグループの中にある、どのハブにもつないでいないグループ）は、そのフォルダーの下にまとめて表示します。
 
 ## エージェントに見えるもの
 

{interlatch-0.28.2 → interlatch-0.28.3}/docs/profiles.md

@@ -37,8 +37,10 @@ The sessions already recorded in the group's folders move to Acme, and go to Acm
 Personal's hub already has, it takes back first (see [Moving takes sessions back](#moving-takes-sessions-back)).
 `--dry-run` shows what would move, and how many of them a hub has, without changing anything.
 
-**On the dashboard:** **Settings › Devices › Hubs** adds a hub (its name, address and invite code), and a group's page
-has **Goes to**, where you pick the hub its sessions go to.
+**On the dashboard:** **Settings › Hubs** has a card for each hub: whether sending to it works, when it last got
+something, **Share now**, its dashboard, and joining or leaving it. It also adds a hub (its name, address and invite
+code). A group's page has **Goes to**, where you pick the hub its sessions go to. In the **Projects** sidebar, a group
+connected to a hub shows that hub's name, and folders waiting for you are listed first.
 
 As on any computer, a hub gets only the folders added to one of its projects
 (`interlatch --hub Acme hub add-folder ~/work/acme/app --project App`), unless you joined with `--all-folders`.
@@ -84,7 +86,7 @@ interlatch group choose ~/work/acme/notes Acme       # or: personal
 interlatch group where ~/work/acme/app               # who gets a folder, and why
 ```
 
-**Settings › Devices › Hubs** lists them too, with a **Choose** for each, and **Home** shows them under **Needs you**. Projects a folder holds waiting (a group
+**Settings › Hubs** lists them too, with a **Choose** for each, and **Home** shows them under **Needs you**. Projects a folder holds waiting (a group
 connected to no hub inside a connected one) are listed once, under that folder.
 
 ## What agents see

{interlatch-0.28.2 → interlatch-0.28.3}/src/interlatch/core/i18n/ja.py

@@ -482,4 +482,5 @@ JA: dict[str, str] = {
     "Pick a project to move.": "移動するプロジェクトを選んでください。",
     "This computer doesn't send to a hub.": "このコンピューターはハブに送っていません。",
     "Chronicle is now Interlatch. Updating moves this install from the agents-chronicle package to interlatch; the chronicle command keeps working.": "Chronicle は Interlatch になりました。更新すると、このインストールは agents-chronicle パッケージから interlatch に移ります。chronicle コマンドはそのまま使えます。",
+    "{hub} hasn't joined a hub yet.": "{hub} はまだハブに参加していません。",
 }

{interlatch-0.28.2 → interlatch-0.28.3}/src/interlatch/interfaces/cli/commands/sharing.py

@@ -199,7 +199,10 @@ def cmd_hub(args) -> int:
             console.print(f"Joined the hub at {url}, sharing knowledge only. This computer keeps recording and "
                           "analyzing its own sessions; the hub gets each analyzed session's summary and project "
                           "lessons. Transcripts and lessons about you stay here.", highlight=False)
-            if cfg.hub_all_folders:
+            if cfg.hub_all_folders and cfg.owner != "personal":  # another hub: it gets what its groups hold
+                console.print("It shares sessions from every folder its groups hold (--all-folders): nothing until you "
+                              "connect a group to it (`interlatch group connect <group> <hub>`).", highlight=False)
+            elif cfg.hub_all_folders:
                 console.print("It shares sessions from every folder on this computer (--all-folders).", highlight=False)
             elif not args.code or got.get("projects") is None:  # a limited person heard which projects above
                 console.print("Only sessions in the hub's projects are shared: add your folder for each one with "

{interlatch-0.28.2 → interlatch-0.28.3}/src/interlatch/interfaces/web/api/hubs.py

@@ -1,8 +1,9 @@
-"""Several hubs on one computer (docs/profiles.md), on the dashboard: Settings › Devices › Hubs lists them and what
-waits for you; a group's page connects the group to one. application.profiles does the work."""
+"""Several hubs on one computer (docs/profiles.md), on the dashboard: Settings › Hubs lists them, how each one's sending
+goes and what waits for you; a group's page connects the group to one. application.profiles does the work."""
 
 from __future__ import annotations
 
+from ....core.i18n import tr
 from ..context import Context
 
 
@@ -22,6 +23,7 @@ def hubs(ctx: Context) -> dict:
         return {"error": str(exc), "hubs": [], "groups": [], "waiting": []}
     hubs = [r for r in rows if r["id"] != "waiting"]
     for r in hubs:
+        r.update(_sending(_hub_cfg(ctx, r["id"], reg)))
         r.pop("home", None)  # this computer's folders: not needed to show them
     gs = []
     for g in groups(ctx.conn):
@@ -30,6 +32,31 @@ def hubs(ctx: Context) -> dict:
     return {"hubs": hubs, "groups": gs, "waiting": _waiting(waiting(ctx.conn), reg)}
 
 
+def _hub_cfg(ctx: Context, hub_id: str, reg):
+    """The config that sends to hub `hub_id`: Personal's, or that hub's own folder's (None: no such hub)."""
+    from ....core.config import load_config
+
+    if hub_id == "personal":
+        return ctx.cfg
+    p = reg.profiles.get(hub_id) if reg else None
+    return load_config(p.home, create=False) if p and (p.home / "config.toml").exists() else None
+
+
+def _sending(cfg) -> dict:
+    """How sending to the hub goes, as Settings › Devices shows it for Personal's: the hub's name as it last said, the
+    last share, a problem worth a warning, and the teammates' lessons it sent back."""
+    from ....sharing.projects import last_folders
+    from ....sharing.pull import last_team
+    from ....sharing.push import last_push, send_problem
+
+    if cfg is None or not cfg.is_spoke:
+        return {"joined": False}
+    pushed = last_push(cfg)
+    return {"joined": True, "hub_name": (last_folders(cfg) or {}).get("hub"), "share": cfg.hub_share,
+            "all_folders": cfg.hub_all_folders, "last_push": pushed, "push_problem": send_problem(pushed),
+            "team_lessons": (last_team(cfg) or {}).get("lessons")}
+
+
 def _waiting(rows: list[dict], reg=None) -> list[dict]:
     """What waits, one entry per choice to make: the projects a folder holds waiting (a group connected to no hub
     inside a connected one, a project picked out of one) together under that folder, with how many projects and
@@ -51,7 +78,8 @@ def _waiting(rows: list[dict], reg=None) -> list[dict]:
 
 def action_hubs(ctx: Context, verb: str, body: dict) -> tuple[dict, int]:
     """add (name, and optionally address and code to join it), remove, connect (group, hub; personal disconnects),
-    choose (folder, hub or personal). A change the hubs can't make says why, 409, and changes nothing."""
+    choose (folder, hub or personal), push (hub: share with it now), leave (hub: stop sending to it). A change the hubs
+    can't make says why, 409, and changes nothing."""
     from ....application import profiles as ops
     from ....core.profiles import RegistryError
     from ....projects.groups import GroupError
@@ -87,6 +115,24 @@ def action_hubs(ctx: Context, verb: str, body: dict) -> tuple[dict, int]:
                 moved = ops.connect(ctx.cfg, body.get("group"), hub, leave_on_hub=leave)
             return {"ok": True, "moved": sum(moved.sessions.values()), "taken": sum(moved.taken.values()),
                     "to": {moved.labels.get(k, k): v for k, v in moved.to.items()}}, 200
+        if verb in ("push", "leave"):
+            key = str(body.get("hub") or "")
+            reg = ctx.cfg.profiles
+            hub_id = "personal" if key.strip().casefold() == "personal" else ops.find_profile(ctx.cfg.home, key).id
+            hcfg = _hub_cfg(ctx, hub_id, reg)
+            if hcfg is None or not hcfg.is_spoke:
+                return {"error": tr("{hub} hasn't joined a hub yet.", hub=key)}, 409
+            if verb == "push":
+                from ....sharing.push import push
+
+                return {"ok": True, "started": ctx.jobs.start("push", lambda progress: push(hcfg, progress=progress)
+                                                                 .summary())}, 200
+            from ....sharing.client import leave_hub
+
+            left = leave_hub(hcfg)
+            if hub_id == "personal":
+                ctx.cfg = left
+            return {"ok": True, "hub": hcfg.hub_url}, 200
         if verb == "choose":
             moved = ops.choose(ctx.cfg, str(body.get("folder") or ""), str(body.get("hub") or ""), leave_on_hub=leave)
             return {"ok": True, "moved": sum(moved.sessions.values()), "taken": sum(moved.taken.values())}, 200

{interlatch-0.28.2 → interlatch-0.28.3}/src/interlatch/interfaces/web/api/status.py

@@ -156,12 +156,13 @@ def status_small(ctx: Context, limited: bool = False) -> dict:
     if limited:  # the hub's own queue, jobs and updates are not theirs to see
         return {"pending": {"ready": 0, "queued": 0}, "analysis": {"auto": False, "max_per_run": 0, "label": ""}, "paused_until": None,
                 "last_sync": None, "jobs": {}, "version": __version__, "update": None, "ui_build": UI_BUILD,
-                "hub_url": None, "hub_problem": None, "limited": True}
+                "hub_url": None, "hub_urls": [], "hub_problem": None, "limited": True}
 
     recall(ctx.conn)  # a check made by another dashboard process, or before a restart
     _maybe_check_daily(ctx)
 
     pending = count_pending(ctx.conn, ctx.cfg)
+    sending = _sending_to(ctx)
     return {
         "pending": pending,
         "analysis": {"auto": ctx.cfg.analysis.auto, "max_per_run": ctx.cfg.analysis.max_per_run,
@@ -175,14 +176,35 @@ def status_small(ctx: Context, limited: bool = False) -> dict:
         "update": available(),
         "ui_build": UI_BUILD,
         "hub_url": ctx.cfg.hub_url or None,  # set on a computer that sends its sessions to a hub
-        "hub_problem": _hub_problem(ctx),  # its pushes don't get through: the status bar warns
+        "hub_urls": [c.hub_url for c in sending],  # and the other hubs it sends to (docs/profiles.md)
+        "hub_problem": _hub_problem(sending),  # its pushes don't get through: the status bar warns
     }
 
 
-def _hub_problem(ctx: Context) -> dict | None:
+def _sending_to(ctx: Context) -> list:
+    """The configs that send to a hub: Personal's (when it joined one), then each other hub this computer joined."""
+    from ....application.profiles import joined
+
+    return ([ctx.cfg] if ctx.cfg.is_spoke else []) + joined(ctx.cfg)
+
+
+def _hub_problem(sending: list) -> dict | None:
+    """The first hub whose sends don't get through, with its name when it isn't Personal's (`profile`)."""
+    from ....core.profiles import PERSONAL
     from ....sharing.push import last_push, send_problem
 
-    return send_problem(last_push(ctx.cfg)) if ctx.cfg.is_spoke else None
+    for cfg in sending:
+        if problem := send_problem(last_push(cfg)):
+            if cfg.owner != PERSONAL:
+                from ....core.profiles import RegistryError
+
+                try:
+                    reg = cfg.profiles
+                except RegistryError:
+                    reg = None
+                problem["profile"] = reg.label(cfg.owner) if reg else cfg.owner
+            return problem
+    return None
 
 
 def status(ctx: Context) -> dict:

{interlatch-0.28.2 → interlatch-0.28.3}/src/interlatch/interfaces/web/routes.py

@@ -363,8 +363,17 @@ def _hub_signin(h, ctx, m, body):
     from ...sharing.client import dashboard_signin
     from ...sharing.protocol import HubError
 
+    cfg = ctx.cfg
+    if str(body.get("hub") or "personal").strip().casefold() != "personal":  # another hub: signed in as its own link
+        from ...application.profiles import ProfileError, find_profile
+        from ...core.config import load_config
+
+        try:
+            cfg = load_config(find_profile(ctx.cfg.home, str(body["hub"])).home, create=False)
+        except ProfileError as exc:
+            return h._json({"error": str(exc)}, 400)
     try:
-        return h._json({"url": dashboard_signin(ctx.cfg, page=body.get("next"))})
+        return h._json({"url": dashboard_signin(cfg, page=body.get("next"))})
     except HubError as exc:
         return h._json({"error": tr(str(exc))}, 400)
 
@@ -430,7 +439,7 @@ POST: list[Route] = [
     Route(r"/api/projects/shared/(add|remove)", HERE_OR_HUB_ADMIN, lambda h, ctx, m, b: h._json(
         *api.devices.action_shared_project(ctx, m.group(1), _body(b), by=h.viewer, here=h._from_here()))),
     # which hub each group goes to, and joining one: what leaves this computer, only from here
-    Route(r"/api/hubs/(add|join|remove|connect|choose)", HERE,
+    Route(r"/api/hubs/(add|join|remove|connect|choose|push|leave)", HERE,
           lambda h, ctx, m, b: h._json(*api.hubs.action_hubs(ctx, m.group(1), _body(b)))),
     Route("/api/project-groups/share", HERE,  # what leaves this computer: only from here
           lambda h, ctx, m, b: h._json(*api.projects.action_project_groups(ctx, "share", _body(b)))),

{interlatch-0.28.2 → interlatch-0.28.3}/src/interlatch/web/app.css

@@ -2336,6 +2336,12 @@ td.pg-cell { width: 1%; text-align: right; }
 /* On a computer that sends to a hub: the hub's projects, each over the folders here that go to it (projectsSidebar) */
 .sb-hub-head .sb-hub-ic { flex: none; width: 14px; height: 14px; margin-left: -4px; color: var(--hub-ink); }
 .sb-row.sb-hubproj { font-weight: 600; }
+/* a group connected to another hub names it; folders waiting for a hub come first (docs/profiles.md) */
+.sb-fold-head .sb-hub-badge { flex: none; max-width: 45%; display: inline-flex; align-items: center; gap: 3px; padding: 0 6px; border-radius: 999px;
+  font-size: 11px; font-weight: 600; line-height: 18px; color: var(--hub-ink); background: color-mix(in srgb, var(--hub-ink) 12%, transparent); }
+.sb-hub-badge .icon { flex: none; width: 11px; height: 11px; }
+.sb-wait-head .sb-wait-ic { flex: none; width: 14px; height: 14px; margin-left: -4px; color: var(--warning-ink); }
+.sb-waiting > .sb-row .icon { color: var(--warning-ink); }
 .sb-row.sb-hubproj .sb-ext { display: none; width: 12px; height: 12px; }
 .sb-row.sb-hubproj:is(:hover, :focus-visible) .sb-ext { display: block; }
 .sb-row.sb-hubproj:is(:hover, :focus-visible) em { display: none; }