matterbridge-example-dynamic-platform 3.0.4-dev-20260914-aab53d4 → 3.0.4-dev-20260929-c03806e

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.
Files changed (4) hide show
  1. package/CHANGELOG.md +15 -6
  2. package/README.md +51 -18
  3. package/npm-shrinkwrap.json +2 -2
  4. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -37,19 +37,28 @@ If you like this project and find it useful, please consider giving it a star on
37
37
 
38
38
  ### Added
39
39
 
40
+ - [devcontainer]: Add [`Dev Container`](.devcontainer/README.md) v.2.2.0 with dual Node and Bun runtime support.
41
+ - [agents]: Add a [`shared setup`](.agents/README.md) for all agents: OpenAI Codex, Claude Code, GitHub Copilot and Google Gemini / Antigravity.
40
42
  - [platform]: Add `RfidLock` device: a door lock with the User, PinCredential, and RfidCredential (RID) features, testing the `numberOfRfidUsersSupported` parameter of `createUserPinDoorLockClusterServer()` (Matter 1.6.0 § 5.2.4). `SetCredential`, `GetCredentialStatus`, and `ClearCredential` already handle `DoorLock.CredentialType.Rfid` generically in `MatterbridgeDoorLockServer`, so no RFID-specific command handlers were needed for this device.
41
43
  - [Oven]/[Refrigerator]: Add a `TemperatureAlarm` example to the demo cabinets.
42
- - [devcontainer]: Upgrade the `Dev Container` to v.2.1.0, using the Node.js and Bun stack.
43
44
  - [Momentary switch]: Report `productId` `0x8000` on the composed `Momentary switch` bridged device, so Home Assistant's `(vendorId, productId)` allowlist can match the `ha_entitylabel` FixedLabels on `switch4`/`switch5`/`switch6` (requires matterbridge's `createDefaultBridgedDeviceBasicInformationClusterServer()` optional `productId` parameter).
45
+ - [agents]: Add [`commit message instructions`](.github/commit-message-instructions.md) v.1.0.0 for the VS Code Copilot "Generate Commit Message" button (Conventional Commits).
44
46
 
45
47
  ### Changed
46
48
 
49
+ - [vscode]: Update `.vscode/settings.json` to v.1.0.13: point the Copilot "Generate Commit Message" button to `.github/commit-message-instructions.md`.
50
+ - [styleguide]: Update [`STYLEGUIDE.md`](STYLEGUIDE.md) to v.1.1.0: align it with the lint and format config and add the Commit Messages and Changelog sections.
51
+ - [scripts]: Update `scripts/clean.mjs` and `scripts/deep-clean.mjs` to v.1.3.0: log every removed path, add `--help` and `--version` and reject unknown arguments.
47
52
  - [package]: Upgrade package.
48
- - [package]: Update dependencies.
49
- - [package]: Bump `@types/node` to v.26.4.1.
50
- - [package]: Bump `@vitest/coverage-v8` and `vitest` to v.5.0.0.
51
- - [package]: Bump `oxfmt` to v.0.66.0.
52
- - [package]: Bump `oxlint` to v.1.81.0.
53
+ - [package]: Bump `node-ansi-logger` to v.3.3.1.
54
+ - [package]: Bump `node-persist-manager` to v.2.1.1.
55
+ - [package]: Bump `oxfmt` to v.0.71.0.
56
+ - [package]: Bump `oxlint` to v.1.86.0.
57
+ - [package]: Bump `oxlint-tsgolint` to v.7.0.2003.
58
+ - [package]: Bump `vitest` to v.5.0.2.
59
+ - [package]: Bump `@vitest/coverage-v8` to v.5.0.2.
60
+ - [package]: Bump `@types/node` to v.26.6.3.
61
+ - [package]: Bump `typescript` to v.7.0.2.
53
62
 
54
63
  <a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/assets/bmc-button.svg" alt="Buy me a coffee" width="80"></a>
55
64
 
