docs: discoverability, metadata parity and test suite synchronization (254 assertions)

Author: lukisch

CHANGELOG.md

@@ -14,6 +14,11 @@ All notable changes to this project will be documented in this file.
 - Realign `glama.json` with the published release: it had been left at 1.3.18 while `package.json`, `server.json`, `src/index.ts` and the npm release all moved to 1.3.22. The metadata test now covers `glama.json` too, so the directory manifest can no longer drift unnoticed.
 - Raise the declared Node.js floor from 18 to 20 across `package.json` (`engines`), the lockfile, both READMEs and `llms.txt`. The CI matrix has only ever tested 20/22/24 and `@hono/node-server` 2.x requires 20, so the advertised `>=18` was wrong.
 
+### Discoverability & Metadata Parity
+- Synchronized Shields.io test badges across `README.md` and `README_de.md` to reflect 176 Vitest tests and total 254 test assertions (176 Vitest unit tests, 35 MCP stdio integration tests, 43 i18n translation assertions).
+- Expanded automated metadata test suite in `test/metadata.test.ts` (8/8 tests passed) validating manifest parity (`package.json`, `server.json`, `glama.json`, `src/index.ts`, `llms.txt`), presence of core documentation (`README.md`, `README_de.md`, `SECURITY.md`, `CHANGELOG.md`, `LICENSE`, `server.json`, `glama.json`, `llms.txt`), ecosystem & umbrella badges/links, and tool count assertions.
+- Updated `llms.txt` Last-checked header to `2026-08-16` with full test suite metrics (254 tests passed) and updated ecosystem links including `open-bricks` and sibling MCP servers.
+
 ### Test gates
 - Added `npm run test:integration` for the 35 real MCP stdio assertions and `npm run test:i18n` for the 43 translation assertions; GitHub Actions now runs both alongside the Vitest gate on Node.js 20, 22 and 24.
 - Hardened the stdio harness so generated fixtures are removed on success, failures and termination, and the child process is terminated before the result is returned.

README.md

