[ViewVC] Annotation of: cvs/AnyEvent-MCP/Changes

Revision history for AnyEvent::MCP

0.83  (unreleased)
        - allow shell-friendly instance names (ASCII alphanumerics, underscore,
          hyphen, dot, @ and +), with separate strict managed-user names.
        - fold small state-file locking and atomic replacement helper into
          MCP.pm instead of a separate AnyEvent::MCP::File module.
        - make --ask a shared common option, with per-option exclusion;
          add --ask none to deny unresolved permissions and decline
          downstream elicitation without prompting.
        - document mcp-imap login keys individually in --help and manpage;
          support tls connect/starttls/none (including explicit unencrypted IMAP)
          and reset default ports on TLS mode changes.
        - report LOGINDISABLED with no supported SASL mechanism cleanly on
          IMAP password login, without obscure Authen::SASL warnings.
        - add mcp_permissions to Simple: default permission engine, explicit
          object or explicit undef; apply --ask and automatic rule overrides
          centrally without dropping application-supplied automatic rules.
        - give mcp-fs writable private /tmp and /var/tmp (mode 1777) even
          with world-read; only shared-tmp or world-write exposes host
          temporary directories. Make world-write formally imply shared-tmp
          for permission checks; document the private/host lifetime distinction.
        - add read-only mcp-imap previews for 25 UIDs, with bounded partial
          MIME decoding, HTML link preservation and grouped IMAP FETCH calls.
        - allow mcp-imap messages to fetch selected UIDs without SEARCH.
        - actually truncate bounded IMAP part/raw responses to max_bytes,
          not just flag them as truncated.
        - use a 15-second HTTP read-inactivity timeout by default, suspended
          while processing complete requests; respect explicit handle rtimeout.
        - load MIME::Base64 in the HTTP server itself for encoded modern
          Mcp-Name headers, without depending on the HTTP client loading it.
        - log ordinary HTTP 404 responses at trace rather than warn,
          including GET /; keep other HTTP rejection warnings.
        - reuse the latest saved per-dimension scope as the next permission
          rule editor's default where offered, otherwise keep the original
          conservative choice; native, YAD and terminal forms agree.
        - handle the common token-only HTTP endpoint in warning logs:
          redact known tokens without misclassifying unrelated paths.
        - include bounded, JSON-escaped request paths in rejected HTTP request
          warnings; omit queries and redact configured and attempted URL tokens.
        - show captured helper status, stderr and stdout when the permission
          UI test fails, and report remote file-patch results and file content
          when the mock remote filesystem test fails (CPAN Testers diagnostics).

0.82  Fri 06 Nov 2026 15:53:46 CET
        - add a first-permission-dialog walkthrough to Intro.pod, explaining
          one-time versus persistent grants, rule scopes and exec stdin risks;
          correct its description of logical workdir IDs.
        - add common repeatable -s/--set KEY=VALUE process-local overrides
          for trusted instance configuration, after program/instance defaults.
        - key remote mcp-fs host permissions by --host alone, independent of
          --rsh; add independent local/remote host scopes (this host by
          default, or all hosts), retaining old unscoped saved rules.
          Workdir scopes remain plain paths, independent of host.
        - omit single-choice permission scope selectors from native, YAD and
          terminal rule dialogs, automatically retaining the sole match in
          saved rules without broadening their applicability.
        - log rejected HTTP requests (status 400 and above) with method,
          status and peer information, without leaking URL tokens; demote
          ordinary connection/TLS errors to trace.
        - do not warn on routine GET / requests; keep the normal 404
          response without exposing a server-identification page.
        - preserve mcp-vim subprocess stderr when its JSONL initialization
          fails, instead of hiding the failure behind EOF and SIGPIPE.
        - bootstrap remote mcp-fs over a short Perl command, streaming the
          launcher source over stdin. Avoid rsh command length limits and
          preserve worker input across exec by using exact sysread.
        - format mcp-fs sandbox grants, tools, trusted configuration keys
          and permission action classes as individually searchable POD items.
        - give the mock remote filesystem test its running Perl interpreter
          explicitly, rather than assuming it is in a fixed Unix PATH.
        - avoid locale-dependent TCP error strings in reverse-connection tests,
          and skip mcp-imap provider CLI tests when optional fork modules
          are unavailable while retaining standalone provider parser tests.