package/README.md CHANGED
@@ -137,37 +137,70 @@ See also the [Style Guide](./STYLEGUIDE.md) for JSDoc, naming, and logging conve
137
137
  - **Much faster builds** — tsgo compiles the project in a fraction of the time required by the standard `tsc` build.
138
138
  - **Editor support** — use the VS Code extensions for tsgo and oxc to get the same experience in the editor.
139
139
 
140
- ## Copilot instructions
140
+ ## Shared agent instructions
141
+
142
+ All coding agents read the same guidance. [AGENTS.md](./AGENTS.md) and [.agents/](./.agents/) are the **single source of truth**; everything under `.github/`, `.claude/`, `.codex/` and `.antigravity/` are pointers and mirrors. Edit `.agents/` (or `AGENTS.md`), never the copies. See [.agents/README.md](./.agents/README.md) for the full layout.
143
+
144
+ | File | Notes |
145
+ | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
146
+ | `AGENTS.md` | Main project instructions — shared by every agent |
147
+ | `.agents/README.md` | Layout and versioning of the shared instructions |
148
+ | `.agents/rules/testing.instructions.md` | Testing standards for unit tests |
149
+ | `.agents/rules/matterbridge.instructions.md` | Creating endpoints and using the single-class devices |
150
+ | `.agents/rules/plugin-frontend.instructions.md` | Serving a plugin's own frontend SPA and REST API |
151
+ | `.agents/rules/chip-tests.instructions.md` | The CHIP conformance test harness |
152
+ | `.agents/skills/verify-agent-context/SKILL.md` | Verify the agent loaded this context — `$verify-agent-context` (Codex), `/verify-agent-context` (all others) |
153
+
154
+ Content lives only in `.agents/`. The per-agent folders exist because each tool discovers rules and skills from its own hardcoded location, so they hold stubs that point back here — except where the tool reads `.agents/` natively.
155
+
156
+ | Tool | Instructions | Rules | Skills |
157
+ | ---------------------------------- | ----------------------------------------------- | ----------------------------------------------------- | --------------------------------------------------- |
158
+ | Codex | `AGENTS.md` — read natively | `.agents/rules/` — linked from `AGENTS.md`, on demand | `.agents/skills/` — native, `$verify-agent-context` |
159
+ | Copilot (VS Code and coding agent) | `.github/copilot-instructions.md` → `AGENTS.md` | stubs in `.github/instructions/` — `applyTo` globs | stub in `.github/skills/` — `/verify-agent-context` |
160
+ | Claude Code | `CLAUDE.md` imports `AGENTS.md` | stubs in `.claude/rules/` — `paths` globs | stub in `.claude/skills/` — `/verify-agent-context` |
161
+ | Gemini / Antigravity | `GEMINI.md` imports `AGENTS.md` | `.agents/rules/` — on demand | `.agents/skills/` — native, `/verify-agent-context` |
162
+
163
+ ### Copilot instructions
141
164
 
142
165
  | File | Notes |
143
166
  | ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
144
- | `.github/copilot-instructions.md` | Main project instructions — always loaded |
167
+ | `.github/copilot-instructions.md` | Pointer to AGENTS.md — always loaded |
145
168
  | `.github/instructions/chip-tests/chip-tests.instructions.md` | CHIP conformance test harness — scoped to CHIP test files |
146
169
  | `.github/instructions/matterbridge/matterbridge.instructions.md` | Matterbridge endpoint guide — dedicated Copilot instruction file |
147
170
  | `.github/instructions/plugin-frontend/plugin-frontend.instructions.md` | Plugin frontend SPA and custom REST API guide — scoped to frontend and plugin code |
148
- | `.github/instructions/testing/unit-tests.instructions.md` | Testing standards — scoped to `**/*.test.ts` |
171
+ | `.github/instructions/testing/testing.instructions.md` | Testing standards — scoped to `**/*.test.ts` |
172
+ | `.github/skills/verify-agent-context/SKILL.md` | Skill invocable as `/verify-agent-context` |
149
173
 
