flocks_mcp 0.1.1

Servidor MCP que serve o catálogo de 131 componentes do Flocks (props, uso, a11y) a agentes.

Changelog

Every relevant change to this package. The format follows Keep a Changelog, and the numbering follows SemVer.

On the numbering. This package moves in lockstep with flocks: what it serves is the flocks component catalog, and a version line of its own would only create a compatibility matrix between server and catalog. The public line starts at 0.1.0, next to the core; the flocks CHANGELOG explains why 0.x. It published after flocks, because the core's 0.1.0 is what settles the catalog schema this package embeds.

0.1.1 - 2026-08-10

Added

• An example/, with the three ways in: registering the command with an agent, the same conversation by hand over a pipe (newline-delimited JSON-RPC, for when a client misbehaves and you need to know which side is wrong), and FlocksCatalog used directly from Dart. Every output shown there was captured from a real run, not written from memory. It is also the last of the five pub.dev checks: 0.1.0 scored 150/160, and "no example found" was the whole gap.

Fixed

• O LICENSE volta a ser reconhecível como MIT. Ele trazia o texto SPDX seguido de uma nota sobre o catálogo embarcado, e qualquer texto apensado derruba a confiança do license_detector — que é justamente quem pontua a licença no pub.dev, onde a 0.1.0 deste pacote já está. A explicação do catálogo está no README, e o .mcpb continua levando o LICENSE dentro.

Changed

• Versão em lockstep com o flocks 0.1.1, para o Release do bundle sair com a licença corrigida.
• The package description is shorter — 92 characters, down from 104. The MCP Registry refuses anything above 100 and answers 422 at publish time; pub.dev has no such ceiling and had already accepted the longer one, so 0.1.0 keeps it there for good. The window now belongs to both destinations, and test/server_json_test.dart gates it from both sides: at most 100 for the registry, at least 60 before pub.dev starts calling the description too short.

0.1.0 - 2026-08-10

Added

• An MCP server over stdio, exposing the flocks component catalog to agents through three tools: list_components, get_component and search_components. Every one of them takes lang (en or pt, defaulting to en) — the catalog is bilingual at the source, per field, so there is no fallback to invent.
• The catalog travels embedded, as generated Dart (lib/src/catalog_data.g.dart, written by tool/embed_catalog.dart). A package installed by dart pub global activate cannot see a sibling package's doc/, so reading flocks' JSON at runtime was never an option. test/catalog_embed_freshness_test.dart compares the embedded copy with the source byte for byte, so a stale catalog fails a test instead of being served in silence.
• Errors that teach rather than merely reject: an unknown id answers with the nearest ids it does know, and an invalid lang or category answers with the valid values. The consumer is a model, and a model corrects itself from a good error.
• An MCP Bundle (flocks-mcp.mcpb), built by CI on every v* tag and attached to the GitHub Release with its SHA-256: one archive with native executables for macOS (arm64/x64), Linux (x64) and Windows (x64), installable into Claude Desktop with two clicks and no Dart SDK. The manifest is generated from the pubspec (tool/generate_mcpb_manifest.dart, gated by test/mcpb_manifest_test.dart), and the release also attaches a generated server.json, ready for a deliberate MCP Registry publication under io.github.jotapeconsultoria/flocks-mcp.