0.81  Thu 05 Nov 2026 04:51:59 CET
        - keep OAuth2 tests working without optional Mail::IMAPTalk,
          IO::Socket::SSL or Authen::SASL; skip only worker-specific checks.
        - support optional `mount-try.SUFFIX = ro:/path` or `rw:/path` in
          mcp-fs configuration. Pass these directly as bubblewrap
          --ro-bind-try/--bind-try for each invocation, without startup path
          checks, locally and remotely; required mount.* entries are unchanged.
        - support one remote host per mcp-fs instance with -h/--host and
          -e/--rsh; resolve remote workdirs and available tools in a single
          startup probe, then execute existing workers through a binary-framed
          remote Perl launcher without installing any MCP modules remotely.
        - use logical absolute pathnames (without resolving symlinks) as compact
          workdir IDs across hosts; qualify remote permission scopes independently.
          Named profiles remain shared between instances. Report cached remote
          VCS markers and remote umask.
        - reserve -h for application-specific options; --help remains common.
        - test remote workers, external GNU utilities, permission isolation,
          shell argument quoting and startup probing using a mock remote shell
          and bubblewrap, including unsandboxed/auto behavior. Verify matching
          workdir IDs for identical logical paths across local and remote
          instances.
        - make mock remote-agent tests independent of a local SSH_AUTH_SOCK
          inherited from the test runner (including CPAN Testers).
        - document --eager when starting mcp-webbrowser through multibroker;
          defer possible downstream preferences for --eager and --hidden.

0.8   Thu 05 Nov 2026 01:52:48 CET
        - INCOMPATIBLE CHANGE: due to the added user management, existing
          url tokens have been invalidated.
        - limit distribution permission normalization to its staging
          directory, and supply proper CPAN author and abstract metadata.
        - give shared command-line switches their own reference in
          Server::Simple; use individually indexed POD items for executable
          options and application-specific shared-option behavior.
        - refresh the introductory guide and mcp-imap/mcp-http manuals
          with first-use workflows, OAuth2 setup, mailbox/search examples
          and reverse-TLS troubleshooting; correct stale retry documentation.
        - extend mcp-imap SEARCH filters with recursive AND/OR/NOT, header,
          text/body, date, size and flag criteria; use explicitly quoted
          IMAP arguments and bounded filter complexity.
        - capture deliberately triggered connection errors in test assertions,
          avoiding noisy successful test runs.
        - expose IMAP LSUB to inspect subscribed mailboxes, alongside
          subscribe/unsubscribe; return the same format as LIST.
        - remove superseded IMAP OAuth provider and pagination prototypes
          and their obsolete reference tests.
        - defer outgoing mail submission research (mcp-smtp or mcp-imap)
          in TODO.md.
        - retry reverse connections only for TCP connection refusal and
          unexpected disconnects; report and stop on other TCP errors or
          TLS handshake/verification failures.
        - force scalar context when checking Mail::IMAPTalk results;
          list context truncated LIST responses and could corrupt SEARCH
          results. Test with context-sensitive IMAP mocks.
        - report HTTPS reverse-connection handshake failures rather than
          silently retrying; send credentials only after verified TLS succeeds.
        - omit pointless mailbox permission dimension for mcp-imap mailboxes.
        - clarify expected OAuth redirect error page and account selection.
        - implement mcp-imap OAuth2 authorization-code login with PKCE,
          human-pasted headless browser redirect, HTTPS token exchange,
          refresh-token persistence/rotation and IMAP SASL XOAUTH2.
          Keep interactive credentials outside MCP tools and argv.
        - omit unnecessary shell quotes in mcp-imap providers commands.
        - expand mcp-imap providers with Thunderbird ISPDB domain search,
          provider-hosted HTTPS autoconfig lookup and ISPDB fallback,
          password-based IMAP alternatives and provider setup instructions;
          continue printing optional OAuth configuration without saving it.
        - add per-downstream --hidden to mcp-multibroker, omitting a
          server's tools from normal discovery while retaining explicit
          list-tools, discover-brokers and call-tool access.
        - number the user management test consecutively as t/27_users.t.
        - tidy Perl import grouping, internal comments and source layout
          in the command-line tools and library modules.
        - stop imposing an IMAP account file mode check; access is governed
          by ordinary filesystem permissions.
        - use the permission engine's literal matching convention for exact
          user identities and test positive permission-scope validation.
        - reject invalid browser WebSocket credentials via the documented
          handshake exception interface, producing one specific warning.
        - apply the same handshake rejection handling to Vim WebSocket
          connections, including peer and invalid-token/path warnings.
        - document user-management scopes and URL examples in command help.
        - add scoped, revocable MCP users with HKDF-derived credentials,
          an implicit global default user, and atomic user management;
          list effective user URLs with --print-url[=USER], also accepting
          --print-urls, without binding the advertised listener port.
        - associate HTTP credentials with per-request users, bind user
          identity to persistent permissions and permission continuations,
          and delegate original users through trusted multibrokers.
        - select the effective connect_user (default: default) for reverse
          MCP, private Vim and browser connections, independently of normal
          authenticated HTTP tool calls.
        - treat empty directory paths as "." in mcp-fs list, find, grep and
          VCS cwd, without accepting empty filenames.
        - support opportunistic HTTP/HTTPS and reverse MCP connections on the
          same listener, TLS certificate/key CLI options, and dual URL discovery;
          support verified HTTPS for outgoing reverse connections.
        - treat idle HTTP disconnects as normal EOF while retaining errors
          for clients disconnecting during request headers or bodies.
        - identify failing MCP connections by client name, remote address
          and connection id, including modern per-request client metadata.
        - trace local multibroker prompt starts, outcomes and cancellations
          with elapsed time to diagnose disappearing permission dialogs.
        - use an 8 MiB default MCP message size across JSONL and HTTP
          clients and servers, allowing large base64 tool requests through
          mcp-multibroker; log server transport errors at warn level
          instead of silently closing connections.
        - load AnyEvent::Log at compile time so its format_time call is parsed
          as a function, fixing activity logging on Perl 5.10.

