feat: v0.11.7 — Glama TDQS overhaul for all 44 MCP tools

[I4cTime]

Intent

Boost the Glama Tool Definition Quality Score (TDQS) for all 44 MCP tools to improve agent tool selection and task success. The blog notes the server-level score weights the minimum tool score at 40% (60% mean / 40% min), so this PR specifically targets lifting the worst per-tool descriptions.

What changed

• All 44 MCP tool descriptions rewritten using a 3-sentence template that hits every TDQS dimension:
  1. What the tool does (purpose clarity)
  2. When to use it vs. its siblings (usage guidelines / disambiguation)
  3. Side effects (mutations / audit / network), idempotency, and return shape (behavioral transparency / contextual completeness)
• src/mcp/tools/_shared.ts — commonSchemas (scope, projectPath, env, teamId, orgId) .describe() strings now include formats, defaults, conditional requirements, and concrete examples.
• Per-tool Zod .describe() strings tightened across all 10 tool files.
• README.md — MCP tables resynced with the new one-liner descriptions.
• CHANGELOG.md — 0.11.7 entry.
• Version bump to 0.11.7 in package.json, server.json (both version and packages[0].version), cursor-plugin/.cursor-plugin/plugin.json, and .cursor-plugin/marketplace.json (auto-synced via pnpm run sync-versions).

Risk

• No runtime changes. Tool names, parameter names, parameter types, and return shapes are unchanged. Agents and integrations will simply see longer, clearer descriptions on the next tools/list refresh.
• No keyring, secret, or auth path was touched.
• No new dependencies — pnpm-lock.yaml is unchanged.

Test plan

pnpm run typecheck  # ✓
pnpm run lint       # ✓ (max-warnings 0)
pnpm run build      # ✓ — mcp.js, index.js, dashboard chunks
pnpm run test:ci    # ✓ — 24 files / 164 tests passed

Final MCP smoke test confirmed the server is serving the new descriptions (lengths 366–791 chars, all six TDQS dimensions present).

Follow-ups (after merge to develop → main)

• Trigger Glama re-sync from the admin panel so the new TDQS scoring run picks up the longer descriptions.
• Mirror the 0.11.7 (and backfill 0.11.5) changelog entries in qring.i4c.studio (separate repo, PR coming next).

🤖 Generated with Claude Code

Made with Cursor