150
- ## Claude instructions
174
+ ### Claude instructions
151
175
 
152
176
  | File | Notes |
153
177
  | --------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
154
- | `CLAUDE.md` | Main project instructions — always loaded |
178
+ | `CLAUDE.md` | Pointer to AGENTS.md — always loaded |
179
+ | `.claude/settings.json` | Claude permissions: allow, ask and deny rules |
155
180
  | `.claude/rules/chip-tests/chip-tests.instructions.md` | CHIP conformance test harness — scoped to CHIP test files |
156
181
  | `.claude/rules/matterbridge/matterbridge.instructions.md` | Matterbridge endpoint guide — loaded for all contexts |
157
182
  | `.claude/rules/plugin-frontend/plugin-frontend.instructions.md` | Plugin frontend SPA and custom REST API guide — scoped to frontend and plugin code |
158
- | `.claude/rules/testing/unit-tests.instructions.md` | Testing standards — scoped to `**/*.test.ts` |
159
-
160
- ## Codex/Agents instructions
161
-
162
- | File | Notes |
163
- | ---------------------------- | ------------------------------------------------- |
164
- | `AGENTS.md` | Main project instructions |
165
- | `.agents/chip-tests.md` | CHIP conformance test harness |
166
- | `.agents/matterbridge.md` | Matterbridge endpoint guide |
167
- | `.agents/plugin-frontend.md` | Plugin frontend SPA and custom REST API guide |
168
- | `.agents/testing.md` | Testing and validation expectations |
169
- | `.codex/config.toml` | Codex project permissions, approvals, and profile |
170
- | `.codex/rules/default.rules` | Codex command allow, prompt, and deny rules |
183
+ | `.claude/rules/testing/testing.instructions.md` | Testing standards — scoped to `**/*.test.ts` |
184
+ | `.claude/skills/verify-agent-context/SKILL.md` | Skill invocable as `/verify-agent-context` |
185
+
186
+ ### Codex instructions
187
+
188
+ | File | Notes |
189
+ | ---------------------------- | ----------------------------------------------------------------- |
190
+ | `AGENTS.md` | Main project instructions — read directly, no pointer file needed |
191
+ | `.codex/config.toml` | Codex project permissions, approvals, and profile |
192
+ | `.codex/rules/default.rules` | Codex command allow, prompt, and deny rules |
193
+
194
+ Codex reads the shared rules and skills from `.agents/` directly; the skill is invoked as `$verify-agent-context`.
195
+
196
+ ### Gemini / Antigravity instructions
197
+
198
+ | File | Notes |
199
+ | ---------------------------- | ----------------------------------------------------- |
200
+ | `GEMINI.md` | Pointer to AGENTS.md — always loaded |
201
+ | `.antigravity/settings.json` | Sandboxing and permissions: allow, ask and deny rules |
202
+
203
+ The shared rules under `.agents/rules/` apply on demand for the relevant tasks, and `.agents/skills/` is discovered automatically as `/verify-agent-context`.
171
204
 
172
205
  ## Development guide
173
206
 
package/npm-shrinkwrap.json CHANGED
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "matterbridge-example-dynamic-platform",
3
- "version": "3.0.4-dev-20260914-aab53d4",
3
+ "version": "3.0.4-dev-20260929-c03806e",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "matterbridge-example-dynamic-platform",
9
- "version": "3.0.4-dev-20260914-aab53d4",
9
+ "version": "3.0.4-dev-20260929-c03806e",
10
10
  "license": "Apache-2.0",
11
11
  "dependencies": {
12
12
  "node-ansi-logger": "3.3.1",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "matterbridge-example-dynamic-platform",
3
- "version": "3.0.4-dev-20260914-aab53d4",
3
+ "version": "3.0.4-dev-20260929-c03806e",
4
4
  "description": "Matterbridge dynamic plugin",
5
5
  "author": "https://github.com/Luligu",
6
6
  "license": "Apache-2.0",