Scope MCP documentation changes to repository checks (#1356)

## Summary
- keep every tracked repository-root file selecting all enabled
workspaces
- scope changes under the MCP repository `docs/` tree to the root
`docs:check` quality gate rather than selecting every workspace
- retain transitive project selection when MCP code changes alongside
docs

Root `docs/` is not part of the deployed `mcp.sentry.dev` Worker assets.
Wrangler serves `packages/mcp-cloudflare/public` and the Vite client
instead. The MCP deployment workflow and production assets are
unchanged.

## Validation
- reproduced the selector failure before the fix: docs-only changes
selected all workspaces
- `test:ci-projects`: 6 passed, including a check of every tracked
root-level file
- `docs:check`, `check:generated`, and repository lint passed after
updating from main
- merged Toolkit CLI cutover (#1354) into this branch to validate the
combined tree; exact-head CI and Warden review are pending

---------

Co-authored-by: GPT-6 Sol <noreply@openai.com>

Author: BYK

scripts/ci-projects.mjs

@@ -330,7 +330,13 @@ export function selectAffectedProjects(projects, changedFiles, eventName) {
     }
   }
 
-  if (changedProjects.some((project) => project === undefined)) {
+  // MCP repository docs are checked by the quality job, not deployed by a project.
+  if (
+    changedProjects.some(
+      (project, index) =>
+        project === undefined && !changedFiles[index].startsWith("docs/"),
+    )
+  ) {
     return projects.filter((project) => project.enabled);
   }
 

scripts/ci-projects.test.mjs

@@ -90,6 +90,40 @@ describe("workspace CI selection", () => {
     );
   });
 
+  it("does not run CLI projects for MCP docs and core changes", () => {
+    const projects = buildProjects([
+      entry("@sentry/mcp-core", "packages/mcp-core", {
+        scripts: { test: "vitest run" },
+      }),
+      entry("@sentry/mcp-server", "packages/mcp-server", {
+        dependencies: { "@sentry/mcp-core": "workspace:*" },
+        scripts: { test: "vitest run" },
+      }),
+      entry("sentry", "packages/cli", { scripts: { test: "vitest run" } }),
+      entry("sentry-cli-docs", "apps/cli-docs", {
+        sentryCi: { dependencies: ["sentry"] },
+        scripts: { build: "astro build" },
+      }),
+    ]);
+
+    const names = (files) =>
+      buildMatrix(
+        selectAffectedProjects(projects, files, "pull_request"),
+      ).include.map(({ name }) => name);
+    assert.deepEqual(names(["docs/contributing/tool-responses.md"]), []);
+    assert.deepEqual(
+      names([
+        "docs/contributing/tool-responses.md",
+        "packages/mcp-core/src/api-client/schema.ts",
+      ]),
+      ["@sentry/mcp-core", "@sentry/mcp-server"],
+    );
+    assert.deepEqual(
+      names(["docs/contributing/tool-responses.md", "pnpm-lock.yaml"]),
+      ["sentry-cli-docs", "sentry", "@sentry/mcp-core", "@sentry/mcp-server"],
+    );
+  });
+
   it("runs all enabled projects for root changes and non-PR events", () => {
     const projects = buildProjects([
       entry("one", "packages/one", { scripts: { build: "tsc" } }),
@@ -99,8 +133,15 @@ describe("workspace CI selection", () => {
         sentryCi: { enabled: false },
       }),
     ]);
+    const rootFiles = execFileSync("git", ["ls-files", "-z"], {
+      cwd: root,
+      encoding: "utf8",
+    })
+      .split("\0")
+      .filter((file) => file !== "" && !file.includes("/"));
+    assert.ok(rootFiles.length > 0);
     for (const [files, event] of [
-      [["pnpm-lock.yaml"], "pull_request"],
+      ...rootFiles.map((file) => [[file], "pull_request"]),
       [["packages/deleted/package.json"], "pull_request"],
       [[], "push"],
       [[], "merge_group"],