Sample-report gallery (/reports) + MCP server — make the value visible & native#142
Merged
Conversation
Make the audit output visible before a user runs it — the classic show-dont-tell activation lever, and indexable SEO content. - reports.ts: typed Report model, seeded with the REAL #97 self-audit (scorecard, not-applicable-with-reasons, headline findings linking the real issues #81-84, the CHECKSUMS cross-audit dedup exhibit). Adding a real run = appending one object. - reports-page.tsx + 4 routes (index + detail, both langs), reusing the landing-page primitives; localized metadata, hreflang, CollectionPage / Report / BreadcrumbList JSON-LD. - footer nav link + sitemap entries. Honesty: only real #97 data — no invented findings, no fabricated repos. Closes #140. Part of #131. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Meet users where the agents already are: a stdio MCP server (official TS SDK) so any MCP-capable client (Claude Desktop/Code, Cursor) gets the auditor library natively instead of pull-only via llms.txt. - mcp/ package: tools list_audits, get_audit_prompt(audit), get_orchestrator, get_standard. Prompt content read live from the repo pinned files; catalogue manifest; robust repo-root resolution. - Every tool description carries the orchestrator safety rules (untrusted data, read-only by default, human OK for issues/active testing). - node:test suite (7/7) + verified stdio JSON-RPC smoke test; README with install snippets. - mcp.yml CI job mirroring web.yml conventions. Closes #141. Part of #131. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Implements the two deferred strategic findings from tracker #131 — both off
main(independent of the other open PRs).Closes #140 — public sample-report gallery at
/reportsThe value prop is invisible until a user runs an audit. A
/reportsgallery renders a full, REAL audit end-to-end — show-dont-tell activation + indexable SEO + social proof.Reportmodel seeded with the real [AUDIT] Full-Repo Orchestrator — Master-Tracker & Roadmap #97 self-audit (scorecard, not-applicable-with-reasons, headline findings linking the real issues [P1][i18n/a11y] /de liefert das Dokument weiterhin mit <html lang="en"> #81–[P2][i18n] EN-Metadaten und Prinzip hartcodieren "German GitHub issues" #84, the CHECKSUMS cross-audit dedup exhibit). Adding a real run = appending one object.CollectionPage/Report/BreadcrumbListJSON-LD, footer link, sitemap.Closes #141 — MCP server (native agent tools)
llms.txtis pull-only. A stdio MCP server (official TS SDK) makes the audits discoverable + invocable natively in Claude Desktop/Code, Cursor.mcp/package, tools:list_audits,get_audit_prompt(audit),get_orchestrator,get_standard. Prompt content read live from the repo pinned files.node:test7/7 + real stdio JSON-RPC smoke test; README with install snippets;mcp.ymlCI job.Verification (local)
typecheck✓ ·test8/8 ✓ ·build✓ — generates/reports+/de/reports+/{,de/}reports/self-auditbuild(tsc) ✓ ·test7/7 ✓ · stdioinitialize/tools/list/tools/callsmoke test ✓Part of #131. Completes findings 8 & 9 — the full 10/10 is now in flight across #132, #139, and this PR.