feat(mcp): expose outcome calibration via gittensory_get_outcome_calibration

[jaso0n0818]

Summary

• Add gittensory_get_outcome_calibration MCP tool (replaces closed feat(mcp): expose outcome calibration via gittensory_get_outcome_calibration #1171)
• Guard slop summary with optional chaining so sparse reports cannot throw

Test plan

• vitest mcp-output-schemas outcome_calibration test

Supersedes #1171 — addresses AI reviewer null-safety feedback.

[superagent-security]

Superagent didn't find any vulnerabilities or security issues in this PR.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 94.86%. Comparing base (f085f78) to head (7cdec26).
⚠️ Report is 13 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1174   +/-   ##
=======================================
  Coverage   94.85%   94.86%           
=======================================
  Files         156      156           
  Lines       18909    18920   +11     
  Branches     6848     6850    +2     
=======================================
+ Hits        17937    17948   +11     
  Misses        387      387           
  Partials      585      585           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[ghost]

Tip

🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩

✅ Gittensory review — safe to merge

3 files · 2 AI reviewers · no blockers · readiness 100/100 · CI green

✅ Approved — safe to merge

Review summary
The change adds a new MCP tool `gittensory_get_outcome_calibration` that returns slop‑band calibration data for a repository. It introduces input and output Zod schemas, registers the tool, and implements a private handler that builds the report and crafts a human‑readable summary. The implementation compiles and integrates with existing tooling, and tests are added to verify schema compliance and basic functionality.

Nits (5)

• src/mcp/server.ts: The ternary `input.windowDays !== undefined ? input.windowDays : undefined` is redundant; passing `input.windowDays` directly would be clearer.
• src/mcp/server.ts: The summary construction uses nested ternary operators, which reduces readability; consider extracting into a helper function.
• src/mcp/server.ts: The output schema types `slop` and `recommendations` are `z.unknown()`. More specific schemas would improve validation and documentation.
• test/unit/mcp-output-schemas.test.ts: The test expects `data.windowDays` to be present in the returned report; ensure `buildRepoOutcomeCalibration` includes this field or augment the handler to add it.
• test/unit/mcp-output-schemas.test.ts: The test checks that `data.signals` is an array; verify that the calibration report always provides a `signals` array to satisfy the schema.

Signal	Result	Evidence
Code review	✅ No blockers	2 reviewers, synthesized
Linked issue	✅ Linked	#1171
Related work	✅ No active overlap found	No same-issue or scoped active PR overlap found.
Review load	✅ 20/20	Readiness component derived from cached public PR metadata and labels; size label size:M.
Validation evidence	✅ 25/25	PR body includes validation/test evidence.
Open PR queue	✅ 10/10	0 open PR(s), 0 likely reviewable.
Contributor context	✅ Confirmed Gittensor contributor	jaso0n0818; Gittensor profile; 1361 PR(s), 5 issue(s).
Gate result	✅ Passing	No configured blocker found.

Review context

• Author: jaso0n0818
• Role context: outside_contributor
• Public audience mode: oss maintainer
• Lane context: Repository is configured for direct PR review.
• Public profile languages: Python, Rust, Shell, C++, Dart, Ruby, Scala, TypeScript
• Official Gittensor activity: 1361 PR(s), 5 issue(s).
• PR-specific overlap: none found.

Contributor next steps

• Keep the PR focused and include validation evidence before maintainer review.

Signal definitions

• Related work = same linked issue, overlapping active PRs, or title/path similarity.
• Review load = cached public PR metadata such as size labels, changed paths, and preflight status.
• Open PR queue = repo-wide review pressure; it is not a PR quality failure.
• Contributor context = public GitHub/Gittensor identity context; non-Gittensor status is not a blocker.

Review details

Generated from public PR metadata and the diff. Advisory only; deterministic signals remain authoritative.

The change adds a new MCP tool `gittensory_get_outcome_calibration` that returns slop‑band calibration data for a repository. It introduces input and output Zod schemas, registers the tool, and implements a private handler that builds the report and crafts a human‑readable summary. The implementation compiles and integrates with existing tooling, and tests are added to verify schema compliance and basic functionality.

Nits (5)

• src/mcp/server.ts: The ternary `input.windowDays !== undefined ? input.windowDays : undefined` is redundant; passing `input.windowDays` directly would be clearer.
• src/mcp/server.ts: The summary construction uses nested ternary operators, which reduces readability; consider extracting into a helper function.
• src/mcp/server.ts: The output schema types `slop` and `recommendations` are `z.unknown()`. More specific schemas would improve validation and documentation.
• test/unit/mcp-output-schemas.test.ts: The test expects `data.windowDays` to be present in the returned report; ensure `buildRepoOutcomeCalibration` includes this field or augment the handler to add it.
• test/unit/mcp-output-schemas.test.ts: The test checks that `data.signals` is an array; verify that the calibration report always provides a `signals` array to satisfy the schema.

_{🟩 Safe / merged · 🟦 Advisory · 🟨 Held for review · 🟥 Blocked / closed}

---

💰 Earn for open-source contributions like this. Gittensor lets GitHub contributors earn for the work they already do — register to start earning →.

Checked by Gittensory, a quiet PR intelligence layer for OSS maintainers.

• Re-run Gittensory review