Skip to content

v1.2.0: fedspeak CLI, MCP registry metadata, SSA entry, agency URLs, deploy previews - #38

Merged
brianfunk merged 1 commit into
devfrom
release/v1.2.0
Oct 2, 2026
Merged

brianfunk merged 1 commit into
devfrom
release/v1.2.0

Conversation

@brianfunk

Copy link
Copy Markdown
Contributor

Summary

Follow-up to #37 (merged). Everything agreed in the last planning round, as one PR to dev.

fedspeak CLI (new)

The CLI page and README have advertised npx fedspeak DOD since 1.0, but the package had no such binary. Now it does:

  • fedspeak GSA, fedspeak DOW OMB CISA — formatted exactly as the CLI page shows
  • --text "<passage>" scan, --encode "<full name>" reverse lookup, --json (same shape as the REST API), --help, --version
  • Exit 1 when any term is not found, 2 on usage errors
  • cli-package/src/cli-core.ts is pure; tests/cli.test.ts covers parsing, formatting, all modes, exit codes (9 tests)

MCP registry metadata

  • server.json for the official MCP Registry (schema 2025-12-11): npm package (stdio) + remote https://fedspeak.dev/mcp (streamable-http)
  • smithery.yaml for Smithery's hosted-server listing
  • Publishing is manual: npx mcp-publisher login github && npx mcp-publisher publish from repo root, and connecting the repo in Smithery

Data

  • SSA → Social Security Administration (new). Source Selection Authority → SSA (Acquisition) with aliases SSA-acq, Source Selection Authority. Nothing deleted. Total 1,157.
  • Official url on 61 department/agency/bureau entries that lacked one: combatant commands, service branches, DOE national labs, DOI/DOC/DOT/Treasury bureaus, FLETC, OCC, USICH, WMATA. Each URL was requested over HTTP; 200s accepted, 403s accepted only for .mil hosts and five well-known .gov sites that block non-browser clients. Six that timed out were left blank.

Netlify

  • [context.deploy-preview] / [context.branch-deploy] so PR previews build with the same command. Enable "Deploy Previews: any pull request" in the Netlify UI for the preview link + status check to show on PRs.

Release

  • Versions → 1.2.0 in package.json, cli-package/package.json, public/openapi.json, server.json, MCP_SERVER_INFO
  • CHANGELOG.md: Unreleased block becomes 1.2.0 with the additions above
  • README, AGENTS.md, CLI page, llms.txt updated

After merge

dev → main, tag v1.2.0, publish cli-package under fedspeak and @metaphase-tech/fedspeak (both get the fedspeak and fedspeak-mcp bins), then optionally mcp-publisher publish and Smithery.

Test plan

  • lint, typecheck, build on Node 22
  • 63/63 tests (new: 9 CLI)
  • cli-package builds; node dist/cli.js GSA, --version, --encode, --json, miss exit code verified
  • data invariants test still green after SSA rename and URL additions
  • CI on this PR

…ncy URLs, deploy previews

- Add the fedspeak CLI the website has documented since 1.0: single and
  multiple lookups, --text, --encode, --json, --help, --version; exit 1 on
  misses, 2 on usage errors. Core logic is pure and covered by
  tests/cli.test.ts.
- Add server.json (official MCP Registry, schema 2025-12-11) and
  smithery.yaml for the hosted endpoint.
- SSA now decodes to Social Security Administration; Source Selection
  Authority moves to 'SSA (Acquisition)' with aliases.
- Add verified official URLs to 61 department/agency/bureau entries.
- Netlify deploy-preview and branch-deploy contexts.
- Versions to 1.2.0 (package, cli-package, openapi, server.json,
  MCP_SERVER_INFO); CHANGELOG, README, AGENTS.md, CLI page, llms.txt
  updated.
@brianfunk
brianfunk merged commit 867e758 into dev Oct 2, 2026
1 check passed
@brianfunk brianfunk mentioned this pull request Oct 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant