chore(release): v3.0.0 (#106)

Prepares v3.0.0: five version files and the changelog. No behaviour
change in this PR.

Major, because `synapse-migrate-room.py` now refuses to run without a
terminal until the caller passes `--yes`. A script or cron entry that
invoked it unattended exits `2` instead of hardening the room. That is
the whole break; everything else in this release is additive or a fix.

## What is in it

**Breaking** — `synapse-migrate-room.py` reads the room's state, prints
the steps it would take with the irreversible one marked, and stops for
confirmation before the first write (#102, #103). It previously started
the pipeline on invocation, and its last step, enabling Megolm
encryption, cannot be undone. `-y` / `--yes` skips the question,
mirroring `synapse-deactivate-user.py`.

**Fixed** — the room log records what a reaction reacts to and what a
redaction removed (#104, #105). It recorded that they happened and
nothing else, so a reader saw `reacted ✅️` and `removed a message` with
no way to tell which message.

**Documentation** — README, `AGENTS.md` and `docs/ARCHITECTURE.md`
describe the watch daemon and the `matrix-nio` pin; the live-awareness
spec describes the relation fields; a dead `LICENSE` link in the
matrix-communication README now points at the two files that exist
(#101).

## Version files

`plugin.json`, `.claude-plugin/plugin.json` and the three `SKILL.md`
files go to 3.0.0 — the same five the v2.0.0 release commit touched.
`package.json` stays at `0.0.0-source`, as it did then.

## Pre-release validation

`validate-pre-release.sh` reports four failures that belong to this
phase — dirty tree, release branch, empty `[Unreleased]`, and
`package.json` counted as a version mismatch — plus three lightweight
tags from the 1.x era (`v1.15.2`, `v1.17.1`, `v1.20.1`) that cannot be
repaired without burning those names. `v2.0.0` is annotated and `v3.0.0`
will be signed.

Unrelated and not fixed here: `CHANGELOG.md` has no footer link
definitions for `[1.25.1]` through `[1.25.4]`, so those four render as
literal text.

Author: CybotTM

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "matrix-communication",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "description": "Agentic Skills for Matrix: client-side chat (matrix-communication), Synapse homeserver administration (matrix-administration), and structured announcement composition (matrix-announcement). Works with any Matrix/Synapse homeserver.",
   "author": {
     "name": "Netresearch DTT GmbH",

CHANGELOG.md

@@ -6,7 +6,9 @@ For the canonical narrative version of each release (rewritten after CI publishe
 
 ## [Unreleased]
 
-### Changed
+## [3.0.0] - 2026-08-13
+
+### Breaking
 
 - **`synapse-migrate-room.py` asks before it changes anything** ([#102]). It read
   no state and asked no question: invoking it started a pipeline whose last step,
@@ -256,7 +258,8 @@ Added the **`matrix-administration` skill** — Synapse server operations (snaps
 
 Older releases (before this changelog was introduced) are documented on the [releases page](https://github.com/netresearch/matrix-skill/releases).
 
-[Unreleased]: https://github.com/netresearch/matrix-skill/compare/v2.0.0...HEAD
+[Unreleased]: https://github.com/netresearch/matrix-skill/compare/v3.0.0...HEAD
+[3.0.0]: https://github.com/netresearch/matrix-skill/compare/v2.0.0...v3.0.0
 [2.0.0]: https://github.com/netresearch/matrix-skill/compare/v1.28.0...v2.0.0
 [1.28.0]: https://github.com/netresearch/matrix-skill/compare/v1.27.1...v1.28.0
 [1.27.1]: https://github.com/netresearch/matrix-skill/compare/v1.27.0...v1.27.1

plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "matrix-communication",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "description": "Agentic Skills for Matrix: client-side chat (matrix-communication), Synapse homeserver administration (matrix-administration), and structured announcement composition (matrix-announcement). Works with any Matrix/Synapse homeserver.",
   "author": {
     "name": "Netresearch DTT GmbH",

skills/matrix-administration/SKILL.md

@@ -5,7 +5,7 @@ license: "(MIT AND CC-BY-SA-4.0). See LICENSE-MIT and LICENSE-CC-BY-SA-4.0"
 compatibility: "python3 (stdlib only) + a Matrix access token belonging to a Synapse server-admin user. Optional: graphviz `dot` for SVG. Synapse 1.x with admin API enabled."
 metadata:
   author: Netresearch DTT GmbH
-  version: "2.0.0"
+  version: "3.0.0"
   repository: https://github.com/netresearch/matrix-skill
 allowed-tools: Bash(python3:*) Bash(uv:*) Bash(dot:*) Read Write
 ---

skills/matrix-announcement/SKILL.md

@@ -5,7 +5,7 @@ license: "(MIT AND CC-BY-SA-4.0). See LICENSE-MIT and LICENSE-CC-BY-SA-4.0"
 compatibility: "Pairs with matrix-communication for sending. Optional: Chromium for HTML-card rendering."
 metadata:
   author: Netresearch DTT GmbH
-  version: "2.0.0"
+  version: "3.0.0"
   repository: https://github.com/netresearch/matrix-skill
 allowed-tools: Bash(chromium:*) Bash(curl:*) Bash(jq:*) Read Write
 ---

skills/matrix-communication/SKILL.md

@@ -5,7 +5,7 @@ license: "(MIT AND CC-BY-SA-4.0). See LICENSE-MIT and LICENSE-CC-BY-SA-4.0"
 compatibility: "Requires python3, uv. Matrix homeserver access."
 metadata:
   author: Netresearch DTT GmbH
-  version: "2.0.0"
+  version: "3.0.0"
   repository: https://github.com/netresearch/matrix-skill
 allowed-tools: Bash(python3:*) Bash(uv:*) Read Write
 ---