flocks_mcp 0.1.2

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.2 - 2026-08-12

O número acompanha o flocks 0.1.2, pela razão que o bloco acima dá: o que este servidor serve é o catálogo do core, e uma linha de versão própria só criaria matriz de compatibilidade entre servidor e catálogo. O que mudou no core está no CHANGELOG do flocks. Aqui nada mudou no código que responde às tools: desde a 0.1.1, o diff deste pacote são dois arquivos — .pubignore e README.md.

Fixed

• O server.json entrou no .pubignore. Ele é gerado no job de release e nunca commitado — disso o .gitignore da raiz já cuidava —, mas rodar o gerador à mão deixa um server.json solto na árvore carregando a versão e o sha256 do release anterior, e um dart pub publish local o levaria dentro do tarball da versão nova. A linha do .gitignore não bastava: no empacotamento, o .pubignore substitui o .gitignore em vez de somar com ele.
• A receita de publicação no MCP Registry, no README. O curl -LO se recusa a sobrescrever: com um server.json velho no diretório, ele pula o download em silêncio e o que se republica é a versão passada — daí o rm -f antes. E a URL passa a nomear a tag em vez de latest, porque o CI monta o Release depois que a tag é empurrada: nessa janela, latest ainda é o release anterior. O README também passa a dizer o que um 403 do registry quer dizer — token sem read:org — e que um $GITHUB_PAT vazio produz o mesmo erro, porque -token "" cai de volta no fluxo interativo.
• O handshake documentado no example/ anunciava 0.1.0. Aquele bloco de JSON é a aba Example do pub.dev, e o .pubignore não tira o example/ do tarball: era a primeira saída que um adotante lia, afirmando uma versão que não era a do pacote. A linha era a quarta cópia da versão e a única sem gate — as outras três (pubspec, kServerVersion, mcpb/manifest.json) já se cobram entre si. Foi recapturada rodando o pipe do próprio exemplo, e a captura mostrou que a linha também havia perdido o id da resposta e o campo instructions; o valor de instructions aparece elidido, e o texto agora diz que aparece. test/install_docs_test.dart passa a reprovar quando essa versão divergir da que o servidor anuncia.

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; o .mcpb desta versão ainda não leva o LICENSE.

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.