0.71  Fri 30 Oct 2026 18:01:51 CET
        - make multibroker-spawned children ask for permissions through MCP,
          independently of the multibroker's own permission prompt mode.
        - log VCS backend and a bounded, JSON-quoted preview of filenames for
          vcs-diff, vcs-status and vcs-log.
        - load only core modules in t/00_load.t; optional IMAP dependencies
          are tested separately when available.
        - let the fake bubblewrap test use the host temporary directory on
          systems without /tmp (notably Termux).
        - suppress Perl startup locale warnings in sandbox workers when
          the requested C.UTF-8 locale is unavailable.
        - canonicalize temporary test paths to match mcp-fs on systems with
          symlinked temp directories; diagnose failing filesystem assertions.
        - test SSE notification ordering at client delivery rather than
          server enqueue time, avoiding a network scheduling race.
        - diagnose failing multibroker HTTP integration tests with preflight
          responses, RPC results and bounded server startup diagnostics.

0.7   Fri 30 Oct 2026 14:56:18 CET
        - WARNING: mcp-imap is unfinished and has not been tested against a real IMAP server.
        - INCOMPATIBLE CHANGE: rules have changed, old rules will be erased.
        - declare the same license terms as Perl itself in distribution metadata.
        - new mcp servers in this release: mcp-http
        - accept optional dimension default matcher for persistent-rule prompts;
        - clarify that mcp-fs exec has private /tmp by default; shared-tmp
          exposes host /tmp and is not needed for ordinary temporary files or IPC.
        - add mcp-fs vcs-log for Git, SVN, CVS and Mercurial, reusing bounded
          output and dedicated permission actions; SVN log receives network
          and SSH-agent grants alongside CVS operations.
          mcp-webbrowser prefers any JavaScript in the current tab, while the
          independent origin dimension remains scoped to the current origin.
        - log mcp-http requests with their method and a sanitized URL preview;
          identify mcp-http/$VERSION in User-Agent unless overridden by the caller.
          Allow generic key=value context in the shared mcp_log_request formatter.
        - silently treat invalid saved permission-rule files as empty, prompting
          instead of aborting broker startup; subsequent saves replace the old file.
        - add mcp-http for arbitrary HTTP methods with URL-scoped approvals,
          caller-managed cookie jars, bounded bodies and text grep/regex/substitution.
          Disable redirects, retries and proxies; verify HTTPS certificates.
        - derive browser permission origins from reported URLs, not a new
          userscript field; keep older browser clients able to execute with
          origin-scoped permissions.
        - accept compatible browser-protocol minor versions; return empty
          operation discovery for 1.0 clients instead of disconnecting them.
          Direct rule saves no longer perform semantic validation.
        - replace special-case subject, origin and workdir permission scopes with
          named dimensions: metadata-driven prompts, generic match.NAME rule keys,
          and engine-enforced matcher choices. Reject old request and rule fields;
          no conversion or backward-compatible rule loading.
        - preserve selected origin scopes when external permission helpers
          forward persistent decisions through native MCP elicitation.
        - add origin-scoped MCP permission rules, selectable independently of
          code/tab scopes; mcp-webbrowser derives browser origins for
          JavaScript and tab operations, with exact, any-port and any-origin
          choices. Existing rules without origins continue to match all origins.
        - use POSIX::uname instead of nonportable hostname -f for the XPCSE
          browser nickname, consistent with HTTP URL wildcard host selection.
        - make form helper test run via explicit ./ path, avoid early HTTP
          timer races, and test filesystem discovery with optional tools absent.
        - report browser protocol rejections through bounded WebSocket close
          reasons; show abnormal disconnects in the userscript console and toast.
        - document browser wire-protocol minor-version compatibility: accept
          compatible older and newer clients without breaking base functionality.
        - remove the obsolete private stdio permission-result bridge from
          mcp-multibroker; use ordinary form elicitation.
        - add per-tab operation discovery and calls to mcp-webbrowser, with
          per-tab routing, ordinary MCP permissions and browser protocol 1.1;
          the userscript initially advertises no extra operations.
        - make the unsandboxed-warning test tolerate diagnostic output from
          non-GNU utility probes (FreeBSD and BusyBox).
        - add mcp-imap with one named password-authenticated account per instance,
          bounded UID search, MIME reads, explicit mailbox/message mutations,
          UIDPLUS-only targeted expunge, forked worker and MCP permissions.
        - propagate XPCSE save response ETags back to Vim session metadata;
          make stale upload HTTP status an editor error.
        - require GNU sed in worker tool discovery; report missing-Perl diagnostics in tests.
        - xpcse: forward Vim's :write! flag through mcp-vim to browser
          uploads, without changing upload behavior yet.
        - recommend rather than require WebSocket modules: only mcp-vim and
          mcp-webbrowser use them; mcp-vim loads them only for browser clients,
          and tests skip optional WebSocket coverage when unavailable.

