ctrlrelay 0.16.0__tar.gz → 0.16.1__tar.gz

{ctrlrelay-0.16.0 → ctrlrelay-0.16.1}/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.16.1] - 2026-11-01
+
+Fixes the chat bridge, which did not start on 0.16.0. **No config edit is
+required.** If you upgraded to 0.16.0, upgrade to this.
+
+### Fixed
+
+- `ctrlrelay bridge start` (what the bridge service runs) exited at startup
+  on 0.16.0 with `BridgeServer.__init__() missing 1 required keyword-only
+  argument: 'node'`, for Telegram and Mattermost alike, so chat questions
+  and answers stopped. It now passes the machine's name and the shared
+  setting, like `python -m ctrlrelay.bridge` (#265)
+
+### Changed
+
+- The bridge's systemd unit is described as "ctrlrelay chat bridge
+  (Telegram or Mattermost)", and the docs call it the chat bridge. An
+  installed unit keeps its old description until it is re-rendered (#266)
+
 ## [0.16.0] - 2026-11-01
 
 Several machines can now run ctrlrelay on one GitHub account, each claiming
@@ -1957,7 +1976,8 @@ pipeline).
   per-phase implementation plans (Phase 0 through Phase 4).
 - `docs/Claude_Code_Project_Guide.md` — project development guide.
 
-[Unreleased]: https://github.com/AInvirion/ctrlrelay/compare/v0.16.0...HEAD
+[Unreleased]: https://github.com/AInvirion/ctrlrelay/compare/v0.16.1...HEAD
+[0.16.1]: https://github.com/AInvirion/ctrlrelay/compare/v0.16.0...v0.16.1
 [0.16.0]: https://github.com/AInvirion/ctrlrelay/compare/v0.15.0...v0.16.0
 [0.15.0]: https://github.com/AInvirion/ctrlrelay/compare/v0.14.0...v0.15.0
 [0.14.0]: https://github.com/AInvirion/ctrlrelay/compare/v0.13.0...v0.14.0

{ctrlrelay-0.16.0 → ctrlrelay-0.16.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ctrlrelay
-Version: 0.16.0
+Version: 0.16.1
 Summary: Local-first orchestrator for headless coding agents across multiple GitHub repos
 Project-URL: Homepage, https://github.com/AInvirion/ctrlrelay
 Project-URL: Documentation, https://ainvirion.github.io/ctrlrelay/
@@ -128,11 +128,11 @@ are on the roadmap (see [Roadmap](#roadmap)).
       new issue  │       │  blocked session
                  │       │
       ┌──────────▼──┐  ┌─▼───────────────────┐
-      │ dev pipeline│  │ Telegram bridge     │
-      │ in worktree │  │ (socket ↔ bot API)  │
+      │ dev pipeline│  │ chat bridge         │
+      │ in worktree │  │ (socket ↔ chat API) │
       │ agent CLI   │  └──────────┬──────────┘
       └──────┬──────┘             │
-             │ PR opened          │ DM you
+             │ PR opened          │ asks you
              ▼                    ▼
       ┌────────────┐         ┌─────────┐
       │ PR watcher │         │   You   │
@@ -207,7 +207,7 @@ Run as a supervised daemon (launchd on macOS / systemd on Linux) — see
 
 - [Getting started][docs-start]
 - [Configuration][docs-config]
-- [Telegram bridge][docs-bridge]
+- [Chat bridge (Telegram or Mattermost)][docs-bridge]
 - [Feedback loop][docs-feedback]
 - [CLI reference][docs-cli]
 - [Operations (launchd / systemd / scheduled jobs)][ops-docs]

{ctrlrelay-0.16.0 → ctrlrelay-0.16.1}/README.md

@@ -87,11 +87,11 @@ are on the roadmap (see [Roadmap](#roadmap)).
       new issue  │       │  blocked session
                  │       │
       ┌──────────▼──┐  ┌─▼───────────────────┐
-      │ dev pipeline│  │ Telegram bridge     │
-      │ in worktree │  │ (socket ↔ bot API)  │
+      │ dev pipeline│  │ chat bridge         │
+      │ in worktree │  │ (socket ↔ chat API) │
       │ agent CLI   │  └──────────┬──────────┘
       └──────┬──────┘             │
-             │ PR opened          │ DM you
+             │ PR opened          │ asks you
              ▼                    ▼
       ┌────────────┐         ┌─────────┐
       │ PR watcher │         │   You   │
@@ -166,7 +166,7 @@ Run as a supervised daemon (launchd on macOS / systemd on Linux) — see
 
 - [Getting started][docs-start]
 - [Configuration][docs-config]
-- [Telegram bridge][docs-bridge]
+- [Chat bridge (Telegram or Mattermost)][docs-bridge]
 - [Feedback loop][docs-feedback]
 - [CLI reference][docs-cli]
 - [Operations (launchd / systemd / scheduled jobs)][ops-docs]

{ctrlrelay-0.16.0 → ctrlrelay-0.16.1}/SECURITY.md

@@ -25,7 +25,7 @@ mitigation within **14 days** for high-severity issues.
 In-scope:
 
 - The `ctrlrelay` CLI and its pipelines (`dev`, `secops`, scheduled jobs).
-- The Telegram bridge and socket transport.
+- The chat bridge (Telegram or Mattermost) and socket transport.
 - Anything in `src/` and `config/`.
 
 Out-of-scope:

{ctrlrelay-0.16.0 → ctrlrelay-0.16.1}/docs/cli.md

@@ -27,7 +27,7 @@ ctrlrelay [--version] <command> ...
 | `ctrlrelay status` | Show active locks and the 5 most-recent sessions. |
 | `ctrlrelay config ...` | Configuration helpers. |
 | `ctrlrelay skills ...` | Skill discovery / audit. |
-| `ctrlrelay bridge ...` | Manage the Telegram bridge daemon. |
+| `ctrlrelay bridge ...` | Manage the chat bridge daemon (Telegram or Mattermost). |
 | `ctrlrelay run ...` | Run a pipeline interactively. |
 | `ctrlrelay ci ...` | CI helpers used by the dev pipeline prompt. |
 | `ctrlrelay poller ...` | Manage the issue-poller daemon. |
@@ -128,7 +128,7 @@ Lists discovered skills as a table (name, path).
 
 ## `ctrlrelay bridge`
 
-See [Telegram bridge]({{ '/bridge/' | relative_url }}) for the full setup walkthrough.
+See [Chat bridge]({{ '/bridge/' | relative_url }}) for the full setup walkthrough.
 
 ### `bridge start`
 

{ctrlrelay-0.16.0 → ctrlrelay-0.16.1}/docs/configuration.md

@@ -302,7 +302,7 @@ transport:
 | Key | Type | Required | Default | Description |
 |---|---|---|---|---|
 | `type` | enum | no | `"file_mock"` | One of `"telegram"`, `"mattermost"`, `"file_mock"`. |
-| `telegram` | object | required when `type=telegram` | — | Telegram bridge settings — see below. |
+| `telegram` | object | required when `type=telegram` | — | Telegram settings — see below. |
 | `mattermost` | object | required when `type=mattermost` | — | Mattermost bridge settings — see below. |
 | `file_mock` | object | required when `type=file_mock` | — | Local-file fake transport, used for tests/dev. |
 
@@ -321,7 +321,7 @@ reach anybody.
 | `question_ttl_seconds` | int | `172800` (48h) | How long an **unanswered** question stays routable before it is retired. Minimum `3600`. Without a ceiling those rows never die — a question whose PR was merged by hand weeks ago stays a live target for an orphan reply. The hourly `question_expiry_sweeper` also retires a question early once every issue/PR it cites is closed or merged. |
 | `question_retention_days` | int | `90` | How long a **finished** question (expired, or answered and resumed) is kept before the hourly sweeper deletes it. Minimum `1`. Open questions are never deleted. The kept history is what lets a re-asked question be marked as a repeat. |
 
-See [Telegram bridge]({{ '/bridge/' | relative_url }}) for the full setup walkthrough.
+See [Chat bridge]({{ '/bridge/' | relative_url }}) for the full setup walkthrough.
 
 ### transport.mattermost
 

{ctrlrelay-0.16.0 → ctrlrelay-0.16.1}/docs/development.md

@@ -52,7 +52,7 @@ pytest --cov=src/ctrlrelay --cov-report=term-missing
 `pyproject.toml` sets `pythonpath = ["src"]` and `testpaths = ["tests"]` so
 pytest finds the package without an extra install step on a fresh checkout.
 
-The Telegram bridge tests stub the network — no real bot token is required to
+The chat bridge tests stub the network — no real bot token is required to
 run the suite. Tests that exercise the dev / secops pipelines use the
 `file_mock` transport so they stay hermetic.
 
@@ -112,7 +112,7 @@ ctrlrelay/
 │   ├── cli.py                   # Typer CLI entry point
 │   ├── core/                    # Dispatcher, worktree, state, config, ...
 │   ├── pipelines/               # dev, secops, post_merge
-│   ├── bridge/                  # Telegram bridge daemon
+│   ├── bridge/                  # chat bridge daemon (Telegram, Mattermost)
 │   ├── transports/              # SocketTransport, FileMockTransport
 │   └── dashboard/               # Optional dashboard push client
 ├── tests/                       # pytest suites (one file per module)

{ctrlrelay-0.16.0 → ctrlrelay-0.16.1}/docs/getting-started.md

@@ -24,7 +24,7 @@ and running the dev pipeline against a real GitHub issue. Allow about 15 minutes
 Optional:
 
 - [`uv`](https://github.com/astral-sh/uv) for faster installs.
-- A Telegram bot if you want the human-in-the-loop bridge — see [Telegram bridge]({{ '/bridge/' | relative_url }}).
+- A Telegram bot or a Mattermost server if you want the human-in-the-loop bridge — see [Chat bridge]({{ '/bridge/' | relative_url }}).
 
 ## Install
 
@@ -127,8 +127,8 @@ What happens:
 
 If Claude blocks asking a question, the answer mechanism only works when a
 transport is connected. With `file_mock`, you'll see the question on the console
-but cannot resume. Switch to the Telegram transport to actually answer — see
-[Telegram bridge]({{ '/bridge/' | relative_url }}) and [Feedback loop]({{ '/feedback-loop/' | relative_url }}).
+but cannot resume. Switch to the Telegram or Mattermost transport to actually
+answer — see [Chat bridge]({{ '/bridge/' | relative_url }}) and [Feedback loop]({{ '/feedback-loop/' | relative_url }}).
 
 ## Your first poller tick
 
@@ -151,7 +151,7 @@ To run the poller as a long-lived background service, see [Operations]({{ '/oper
 ## Where to next
 
 - [Configuration]({{ '/configuration/' | relative_url }}) — every key in `orchestrator.yaml`.
-- [Telegram bridge]({{ '/bridge/' | relative_url }}) — how to set up the human-in-the-loop channel.
+- [Chat bridge]({{ '/bridge/' | relative_url }}) — how to set up the human-in-the-loop channel.
 - [Feedback loop]({{ '/feedback-loop/' | relative_url }}) — what `BLOCKED_NEEDS_INPUT` actually does end-to-end.
 - [CLI reference]({{ '/cli/' | relative_url }}) — every subcommand and flag.
 - [Operations]({{ '/operations/' | relative_url }}) — running ctrlrelay as a service.

{ctrlrelay-0.16.0 → ctrlrelay-0.16.1}/docs/index.md

@@ -26,8 +26,8 @@ isolated git worktree, opens a PR, and asks you on Telegram when it gets stuck.
   write your first config, run the dev pipeline against an issue.
 - **[Configuration]({{ '/configuration/' | relative_url }})** — every key in
   `orchestrator.yaml`, with defaults and what they actually do.
-- **[Telegram bridge]({{ '/bridge/' | relative_url }})** — BotFather walkthrough,
-  starting the bridge, troubleshooting Telegram delivery.
+- **[Chat bridge]({{ '/bridge/' | relative_url }})** — setting up Telegram or
+  Mattermost, starting the bridge, troubleshooting delivery.
 - **[Feedback loop]({{ '/feedback-loop/' | relative_url }})** — how
   `BLOCKED_NEEDS_INPUT` checkpoints reach you and how your reply resumes the
   paused Claude session.

{ctrlrelay-0.16.0 → ctrlrelay-0.16.1}/docs/operations.md

@@ -184,7 +184,7 @@ installer uses. Save under `~/.config/systemd/user/`.
 
 ```ini
 [Unit]
-Description=ctrlrelay Telegram bridge
+Description=ctrlrelay chat bridge (Telegram or Mattermost)
 After=network-online.target
 
 [Service]

{ctrlrelay-0.16.0 → ctrlrelay-0.16.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ctrlrelay"
-version = "0.16.0"
+version = "0.16.1"
 description = "Local-first orchestrator for headless coding agents across multiple GitHub repos"
 readme = "README.md"
 requires-python = ">=3.12"

{ctrlrelay-0.16.0 → ctrlrelay-0.16.1}/src/ctrlrelay/cli.py

@@ -1846,10 +1846,14 @@ def bridge_start(
         from ctrlrelay.core.state import StateDB
         state_db = StateDB(config.paths.state_db)
 
+        # #248: this machine's name on every post, and whether other
+        # machines read the same chat (Mattermost only).
         server = BridgeServer(
             socket_path=socket_path,
             handler=handler,
             state_db=state_db,
+            node=config.node_id,
+            shared=bool(getattr(chat_config, "shared", False)),
         )
 
         loop = asyncio.new_event_loop()

{ctrlrelay-0.16.0 → ctrlrelay-0.16.1}/src/ctrlrelay/templates/systemd/bridge.service.template

@@ -1,5 +1,5 @@
 [Unit]
-Description=ctrlrelay Telegram bridge
+Description=ctrlrelay chat bridge (Telegram or Mattermost)
 After=network-online.target
 
 [Service]

ctrlrelay-0.16.1/tests/test_bridge_start_command.py

@@ -0,0 +1,63 @@
+"""``ctrlrelay bridge start --foreground`` builds the bridge it is meant to.
+
+0.16.0 shipped with this command constructing ``BridgeServer`` without the
+``node`` argument #248 made required, so the bridge exited at startup on
+every machine. The ``python -m ctrlrelay.bridge`` path had it; this one did
+not, and nothing ran the command.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import pytest
+from typer.testing import CliRunner
+
+
+@pytest.mark.parametrize("transport,shared", [
+    ("telegram", False),
+    ("mattermost", True),
+])
+def test_bridge_start_names_this_machine(
+    tmp_path: Path, monkeypatch, transport: str, shared: bool,
+) -> None:
+    import ctrlrelay.bridge as bridge
+    from ctrlrelay.cli import app
+
+    built: dict = {}
+
+    class FakeServer:
+        def __init__(self, socket_path, handler, state_db=None, *, node, shared=False):
+            built.update(node=node, shared=shared)
+
+        async def start(self) -> None:
+            return None
+
+        async def stop(self) -> None:
+            return None
+
+    monkeypatch.setattr(bridge, "BridgeServer", FakeServer)
+    monkeypatch.setattr(bridge, "make_handler", lambda _t: object())
+    if transport == "telegram":
+        block = (
+            f'transport: {{type: telegram, telegram: {{bot_token_env: "T", '
+            f'chat_id: 1, socket_path: "{tmp_path}/b.sock"}}}}\n'
+        )
+    else:
+        block = (
+            f'transport: {{type: mattermost, mattermost: {{url: "https://chat.example.com", '
+            f'bot_token_env: "T", channel_id: "abcdefghijklmnopqrstuvwxyz", '
+            f'shared: true, socket_path: "{tmp_path}/b.sock"}}}}\n'
+        )
+    cfg = tmp_path / "orchestrator.yaml"
+    cfg.write_text(
+        'version: "1"\nnode_id: "node-a"\n'
+        f'paths: {{state_db: "{tmp_path}/s.db", worktrees: "{tmp_path}/w", '
+        f'bare_repos: "{tmp_path}/r", contexts: "{tmp_path}/c", skills: "{tmp_path}/k"}}\n'
+        + block
+    )
+    result = CliRunner().invoke(
+        app, ["bridge", "start", "--foreground", "-c", str(cfg)],
+    )
+    assert result.exit_code == 0, result.output + repr(result.exception)
+    assert built == {"node": "node-a", "shared": shared}

{ctrlrelay-0.16.0 → ctrlrelay-0.16.1}/tests/test_install.py

@@ -352,3 +352,14 @@ class TestInstallCli:
         assert result.exit_code == 0, result.output
         assert (target_dir / "ctrlrelay-bridge.service").exists()
         assert (target_dir / "ctrlrelay-poller.service").exists()
+
+
+def test_the_bridge_unit_names_the_chat_bridge_not_one_provider(tmp_path) -> None:
+    """The bridge serves Telegram or Mattermost; its unit says so."""
+    from ctrlrelay.install import render_systemd
+
+    [bridge] = [
+        u for u in render_systemd(workdir=tmp_path, target_dir=tmp_path)
+        if u.service == "bridge"
+    ]
+    assert "Description=ctrlrelay chat bridge (Telegram or Mattermost)" in bridge.content