Skip to content

feat: align CLI and MCP on the small cross-surface gaps - #904

Merged
JArmandoAnaya merged 1 commit into
mainfrom
fix/surface-alignment-small-findings
Oct 9, 2026
Merged

JArmandoAnaya merged 1 commit into
mainfrom
fix/surface-alignment-small-findings

Conversation

@JArmandoAnaya

Copy link
Copy Markdown
Contributor

What

Closes the small cross-surface gaps between REST, the CLI and MCP.

  • CLI: --seed without --split is refused (exit 2) instead of being silently ignored.
  • MCP: new list_project_assets tool, the counterpart of GET /projects/{id}/assets, so an asset removed from a batch stays reachable. The tool count in the docs is corrected to 60 offered by default and 64 in all.
  • Docs: docs/content/mcp.md and docs/content/cli.md now state which REST routes and CLI commands each surface does not offer, the per-surface parameter names and response shapes, and the declared allowed_actions that have no matching tool or command.

Addresses findings 3, 6, 9, 10 and 11 of #884 and its reverse-gaps note. Finding 7 was already fixed by #887. The rest of that tracker is untouched.

Notes for review

  • The doc tables were checked against openapi.json, the MCP tool roster and the CLI command tree.
  • The REST docstring of GET /projects/{id}/assets carries the same stale ordering sentence the new tool's description had; fixing it changes openapi.json and the generated client, so it is left for a separate change.
  • The newest-first ordering test relies on real time ordering two ingests; there is no clock seam.

Verification

  • tests/cli, tests/mcp, tests/architecture, tests/server: 1862 passed, 8 skipped.
  • ruff check / ruff format --check clean; scripts/export_mcp_tools.py --check passes; the docs link and sidebar tests pass.

- cli: refuse --seed without --split instead of ignoring it
- mcp: add list_project_assets so an asset removed from a batch stays reachable
- docs: state which REST routes and CLI commands each surface does not offer,
  the per-surface names and shapes, and the declared actions with no command
@JArmandoAnaya
JArmandoAnaya merged commit 25f9958 into main Oct 9, 2026
31 checks passed
@JArmandoAnaya
JArmandoAnaya deleted the fix/surface-alignment-small-findings branch October 9, 2026 08:23
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