0.65  Fri 23 Oct 2026 22:41:32 CEST
        - fix mcp-webbrowser userscript title indicator duplicating prefixes on empty titles.
        - use built scripts in make test PATH, avoiding source shebangs and
          accidentally installed helpers in rule management tests.
        - clarify browser execute code wrapper and reject function/symbol return
          values instead of silently converting them to null.
        - fix many bugs in the testsuite.

0.62  Thu 22 Oct 2026 13:32:52 CEST
        - INCOMPATIBLE API CHANGE: mcp_getoptions now returns a hash reference instead of
          a key/value list.
        - Simple accepts server_name/server_version independently of the local
          instance name, leaving server_info as an unmodified protocol override.
        - query multibroker children in parallel for tool and broker discovery,
          preserving tool order and returning partial results after 15 seconds
          instead of blocking on an unresponsive child.
        - accept a missing trailing slash on HTTP MCP endpoint URLs, working
          around Claude's MCP connector wrongly dropping it from the configured URL,
          thus corrupting it.
        - allow omitted ports in reverse extension URLs, defaulting to port 80.
        - fix MCP client/server version fields serialized as JSON numbers in 0.61.

0.61  Thu 22 Oct 2026 08:57:42 CEST
        - resolve bind hostnames via AnyEvent::Socket instead of Socket::getaddrinfo.
        - honor user-selected file permissions and preserve them across replacements.
        - fix permission test fixture grants.
        - fix activity log timestamp formatting on older perl versions.
        - correct multibroker test tool count (including meta-instructions).
        - fix perl 5.12 syntax errors in mcp-fs and mcp-vim.

0.6  Wed 21 Oct 2026 20:43:20 CEST
        - 34k LOC of pure llm madness. but seems to work. yay.

0.0  Sat 03 Oct 2026 07:29:39 CEST
        - original version, an AnyEvent::HTTP clone.
Revision:	1.71
Committed:	Sat Nov 7 04:23:08 2026 UTC (98 minutes, 21 seconds ago) by root
Branch:	MAIN
CVS Tags:	HEAD
Changes since 1.70:	+5 -0 lines
Log Message:	* empty log message *
#	User	Rev	Content
1	root	1.2	Revision history for AnyEvent::MCP
2
3	root	1.64	0.83 (unreleased)
4	root	1.69	- allow shell-friendly instance names (ASCII alphanumerics, underscore,
5			hyphen, dot, @ and +), with separate strict managed-user names.
6			- fold small state-file locking and atomic replacement helper into
7			MCP.pm instead of a separate AnyEvent::MCP::File module.
8			- make --ask a shared common option, with per-option exclusion;
9			add --ask none to deny unresolved permissions and decline
10			downstream elicitation without prompting.
11	root	1.71	- document mcp-imap login keys individually in --help and manpage;
12			support tls connect/starttls/none (including explicit unencrypted IMAP)
13			and reset default ports on TLS mode changes.
14			- report LOGINDISABLED with no supported SASL mechanism cleanly on
15			IMAP password login, without obscure Authen::SASL warnings.
16	root	1.70	- add mcp_permissions to Simple: default permission engine, explicit
17			object or explicit undef; apply --ask and automatic rule overrides
18			centrally without dropping application-supplied automatic rules.
19	root	1.68	- give mcp-fs writable private /tmp and /var/tmp (mode 1777) even
20			with world-read; only shared-tmp or world-write exposes host
21			temporary directories. Make world-write formally imply shared-tmp
22			for permission checks; document the private/host lifetime distinction.
23			- add read-only mcp-imap previews for 25 UIDs, with bounded partial
24			MIME decoding, HTML link preservation and grouped IMAP FETCH calls.
25			- allow mcp-imap messages to fetch selected UIDs without SEARCH.
26			- actually truncate bounded IMAP part/raw responses to max_bytes,
27			not just flag them as truncated.
28	root	1.67	- use a 15-second HTTP read-inactivity timeout by default, suspended
29			while processing complete requests; respect explicit handle rtimeout.
30			- load MIME::Base64 in the HTTP server itself for encoded modern
31			Mcp-Name headers, without depending on the HTTP client loading it.
32	root	1.66	- log ordinary HTTP 404 responses at trace rather than warn,
33			including GET /; keep other HTTP rejection warnings.
34	root	1.65	- reuse the latest saved per-dimension scope as the next permission
35			rule editor's default where offered, otherwise keep the original
36			conservative choice; native, YAD and terminal forms agree.
37			- handle the common token-only HTTP endpoint in warning logs:
38			redact known tokens without misclassifying unrelated paths.
39			- include bounded, JSON-escaped request paths in rejected HTTP request
40			warnings; omit queries and redact configured and attempted URL tokens.
41	root	1.64	- show captured helper status, stderr and stdout when the permission
42			UI test fails, and report remote file-patch results and file content
43			when the mock remote filesystem test fails (CPAN Testers diagnostics).
44
45	root	1.63	0.82 Fri 06 Nov 2026 15:53:46 CET
46			- add a first-permission-dialog walkthrough to Intro.pod, explaining
47			one-time versus persistent grants, rule scopes and exec stdin risks;
48			correct its description of logical workdir IDs.
49	root	1.62	- add common repeatable -s/--set KEY=VALUE process-local overrides
50			for trusted instance configuration, after program/instance defaults.
51			- key remote mcp-fs host permissions by --host alone, independent of
52			--rsh; add independent local/remote host scopes (this host by
53			default, or all hosts), retaining old unscoped saved rules.
54			Workdir scopes remain plain paths, independent of host.
55			- omit single-choice permission scope selectors from native, YAD and
56			terminal rule dialogs, automatically retaining the sole match in
57			saved rules without broadening their applicability.
58	root	1.60	- log rejected HTTP requests (status 400 and above) with method,
59			status and peer information, without leaking URL tokens; demote
60	root	1.61	ordinary connection/TLS errors to trace.
61	root	1.62	- do not warn on routine GET / requests; keep the normal 404
62			response without exposing a server-identification page.
63			- preserve mcp-vim subprocess stderr when its JSONL initialization
64			fails, instead of hiding the failure behind EOF and SIGPIPE.
65	root	1.57	- bootstrap remote mcp-fs over a short Perl command, streaming the
66			launcher source over stdin. Avoid rsh command length limits and
67			preserve worker input across exec by using exact sysread.
68	root	1.58	- format mcp-fs sandbox grants, tools, trusted configuration keys
69			and permission action classes as individually searchable POD items.
70	root	1.62	- give the mock remote filesystem test its running Perl interpreter
71			explicitly, rather than assuming it is in a fixed Unix PATH.
72			- avoid locale-dependent TCP error strings in reverse-connection tests,
73			and skip mcp-imap provider CLI tests when optional fork modules
74			are unavailable while retaining standalone provider parser tests.
75	root	1.57
76	root	1.56	0.81 Thu 05 Nov 2026 04:51:59 CET
77	root	1.55	- keep OAuth2 tests working without optional Mail::IMAPTalk,
78			IO::Socket::SSL or Authen::SASL; skip only worker-specific checks.
79			- support optional `mount-try.SUFFIX = ro:/path` or `rw:/path` in
80			mcp-fs configuration. Pass these directly as bubblewrap
81			--ro-bind-try/--bind-try for each invocation, without startup path
82			checks, locally and remotely; required mount.* entries are unchanged.
83			- support one remote host per mcp-fs instance with -h/--host and
84			-e/--rsh; resolve remote workdirs and available tools in a single
85			startup probe, then execute existing workers through a binary-framed
86			remote Perl launcher without installing any MCP modules remotely.
87	root	1.56	- use logical absolute pathnames (without resolving symlinks) as compact
88			workdir IDs across hosts; qualify remote permission scopes independently.
89			Named profiles remain shared between instances. Report cached remote
90			VCS markers and remote umask.
91	root	1.55	- reserve -h for application-specific options; --help remains common.
92			- test remote workers, external GNU utilities, permission isolation,
93			shell argument quoting and startup probing using a mock remote shell
94			and bubblewrap, including unsandboxed/auto behavior. Verify matching
95	root	1.56	workdir IDs for identical logical paths across local and remote
96	root	1.55	instances.
97			- make mock remote-agent tests independent of a local SSH_AUTH_SOCK
98			inherited from the test runner (including CPAN Testers).
99			- document --eager when starting mcp-webbrowser through multibroker;
100			defer possible downstream preferences for --eager and --hidden.
101
102	root	1.53	0.8 Thu 05 Nov 2026 01:52:48 CET
103	root	1.49	- INCOMPATIBLE CHANGE: due to the added user management, existing
104			url tokens have been invalidated.
105	root	1.54	- limit distribution permission normalization to its staging
106			directory, and supply proper CPAN author and abstract metadata.
107	root	1.52	- give shared command-line switches their own reference in
108			Server::Simple; use individually indexed POD items for executable
109			options and application-specific shared-option behavior.
110	root	1.51	- refresh the introductory guide and mcp-imap/mcp-http manuals
111			with first-use workflows, OAuth2 setup, mailbox/search examples
112			and reverse-TLS troubleshooting; correct stale retry documentation.
113	root	1.50	- extend mcp-imap SEARCH filters with recursive AND/OR/NOT, header,
114			text/body, date, size and flag criteria; use explicitly quoted
115			IMAP arguments and bounded filter complexity.
116			- capture deliberately triggered connection errors in test assertions,
117			avoiding noisy successful test runs.
118	root	1.49	- expose IMAP LSUB to inspect subscribed mailboxes, alongside
119			subscribe/unsubscribe; return the same format as LIST.
120			- remove superseded IMAP OAuth provider and pagination prototypes
121			and their obsolete reference tests.
122	root	1.51	- defer outgoing mail submission research (mcp-smtp or mcp-imap)
123			in TODO.md.
124	root	1.48	- retry reverse connections only for TCP connection refusal and
125			unexpected disconnects; report and stop on other TCP errors or
126			TLS handshake/verification failures.
127			- force scalar context when checking Mail::IMAPTalk results;
128			list context truncated LIST responses and could corrupt SEARCH
129			results. Test with context-sensitive IMAP mocks.
130			- report HTTPS reverse-connection handshake failures rather than
131			silently retrying; send credentials only after verified TLS succeeds.
132			- omit pointless mailbox permission dimension for mcp-imap mailboxes.
133			- clarify expected OAuth redirect error page and account selection.
134			- implement mcp-imap OAuth2 authorization-code login with PKCE,
135			human-pasted headless browser redirect, HTTPS token exchange,
136			refresh-token persistence/rotation and IMAP SASL XOAUTH2.
137			Keep interactive credentials outside MCP tools and argv.
138			- omit unnecessary shell quotes in mcp-imap providers commands.
139			- expand mcp-imap providers with Thunderbird ISPDB domain search,
140			provider-hosted HTTPS autoconfig lookup and ISPDB fallback,
141			password-based IMAP alternatives and provider setup instructions;
142			continue printing optional OAuth configuration without saving it.
143	root	1.47	- add per-downstream --hidden to mcp-multibroker, omitting a
144			server's tools from normal discovery while retaining explicit
145			list-tools, discover-brokers and call-tool access.
146	root	1.46	- number the user management test consecutively as t/27_users.t.
147	root	1.45	- tidy Perl import grouping, internal comments and source layout
148			in the command-line tools and library modules.
149			- stop imposing an IMAP account file mode check; access is governed
150			by ordinary filesystem permissions.
151	root	1.44	- use the permission engine's literal matching convention for exact
152			user identities and test positive permission-scope validation.
153			- reject invalid browser WebSocket credentials via the documented
154			handshake exception interface, producing one specific warning.
155			- apply the same handshake rejection handling to Vim WebSocket
156			connections, including peer and invalid-token/path warnings.
157			- document user-management scopes and URL examples in command help.
158	root	1.43	- add scoped, revocable MCP users with HKDF-derived credentials,
159			an implicit global default user, and atomic user management;
160			list effective user URLs with --print-url[=USER], also accepting
161			--print-urls, without binding the advertised listener port.
162			- associate HTTP credentials with per-request users, bind user
163			identity to persistent permissions and permission continuations,
164			and delegate original users through trusted multibrokers.
165			- select the effective connect_user (default: default) for reverse
166			MCP, private Vim and browser connections, independently of normal
167			authenticated HTTP tool calls.
168	root	1.42	- treat empty directory paths as "." in mcp-fs list, find, grep and
169			VCS cwd, without accepting empty filenames.
170	root	1.41	- support opportunistic HTTP/HTTPS and reverse MCP connections on the
171			same listener, TLS certificate/key CLI options, and dual URL discovery;
172			support verified HTTPS for outgoing reverse connections.
173	root	1.39	- treat idle HTTP disconnects as normal EOF while retaining errors
174			for clients disconnecting during request headers or bodies.
175			- identify failing MCP connections by client name, remote address
176			and connection id, including modern per-request client metadata.
177	root	1.38	- trace local multibroker prompt starts, outcomes and cancellations
178			with elapsed time to diagnose disappearing permission dialogs.
179			- use an 8 MiB default MCP message size across JSONL and HTTP
180			clients and servers, allowing large base64 tool requests through
181			mcp-multibroker; log server transport errors at warn level
182			instead of silently closing connections.
183	root	1.37	- load AnyEvent::Log at compile time so its format_time call is parsed
184			as a function, fixing activity logging on Perl 5.10.
185
186	root	1.36	0.71 Fri 30 Oct 2026 18:01:51 CET
187	root	1.35	- make multibroker-spawned children ask for permissions through MCP,
188			independently of the multibroker's own permission prompt mode.
189	root	1.36	- log VCS backend and a bounded, JSON-quoted preview of filenames for
190			vcs-diff, vcs-status and vcs-log.
191			- load only core modules in t/00_load.t; optional IMAP dependencies
192			are tested separately when available.
193			- let the fake bubblewrap test use the host temporary directory on
194			systems without /tmp (notably Termux).
195			- suppress Perl startup locale warnings in sandbox workers when
196			the requested C.UTF-8 locale is unavailable.
197			- canonicalize temporary test paths to match mcp-fs on systems with
198			symlinked temp directories; diagnose failing filesystem assertions.
199			- test SSE notification ordering at client delivery rather than
200			server enqueue time, avoiding a network scheduling race.
201			- diagnose failing multibroker HTTP integration tests with preflight
202			responses, RPC results and bounded server startup diagnostics.
203	root	1.35
204	root	1.34	0.7 Fri 30 Oct 2026 14:56:18 CET
205			- WARNING: mcp-imap is unfinished and has not been tested against a real IMAP server.
206			- INCOMPATIBLE CHANGE: rules have changed, old rules will be erased.
207			- declare the same license terms as Perl itself in distribution metadata.
208			- new mcp servers in this release: mcp-http
209			- accept optional dimension default matcher for persistent-rule prompts;
210	root	1.33	- clarify that mcp-fs exec has private /tmp by default; shared-tmp
211			exposes host /tmp and is not needed for ordinary temporary files or IPC.
212	root	1.32	- add mcp-fs vcs-log for Git, SVN, CVS and Mercurial, reusing bounded
213			output and dedicated permission actions; SVN log receives network
214			and SSH-agent grants alongside CVS operations.
215	root	1.31	mcp-webbrowser prefers any JavaScript in the current tab, while the
216			independent origin dimension remains scoped to the current origin.
217	root	1.30	- log mcp-http requests with their method and a sanitized URL preview;
218			identify mcp-http/$VERSION in User-Agent unless overridden by the caller.
219	root	1.31	Allow generic key=value context in the shared mcp_log_request formatter.
220	root	1.29	- silently treat invalid saved permission-rule files as empty, prompting
221			instead of aborting broker startup; subsequent saves replace the old file.
222	root	1.30	- add mcp-http for arbitrary HTTP methods with URL-scoped approvals,
223			caller-managed cookie jars, bounded bodies and text grep/regex/substitution.
224			Disable redirects, retries and proxies; verify HTTPS certificates.
225			- derive browser permission origins from reported URLs, not a new
226			userscript field; keep older browser clients able to execute with
227			origin-scoped permissions.
228			- accept compatible browser-protocol minor versions; return empty
229			operation discovery for 1.0 clients instead of disconnecting them.
230	root	1.29	Direct rule saves no longer perform semantic validation.
231	root	1.28	- replace special-case subject, origin and workdir permission scopes with
232			named dimensions: metadata-driven prompts, generic match.NAME rule keys,
233			and engine-enforced matcher choices. Reject old request and rule fields;
234			no conversion or backward-compatible rule loading.
235	root	1.27	- preserve selected origin scopes when external permission helpers
236			forward persistent decisions through native MCP elicitation.
237	root	1.26	- add origin-scoped MCP permission rules, selectable independently of
238	root	1.30	code/tab scopes; mcp-webbrowser derives browser origins for
239	root	1.26	JavaScript and tab operations, with exact, any-port and any-origin
240			choices. Existing rules without origins continue to match all origins.
241	root	1.25	- use POSIX::uname instead of nonportable hostname -f for the XPCSE
242			browser nickname, consistent with HTTP URL wildcard host selection.
243			- make form helper test run via explicit ./ path, avoid early HTTP
244			timer races, and test filesystem discovery with optional tools absent.
245	root	1.23	- report browser protocol rejections through bounded WebSocket close
246			reasons; show abnormal disconnects in the userscript console and toast.
247			- document browser wire-protocol minor-version compatibility: accept
248			compatible older and newer clients without breaking base functionality.
249			- remove the obsolete private stdio permission-result bridge from
250			mcp-multibroker; use ordinary form elicitation.
251	root	1.22	- add per-tab operation discovery and calls to mcp-webbrowser, with
252			per-tab routing, ordinary MCP permissions and browser protocol 1.1;
253			the userscript initially advertises no extra operations.
254			- make the unsandboxed-warning test tolerate diagnostic output from
255			non-GNU utility probes (FreeBSD and BusyBox).
256			- add mcp-imap with one named password-authenticated account per instance,
257			bounded UID search, MIME reads, explicit mailbox/message mutations,
258			UIDPLUS-only targeted expunge, forked worker and MCP permissions.
259	root	1.21	- propagate XPCSE save response ETags back to Vim session metadata;
260			make stale upload HTTP status an editor error.
261			- require GNU sed in worker tool discovery; report missing-Perl diagnostics in tests.
262	root	1.18	- xpcse: forward Vim's :write! flag through mcp-vim to browser
263			uploads, without changing upload behavior yet.
264	root	1.19	- recommend rather than require WebSocket modules: only mcp-vim and
265			mcp-webbrowser use them; mcp-vim loads them only for browser clients,
266			and tests skip optional WebSocket coverage when unavailable.
267	root	1.18
268	root	1.17	0.65 Fri 23 Oct 2026 22:41:32 CEST
269	root	1.14	- fix mcp-webbrowser userscript title indicator duplicating prefixes on empty titles.
270	root	1.17	- use built scripts in make test PATH, avoiding source shebangs and
271			accidentally installed helpers in rule management tests.
272	root	1.15	- clarify browser execute code wrapper and reject function/symbol return
273			values instead of silently converting them to null.
274	root	1.17	- fix many bugs in the testsuite.
275	root	1.13
276	root	1.12	0.62 Thu 22 Oct 2026 13:32:52 CEST
277	root	1.16	- INCOMPATIBLE API CHANGE: mcp_getoptions now returns a hash reference instead of
278			a key/value list.
279	root	1.11	- Simple accepts server_name/server_version independently of the local
280			instance name, leaving server_info as an unmodified protocol override.
281			- query multibroker children in parallel for tool and broker discovery,
282			preserving tool order and returning partial results after 15 seconds
283			instead of blocking on an unresponsive child.
284	root	1.8	- accept a missing trailing slash on HTTP MCP endpoint URLs, working
285	root	1.10	around Claude's MCP connector wrongly dropping it from the configured URL,
286	root	1.18	thus corrupting it.
287	root	1.7	- allow omitted ports in reverse extension URLs, defaulting to port 80.
288	root	1.9	- fix MCP client/server version fields serialized as JSON numbers in 0.61.
289	root	1.7
290	root	1.6	0.61 Thu 22 Oct 2026 08:57:42 CEST
291	root	1.5	- resolve bind hostnames via AnyEvent::Socket instead of Socket::getaddrinfo.
292	root	1.4	- honor user-selected file permissions and preserve them across replacements.
293			- fix permission test fixture grants.
294			- fix activity log timestamp formatting on older perl versions.
295			- correct multibroker test tool count (including meta-instructions).
296			- fix perl 5.12 syntax errors in mcp-fs and mcp-vim.
297
298	root	1.3	0.6 Wed 21 Oct 2026 20:43:20 CEST
299	root	1.2	- 34k LOC of pure llm madness. but seems to work. yay.
300	root	1.1
301			0.0 Sat 03 Oct 2026 07:29:39 CEST
302			- original version, an AnyEvent::HTTP clone.