Skip to content

fix(docs): clarify MCP metadata upload boundary #231

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
JSONbored merged 1 commit into from
Jun 2, 2026
Merged

fix(docs): clarify MCP metadata upload boundary #231

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions apps/gittensory-ui/src/routes/docs.beta-onboarding.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,8 +48,10 @@ function BetaOnboarding() {

<h2>Miner journey</h2>
<p>
Miners and contributors use the local MCP package. Metadata stays on your machine; private
scoreability and blockers appear only in authenticated MCP/API responses.
Miners and contributors use the local MCP package. Source contents stay on your machine but
branch metadata (such as branch names, SHAs, changed file paths, commit messages, validation
details, labels, body text, linked issues, and scenario notes) is sent to authenticated
Gittensory MCP/API responses for analysis and packet preparation.
</p>
<ol>
<li>
Expand Down
10 changes: 10 additions & 0 deletions test/unit/docs-beta-onboarding.test.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ const BETA_ONBOARDING_PATH = resolve(

describe("docs beta onboarding page", () => {
const source = readFileSync(BETA_ONBOARDING_PATH, "utf8");
const normalizedSource = source.replace(/\s+/g, " ");

it("documents miner MCP flow through packet", () => {
expect(source).toMatch(/gittensory-mcp login/);
Expand All @@ -18,6 +19,15 @@ describe("docs beta onboarding page", () => {
expect(source).toMatch(/agent packet/);
});

it("states the local MCP privacy boundary for source contents and uploaded branch metadata", () => {
expect(source).toMatch(/Source contents stay on your machine/);
expect(source).toMatch(/branch metadata/);
expect(source).toMatch(/changed file paths/);
expect(source).toMatch(/commit messages/);
expect(normalizedSource).toMatch(/authenticated Gittensory MCP\/API responses/);
expect(source).not.toMatch(/Metadata stays on your machine/);
});

it("documents maintainer GitHub App setup, preview, and commands", () => {
expect(source).toMatch(/GitHub App/);
expect(source).toMatch(/settings-preview/);
Expand Down