@maind-dev/mcp-bridge 0.132.1 → 0.134.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -10,7 +10,7 @@ Required for Pro and higher tiers; optional for Free.
10
10
 
11
11
  ## How it works
12
12
 
13
- 1. **First run** opens your browser at `https://maind.dev/devices?code=…` and
13
+ 1. **First run** opens your browser at `https://app.maind.dev/devices?code=…` and
14
14
  prints a short verification code. You sign in (if needed) and click
15
15
  **Approve** — the bridge receives an API key and stores it locally under
16
16
  `~/.config/maind/` (or platform equivalent). A stable device-id is created
@@ -714,6 +714,35 @@ Switch it off with `maind-mcp-bridge activity off`, per session with
714
714
  `MAIND_AGENT_ACTIVITY=off`. `install` asks once (default No); `--agent-activity`
715
715
  enables it without asking.
716
716
 
717
+ ## Local branch state on work objects
718
+
719
+ On by default. A server sees a branch once it is pushed; until then, commits
720
+ and edits exist on one machine only. For every branch that is bound to a work
721
+ object (`branch.<name>.maindObject`, set by `maind feature start` or
722
+ `maind object bind`), the bridge reports with its presence announce:
723
+
724
+ - the branch name and the work object it is bound to,
725
+ - the short hash of its head and the date of its last commit,
726
+ - how many commits no remote-tracking branch reaches (as of the last fetch),
727
+ - how many files are uncommitted — only where the branch is checked out,
728
+ - whether a remote has a branch of this name.
729
+
730
+ Nothing else: no file contents, no commit titles, no file names, no paths. The
731
+ machine is not part of the report; MAIND names it by the paired device of the
732
+ key, or by the `machine_label` you set in `config.json`.
733
+
734
+ **When.** Once per session for all bound branches of the repository the agent
735
+ works in, right after the session became visible; after that only the session's
736
+ own branch, and only when one of the facts changed. The counting runs in the
737
+ background with `git --no-optional-locks` and never delays a tool call.
738
+
739
+ **Who sees it.** You, on the work object. Members of your organization only if
740
+ it enabled coordination visibility. An organization can switch the reports off
741
+ for everyone (Planning policy, "Local work reports"); then nothing is stored.
742
+
743
+ Switch it off on this machine with `"local_branch_report": false` in the
744
+ bridge's `config.json`, per session with `MAIND_LOCAL_BRANCH_REPORT=off`.
745
+
717
746
  ## Where things live
718
747
 
719
748
  | Path | Purpose |
@@ -737,7 +766,7 @@ To rebind the bridge to a different account: delete the directory above (or run
737
766
 
738
767
  **"device_mismatch" on every call.** Another machine has bound this key —
739
768
  the server is doing the right thing by refusing yours. Either unpair the
740
- other device from `https://maind.dev/devices`, or `--reauth` here to bind
769
+ other device from `https://app.maind.dev/devices`, or `--reauth` here to bind
741
770
  this machine and revoke the other.
742
771
 
743
772
  **Browser doesn't open.** The bridge falls back to printing the URL +
@@ -774,6 +803,7 @@ Rarely useful outside maind's own development environments:
774
803
  | `MAIND_CLAUDE_PLUGIN` | unset | Set by the Claude Code plugin's launcher to the plugin's version for every bridge it starts; the bridge then counts its Claude Code hooks as the plugin's (see "Claude Code plugin `maind`"). Not for setting by hand |
775
804
  | `MAIND_DEBUG` | unset | Set to `1` for one diagnostic stderr line on the otherwise silent team-block skip (no `AGENTS.md` with a team block inside the repository) |
776
805
  | `MAIND_AGENT_ACTIVITY` | unset | `on`/`off` overrides `activity on\|off` for one session (see "Agent activity from Claude Code sessions") |
806
+ | `MAIND_LOCAL_BRANCH_REPORT` | `on` | `off` stops the report of local branch state for one session (same as `"local_branch_report": false` in `config.json`; see "Local branch state on work objects") |
777
807
  | `MAIND_DEVIN_HOOK_OUTPUT` | `on` | `off` keeps every hook silent when Devin Local runs it (same as `"devin_hook_output": false` in `config.json`; see "Other hosts") |
778
808
  | `XDG_CONFIG_HOME` | `~/.config` (Linux/BSD) | Parent of the `maind/` config dir |
779
809