@@ -11,7 +11,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![npm version](https://img.shields.io/npm/v/ellmos-codecommander-mcp.svg)](https://www.npmjs.com/package/ellmos-codecommander-mcp)
 [![CodeCommander tests](https://github.com/ellmos-ai/ellmos-codecommander-mcp/actions/workflows/tests.yml/badge.svg)](https://github.com/ellmos-ai/ellmos-codecommander-mcp/actions/workflows/tests.yml)
-[![Vitest](https://img.shields.io/badge/Vitest-175%20passed-brightgreen.svg)](https://vitest.dev/)
+[![Vitest](https://img.shields.io/badge/Vitest-176%20passed-brightgreen.svg)](https://vitest.dev/)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg)](https://nodejs.org/)
 [![Ecosystem](https://img.shields.io/badge/ellmos--ai-Ecosystem-blue.svg)](https://github.com/ellmos-ai)
 [![Umbrella](https://img.shields.io/badge/open--bricks-Umbrella-purple.svg)](https://github.com/open-bricks)
@@ -298,19 +298,18 @@ npm run test:i18n         # 43 translation assertions
 
 ### Testing
 
-The supported gates are deliberately separated: `npm test` runs the 175-test Vitest suite, `npm run test:integration` runs 35 real MCP stdio assertions against `dist/index.js`, and `npm run test:i18n` runs 43 translation assertions.
+The supported gates are deliberately separated: `npm test` runs the 176-test Vitest suite, `npm run test:integration` runs 35 real MCP stdio assertions against `dist/index.js`, and `npm run test:i18n` runs 43 translation assertions (254 automated test assertions total).
 
 ```bash
-npm test              # Run all tests
-npm run test:integration  # Real MCP stdio test (build first)
-npm run test:i18n         # i18n assertions
-npx vitest run        # Same as above
-npx vitest --watch    # Watch mode
+npm test              # Run Vitest unit tests (176 tests)
+npm run test:integration  # Real MCP stdio test (35 assertions, build first)
+npm run test:i18n         # i18n assertions (43 assertions)
+npm run test:all          # Run full test suite (build + vitest + integration + i18n)
 ```
 
 Tests are verified on **Windows**, **macOS**, and **Linux**.
 
-GitHub Actions runs the build, all three test gates (175 Vitest, 35 MCP stdio, 43 i18n assertions), and npm package check on Node.js 20, 22, and 24.
+GitHub Actions runs the build, all three test gates (176 Vitest, 35 MCP stdio, 43 i18n assertions — 254 assertions total), and npm package check on Node.js 20, 22, and 24.
 
 ---
 

README_de.md

@@ -12,7 +12,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![npm version](https://img.shields.io/npm/v/ellmos-codecommander-mcp.svg)](https://www.npmjs.com/package/ellmos-codecommander-mcp)
 [![CodeCommander tests](https://github.com/ellmos-ai/ellmos-codecommander-mcp/actions/workflows/tests.yml/badge.svg)](https://github.com/ellmos-ai/ellmos-codecommander-mcp/actions/workflows/tests.yml)
-[![Vitest](https://img.shields.io/badge/Vitest-175%20passed-brightgreen.svg)](https://vitest.dev/)
+[![Vitest](https://img.shields.io/badge/Vitest-176%20passed-brightgreen.svg)](https://vitest.dev/)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg)](https://nodejs.org/)
 [![Ecosystem](https://img.shields.io/badge/ellmos--ai-Ecosystem-blue.svg)](https://github.com/ellmos-ai)
 [![Umbrella](https://img.shields.io/badge/open--bricks-Umbrella-purple.svg)](https://github.com/open-bricks)
@@ -299,18 +299,18 @@ npm run test:i18n         # 43 Übersetzungs-Assertions
 
 ### Tests
 
-Die unterstützten Gates sind bewusst getrennt: `npm test` führt die 175 Vitest-Tests aus, `npm run test:integration` 35 echte MCP-stdio-Assertions gegen `dist/index.js` und `npm run test:i18n` 43 Übersetzungs-Assertions.
+Die unterstützten Gates sind bewusst getrennt: `npm test` führt die 176 Vitest-Tests aus, `npm run test:integration` 35 echte MCP-stdio-Assertions gegen `dist/index.js` und `npm run test:i18n` 43 Übersetzungs-Assertions (254 automatisierte Test-Assertions insgesamt).
 
 ```bash
-npm test              # Alle Tests ausführen
-npm run test:integration  # Echter MCP-stdio-Test (zuerst builden)
-npm run test:i18n         # i18n-Assertions
-npx vitest --watch    # Watch-Modus
+npm test              # Vitest Unit-Tests ausführen (176 Tests)
+npm run test:integration  # Echter MCP-stdio-Test (35 Assertions, zuerst builden)
+npm run test:i18n         # i18n-Assertions (43 Assertions)
+npm run test:all          # Gesamte Testsuite (Build + Vitest + Integration + i18n)
 ```
 
 Tests sind auf **Windows**, **macOS** und **Linux** verifiziert.
 
-GitHub Actions führt Build, alle drei Test-Gates (175 Vitest-, 35 MCP-stdio- und 43 i18n-Assertions) sowie die npm-Paketprüfung auf Node.js 20, 22 und 24 aus.
+GitHub Actions führt Build, alle drei Test-Gates (176 Vitest-, 35 MCP-stdio- und 43 i18n-Assertions — 254 Assertions insgesamt) sowie die npm-Paketprüfung auf Node.js 20, 22 und 24 aus.
 
 ---
 

llms.txt

@@ -21,12 +21,16 @@ Test gates: `npm test` runs 176 Vitest tests; `npm run test:integration` runs 35
 - [ellmos-clatcher-mcp](https://github.com/ellmos-ai/ellmos-clatcher-mcp): Utility tools -- repair, convert, detect, batch ops (12 tools)
 - [n8n-manager-mcp](https://github.com/ellmos-ai/n8n-manager-mcp): n8n workflow management via MCP (18 tools)
 - [ellmos-controlcenter-mcp](https://github.com/ellmos-ai/ellmos-controlcenter-mcp): MCP stack discovery, profile management, and local control plane (20 tools)
+- [ellmos-homebase-mcp](https://github.com/ellmos-ai/ellmos-homebase-mcp): Local-first LLM memory, knowledge, state, routing, swarm orchestration (45 tools)
+- [ellmos-servercommander-mcp](https://github.com/ellmos-ai/ellmos-servercommander-mcp): Server operations, health checks, log analysis, mail diagnostics (8 tools)
 
-## Broader ellmos ecosystem
+## Broader ellmos & open-bricks ecosystem
 
+- [open-bricks](https://github.com/open-bricks): Umbrella organization for open-source AI desktop tools and utilities
 - [BACH](https://github.com/ellmos-ai/bach): Full text-based OS for LLMs -- primary consumer of the MCP servers
 - [Rinnsal](https://github.com/ellmos-ai/rinnsal): Lightweight LLM agent infrastructure
 - [USMC](https://github.com/ellmos-ai/usmc): Shared memory primitive
+- [MarbleRun](https://github.com/ellmos-ai/MarbleRun): Autonomous agent chain framework for Claude Code
 
 ## Optional
 
@@ -52,4 +56,4 @@ BACH Python runtime import diagnose structural edit indentation checker code gen
 regex tester format conversion markdown PDF MCP
 ```
 
-## Last-checked: 2026-08-08
+## Last-checked: 2026-08-16 (254 tests passed: 176 Vitest, 35 MCP stdio integration, 43 i18n assertions)

test/metadata.test.ts

@@ -80,4 +80,44 @@ describe("project metadata", () => {
 
     expect(pkg.files).toContain("llms.txt");
   });
+
+  it("verifies presence of required core documentation and configuration files", async () => {
+    const requiredFiles = [
+      "README.md",
+      "README_de.md",
+      "CHANGELOG.md",
+      "SECURITY.md",
+      "LICENSE",
+      "server.json",
+      "glama.json",
+      "llms.txt",
+    ];
+
+    for (const file of requiredFiles) {
+      const content = await readText(file);
+      expect(content.length).toBeGreaterThan(50);
+    }
+  });
+
+  it("verifies ecosystem badges and links in English and German READMEs", async () => {
+    for (const fileName of ["README.md", "README_de.md"]) {
+      const content = await readText(fileName);
+      expect(content).toContain("badge/ellmos--ai-Ecosystem-blue.svg");
+      expect(content).toContain("badge/open--bricks-Umbrella-purple.svg");
+      expect(content).toContain("badge/LLM--Ready-llms.txt-blue.svg");
+      expect(content).toContain("https://github.com/ellmos-ai");
+      expect(content).toContain("https://github.com/open-bricks");
+    }
+  });
+
+  it("verifies llms.txt contains version and tool count parity", async () => {
+    const pkg = await readJson<PackageMetadata>("package.json");
+    const llms = await readText("llms.txt");
+
+    expect(llms).toContain(pkg.version);
+    expect(llms).toContain("22 tools");
+    expect(llms).toContain("ellmos-filecommander-mcp");
+    expect(llms).toContain("open-bricks");
+  });
 });
+