Skip to content

Document MCP access and dashboard in README, add MIT license - #19

Merged
oBecks merged 3 commits into
masterfrom
readme-mcp-license-docs
Aug 27, 2026
Merged

Document MCP access and dashboard in README, add MIT license#19
oBecks merged 3 commits into
masterfrom
readme-mcp-license-docs

Conversation

@oBecks

@oBecksoBecks commented Aug 27, 2026

Copy link
Copy Markdown
Owner

User description

Summary

  • Add an MCP access section documenting the /api/mcp endpoint, per-repo token setup, and the 3 available tools (get_pet_status, mark_deployed, mark_issue_fixed)
  • Add a Dashboard section describing the (previously undocumented) sign-in/dashboard flow, and fix a stale "there's no dashboard yet" note
  • Bump the badge <img> display size (150×220 → 195×286) so the XP label is legible
  • Convert raw dashboard URLs to friendly link text
  • Add an MIT LICENSE file, license field in package.json, and a license badge in the README

Test plan

  • Rendered README locally to confirm markdown/table formatting
  • Verified MCP tool names/descriptions against app/api/mcp/route.ts
  • Verified dashboard routes exist (app/dashboard/page.tsx, app/dashboard/[repoId]/page.tsx)

🤖 Generated with Claude Code


Generated description

Below is a concise technical summary of the changes proposed in this PR:
Document the dashboard sign-in flow and MCP access through the README, including endpoint configuration, repository-scoped tokens, and available tools. Add MIT licensing metadata and enlarge generated badge embeds for better readability.

TopicDetails
MIT LicensingAdd MIT licensing through the repository license file, package metadata, and README badge.
Modified files (3)
  • LICENSE
  • README.md
  • package.json
Latest Contributors(0)
UserCommitDate
Dashboard & MCPDocument the GitHub sign-in dashboard, repository pet pages, badge setup, and MCP endpoint workflow, including get_pet_status, mark_deployed, and mark_issue_fixed.
Modified files (2)
  • README.md
  • app/dashboard/_components/BadgeCard.tsx
Latest Contributors(0)
UserCommitDate
Review this PR on Baz | Customize your next review

Adds an MCP access section (tools, token setup) and a Dashboard section
since both existed but weren't documented, bumps the badge display size
so the XP label is readable, and adds a LICENSE file plus badge.
@vercel

vercelBot commented Aug 27, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
commit-petReadyReadyPreviewAug 27, 2026 2:20pm

@coderabbitai

coderabbitaiBot commented Aug 27, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: f85780ce-0991-4af3-adaa-43632d29ecb3

📥 Commits

Reviewing files that changed from the base of the PR and between be94713 and 69e9121.

📒 Files selected for processing (2)
  • README.md
  • app/dashboard/_components/BadgeCard.tsx
🚧 Files skipped from review as they are similar to previous changes (1)
  • README.md

Included review availability: Your plan provides up to 10 included reviews per hour; 5 remain after this review.


📝 Walkthrough

Walkthrough

The project now includes an MIT license, MIT package metadata, updated badge dimensions, dashboard-based repository guidance, and documentation for dashboard and MCP access.

Changes

Licensing and documentation

Layer / File(s)Summary
MIT license metadata
LICENSE, package.json
Adds the MIT license text and declares MIT in package metadata.
Dashboard, MCP, and badge updates
README.md, app/dashboard/_components/BadgeCard.tsx
Updates badge dimensions and repository ID guidance. Documents GitHub sign-in, repo-scoped tokens, the MCP endpoint, available tools, and related ADRs.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Merge Risk:⚪ Minimal · up to 69e91

