Skip to content

docs: roadmap built out from landscape research - #12

Merged
TMHSDigital merged 1 commit into
mainfrom
docs/roadmap-v1
Jul 16, 2026
Merged

docs: roadmap built out from landscape research#12
TMHSDigital merged 1 commit into
mainfrom
docs/roadmap-v1

Conversation

@TMHSDigital

Copy link
Copy Markdown
Owner

Summary

Fully builds out ROADMAP.md, reshaped by the Gemini deep-research landscape report (included in docs/research/ along with the prompt that produced it).

Decisions the research changed:

  • Tool annotations promoted to v0.2, first item — the MCP spec treats unannotated tools as destructive/non-idempotent, and Claude Code uses readOnlyHint as a concurrency signal, so our read-only tools are currently serialized and over-confirmed.
  • LocalAPI provider narrowed to the two high-stability endpoints (/status, /whois); the LocalAPI is officially unstable, so CliProvider stays the default elsewhere.
  • v0.3 anchored on the two uncontested competitive gaps: bridging local daemon + Admin API in one server, and ACL validate/preview dry-run pre-flights (no existing server offers either).
  • v0.4 adds identity-gated execution (whois + ACL capability grants — the published confused-deputy mitigation).
  • Streamable HTTP, OAuth discovery, elicitation deferred with client-support rationale; dashboards explicitly out of lane.
  • v1.0 distribution: signed Docker + SBOM (Docker MCP Catalog), Smithery, standalone binaries.

Notes

  • No version bump: repo-docs only; ROADMAP.md and docs/ don't ship in the npm package, and release.yml no-ops idempotently on the existing v0.1.2 tag.

🤖 Generated with Claude Code

Reshapes the roadmap around the July 2026 Gemini landscape report:
- tool annotations promoted to v0.2 (spec defaults unannotated tools to
  destructive; Claude Code uses readOnlyHint for concurrency)
- LocalAPI provider narrowed to the two high-stability endpoints
  (/status, /whois); CLI stays default elsewhere
- v0.3 anchored on the two uncontested gaps: local+Admin API bridge and
  ACL validate/preview dry-run pre-flights
- Streamable HTTP, OAuth discovery, elicitation moved to deferred with
  client-support rationale
- v1.0 distribution: signed Docker+SBOM, Smithery, binaries

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Jul 15, 2026
@TMHSDigital
TMHSDigital merged commit 6a607e9 into main Jul 16, 2026
6 checks passed
@TMHSDigital
TMHSDigital deleted the docs/roadmap-v1 branch July 16, 2026 00:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant