fix(bin): force collectMcpTools: true for mcp:serve + inject --invocation for mcp:install

[anilcancakir]

Summary

Mirrors fluttersdk_dusk's Bug 1 + Bug 3 wrapper fixes. Pairs with fluttersdk/artisan#18 (substrate --invocation flag) and fluttersdk/dusk#10 (dusk-side fixes).

Bug 1 (mcp:install fallback): bin/fluttersdk_telescope.dart auto-injects --invocation=fluttersdk_telescope when forwarding mcp:install to the artisan substrate. .mcp.json now writes dart run fluttersdk_telescope mcp:serve when bin/fsa is absent, instead of the legacy :dispatcher fallback.

Bug 3 (mcp:serve telescope-tools empty): bin/fluttersdk_telescope.dart forces collectMcpTools: true for mcp:serve dispatch. dart run fluttersdk_telescope mcp:serve now surfaces all 9 telescope_* MCP tools (previously returned 0 plugin tools).

Changes

• bin/fluttersdk_telescope.dart: two interceptions — mcp:install arg-inject (line 33) + mcp:serve collectMcpTools: isMcpServe (line 44).
• lib/src/cli_args.dart (NEW): pure injectInvocationForMcpInstall(args, invocation) helper. Copy-with-rename of dusk's helper; only 2 callers across the org so extraction to a shared utility is deferred per rule of three.
• test/src/cli_args_test.dart (NEW): 4 cases (no mcp:install → unchanged; mcp:install → injects; equal-form override → preserved; whitespace-form override → preserved).
• CHANGELOG.md: ### Changed bullet for Bug 1 + ### Fixed bullet for Bug 3, both under [Unreleased].

Tool count unchanged: 9 telescope_* MCP tools.

Test plan

dart format --output=none --set-exit-if-changed lib/ test/ bin/    # clean after 1 fix applied
dart analyze lib/ test/ bin/                                        # No issues found
flutter test --exclude-tags=integration --timeout=30s               # 253 pass, 0 fail

Manual smoke against this branch (with companion artisan #18 active):

(echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"smoke","version":"0"}}}'; echo '{"jsonrpc":"2.0","id":2,"method":"tools/list"}') | timeout 12 dart run fluttersdk_telescope mcp:serve

Response includes all 9 telescope_* tool names (telescope_tail, telescope_requests, telescope_clear, telescope_exceptions, telescope_events, telescope_gates, telescope_dumps, telescope_queries, telescope_caches) alongside the 10 substrate artisan_* tools.

Out of scope for this PR

• Rename sweep: telescope's own docs have dart run fluttersdk_artisan references analogous to dusk's. Tracked as a follow-up plan telescope-cli-rename-sweep (separate PR).
• Pre-existing skills/ work: this repo has uncommitted edits in skills/fluttersdk-telescope/ (SKILL.md, references/*) from prior unrelated work. Preserved in the working tree; not part of this PR.

Companion PRs (cross-repo plan)

This PR is part of the cross-repo plan dusk-cli-fixes-rename (plan file lives in fluttersdk_dusk repo). Companion PRs:

• feat(mcp): add mcp:install --invocation=<exec> option for plugin-aware .mcp.json fallback artisan#18 — feat/mcp-install-invocation-flag (substrate --invocation flag; land first — this PR depends on it).
• fix(cli): bug 1 fallback + bug 3 collectMcpTools + full dart run fluttersdk_dusk rename dusk#10 — fix/cli-bugs-rename-sweep (dusk-side fixes + full rename sweep inside dusk).

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Fixes Telescope’s standalone CLI wrapper (dart run fluttersdk_telescope ...) so it correctly participates in Artisan’s MCP install/serve flows, aligning behavior with the companion substrate changes.

Changes:

• Inject --invocation=fluttersdk_telescope when forwarding mcp:install so the substrate can write the correct .mcp.json fallback entry.
• Force MCP tool collection when dispatching mcp:serve so all 9 telescope_* tools are surfaced (instead of 0).
• Add a small pure CLI-args helper with unit tests, and document the behavior in CHANGELOG.md.

Reviewed changes

Copilot reviewed 3 out of 4 changed files in this pull request and generated no comments.

File	Description
bin/fluttersdk_telescope.dart	Injects --invocation for mcp:install and sets collectMcpTools for mcp:serve.
lib/src/cli_args.dart	Adds injectInvocationForMcpInstall() pure helper used by the bin wrapper.
test/src/cli_args_test.dart	Adds unit coverage for invocation injection and override preservation.
CHANGELOG.md	Records the mcp:install fallback change and the mcp:serve tool-collection fix under [Unreleased].