This PR updates documentation, licensing metadata, and badge presentation without introducing an actionable merge-blocking risk; it is merge-ready after normal checks and review.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 1 functions across 1 files. (1 skipped: 1 …Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title clearly summarizes the main changes: README documentation for MCP access and the dashboard, plus the addition of an MIT license.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
Full details: Docstring Coverage

Explanation

Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 1 functions across 1 files. (1 skipped: 1 unsupported.)

  • Fix all pre-merge checks with AI
✨ Finishing Touches 💡 1
📝 Generate docstrings 💡
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch readme-mcp-license-docs

Comment @coderabbitai help to get the list of available commands.

Comment threadREADME.md
3. **Drop the badge in your own README**, swapping in that ID:
```md
<img src="https://commit-pet.vercel.app/api/badge/<repoId>" alt="commit-pet badge" width="150" height="220" />
<img src="https://commit-pet.vercel.app/api/badge/<repoId>" alt="commit-pet badge" width="195" height="286" />

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Dashboard copies stale badge dimensions

Dashboard BadgeCard still builds snippet with width="150" height="220", which CopyButton copies while the README specifies width="195" height="286" — should we update the Dashboard snippet to width="195" height="286"?

Severity

Want Baz to fix this for you? Activate Fixer

Other fix methods

Fix in Cursor

Prompt for AI Agents
Before applying, verify this suggestion against the current code. In README.md around
lines 20-20, align the Dashboard `BadgeCard` copyable HTML snippet with the documented
badge dimensions. Update the BadgeCard implementation so the `CopyButton` receives
`width="195" height="286"` instead of `150x220`, ensuring dashboard-generated
installation snippets match the README.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Commit 69e9121addressed this comment by updating the Dashboard BadgeCard copyable snippet to use width="195" height="286", matching the README dimensions.

Comment threadREADME.md

## Dashboard

Sign in with GitHub on [the dashboard](https://commit-pet.vercel.app/dashboard) to see every repo you have commit-pet installed on, in one place — the same live pet state as the badge, plus each repo's numeric ID for badge setup and its **MCP access** card for generating a token (see below).

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Contradictory Dashboard availability guidance

The new Dashboard description presents it as available while the badge paragraph still calls it an “eventual dashboard,” so readers get conflicting guidance — should we update the earlier wording or remove “eventual”?

Severity

Want Baz to fix this for you? Activate Fixer

Other fix methods

Fix in Cursor

Prompt for AI Agents
Before applying, verify this suggestion against the current code. In `README.md` around
lines 47-51, update the badge description and Dashboard section so they consistently
describe the dashboard as currently available. Remove or replace the phrase “eventual
dashboard” in the badge paragraph, preserving the intended distinction between the
badge view and the dashboard.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Commit 69e9121addressed this comment by removing “eventual dashboard” and documenting the dashboard as currently available.

Comment threadREADME.md
| Tool | Description |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| `get_pet_status` | Get the pet's phase (development/deployed), health, mood, growth stage, XP, and open issue count. |
| `mark_deployed` | Mark the pet as deployed, entering the deployed phase. Idempotent. |

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Repeated deploy calls reset displayed deployment time

mark_deployed calls markDeployed(repoId) with updatedAt: new Date() even when phase is already deployed, so getDashboardPet/getDashboardPets feed a new deployedRelative value to Hero and PetCard, making old deployments appear current — should we update the timestamp only on the phase transition or add deployedAt, while preserving the existing found-row result semantics?

Severity

Want Baz to fix this for you? Activate Fixer

Other fix methods

Fix in Cursor

Prompt for AI Agents
Before applying, verify this suggestion against the current code. In README.md around
line 70, follow the documented `mark_deployed` behavior into the `markDeployed(repoId)`
implementation and fix its idempotency bug. Preserve the original deployment timestamp
when the repository is already in the `deployed` phase by updating `updatedAt` only on
the phase transition or by introducing a dedicated immutable `deployedAt` field, while
retaining the existing found-row result semantics. Ensure dashboard mappings and
`Hero`/`PetCard` continue to display the original deployment time after repeated calls.

BadgeCard's copy snippet still used the old 150x220 badge dimensions,
and the "How it works" section called the dashboard "eventual" even
though it's documented as available a few lines later.
@oBecks
oBecks merged commit d71a6ef into masterAug 27, 2026
6 checks passed
@oBecks
oBecks deleted the readme-mcp-license-docs branch August 27, 2026 14:23
Sign up for freeto 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

@oBecks