@diffci.com/diffci 0.2.1 → 0.2.3

package/docs/mcp.md

@@ -1,21 +1,70 @@
-# DiffCI MCP Server
-
-DiffCI ships a small stdio MCP server for coding agents that prefer native tools over shell commands.
-
-Run it with:
-
-```bash
-npx -p @diffci.com/diffci@latest diffci-mcp
-```
-
-Available tools:
-
-- `diffci_check` - runs `diffci check`, including inferred full and selected test commands.
-- `diffci_init` - runs `diffci init` to seed agent instruction files.
-- `diffci_verify_workflow` - runs `diffci verify-workflow` to check non-interference.
-
-The MCP server delegates to the same open-source CLI. `diffci_check` sends nothing to DiffCI Cloud,
-but it runs test commands when it can infer them. Use the CLI's `observe --no-send` for analysis only.
-
-Keep required project CI authoritative. DiffCI output is a validation lens, not permission to skip
-required checks.
+# DiffCI MCP Server
+
+DiffCI ships a small stdio MCP server for coding agents that prefer native tools over shell commands.
+
+Run it with:
+
+```bash
+npx -p @diffci.com/diffci@latest diffci-mcp
+```
+
+## MCP Client Config
+
+Use this stdio configuration in clients that accept MCP JSON. Set `cwd` to the repository where the
+agent should run DiffCI.
+
+```json
+{
+  "mcpServers": {
+    "diffci": {
+      "command": "npx",
+      "args": ["-p", "@diffci.com/diffci@latest", "diffci-mcp"],
+      "cwd": "/path/to/repository"
+    }
+  }
+}
+```
+
+On Windows, keep the same command shape and use a Windows path:
+
+```json
+{
+  "mcpServers": {
+    "diffci": {
+      "command": "npx",
+      "args": ["-p", "@diffci.com/diffci@latest", "diffci-mcp"],
+      "cwd": "C:\\Users\\you\\path\\to\\repository"
+    }
+  }
+}
+```
+
+For Claude Desktop, Claude Code, Cursor, Codex-style MCP clients, and other stdio-compatible agents,
+name the server `diffci` and call `diffci_check` before PR-ready answers.
+
+Available tools:
+
+- `diffci_check` - runs `diffci check`, including inferred full and selected test commands.
+- `diffci_init` - runs `diffci init` to seed agent instruction files.
+- `diffci_verify_workflow` - runs `diffci verify-workflow` to check non-interference.
+
+The MCP server delegates to the same open-source CLI. `diffci_check` sends nothing to DiffCI Cloud,
+but it runs test commands when it can infer them. Use the CLI's `observe --no-send` for analysis only.
+
+Keep required project CI authoritative. DiffCI output is a validation lens, not permission to skip
+required checks.
+
+## Directory Metadata
+
+Discovery links:
+
+- npm package: https://www.npmjs.com/package/@diffci.com/diffci
+- GitHub repository: https://github.com/DiffCI/DiffCI.com
+- Agent docs: https://diffci.com/docs/ai-agents.html
+- LLM discovery file: https://diffci.com/llms.txt
+- MCP command: `npx -p @diffci.com/diffci@latest diffci-mcp`
+
+Short description:
+
+> Observation-only CI/CD validation for AI coding agents. DiffCI helps agents inspect the current
+> checkout, explain affected tests, and keep required CI authoritative.

package/glama.json

@@ -0,0 +1,12 @@
+{
+  "name": "DiffCI",
+  "description": "Observation-only CI/CD validation for AI coding agents.",
+  "category": "developer-tools",
+  "homepage": "https://diffci.com/docs/ai-agents.html",
+  "repository": "https://github.com/DiffCI/DiffCI.com",
+  "license": "AGPL-3.0-only",
+  "install": {
+    "command": "npx",
+    "args": ["-p", "@diffci.com/diffci@latest", "diffci-mcp"]
+  }
+}

package/llms.txt

@@ -1,37 +1,39 @@
-# DiffCI
-
-DiffCI is an observation-only, change-aware CI analysis tool for AI coding agents and development teams.
-
-Default AI-agent command:
-
-```bash
-npx @diffci.com/diffci@latest check
-```
-
-Initialization command:
-
-```bash
-npx @diffci.com/diffci@latest init
-```
-
-What agents should know:
-
-- `diffci check` analyzes the repository checkout and writes a JSON observation report.
-- It runs no tests, skips no tests, cancels no jobs, and changes no CI behavior.
-- It sends no report unless `DIFFCI_API_URL` and `DIFFCI_TOKEN` are explicitly configured.
-- Treat selected commands as evidence about the change, not as permission to skip required project CI.
-- If DiffCI reports `REFUSED` or `ERROR`, fall back to the repository's normal validation commands.
-
-Useful docs:
-
-- AI agents: https://diffci.com/docs/ai-agents.html
-- Codex: https://diffci.com/docs/codex.html
-- Claude Code: https://diffci.com/docs/claude-code.html
-- Cursor: https://diffci.com/docs/cursor.html
-- GitHub Copilot: https://diffci.com/docs/copilot.html
-- Grok: https://diffci.com/docs/grok.html
-- Adoption kit: https://github.com/DiffCI/DiffCI.com/blob/main/docs/agent-adoption-kit.md
-- Adoption targets: https://github.com/DiffCI/DiffCI.com/blob/main/docs/agent-adoption-targets.md
-- MCP server: https://github.com/DiffCI/DiffCI.com/blob/main/docs/mcp.md
-- Distribution: https://github.com/DiffCI/DiffCI.com/blob/main/docs/distribution.md
-- Language support: https://github.com/DiffCI/DiffCI.com/blob/main/docs/language-support.md
+# DiffCI
+
+DiffCI is an observation-only, change-aware CI analysis tool for AI coding agents and development teams.
+
+Default AI-agent command:
+
+```bash
+npx @diffci.com/diffci@latest check
+```
+
+Initialization command:
+
+```bash
+npx @diffci.com/diffci@latest init
+```
+
+What agents should know:
+
+- `diffci check` analyzes the repository checkout and writes a JSON observation report.
+- It runs no tests, skips no tests, cancels no jobs, and changes no CI behavior.
+- It sends no report unless `DIFFCI_API_URL` and `DIFFCI_TOKEN` are explicitly configured.
+- Treat selected commands as evidence about the change, not as permission to skip required project CI.
+- If DiffCI reports `REFUSED` or `ERROR`, fall back to the repository's normal validation commands.
+
+Useful docs:
+
+- AI agents: https://diffci.com/docs/ai-agents.html
+- Codex: https://diffci.com/docs/codex.html
+- Claude Code: https://diffci.com/docs/claude-code.html
+- Cursor: https://diffci.com/docs/cursor.html
+- GitHub Copilot: https://diffci.com/docs/copilot.html
+- Grok: https://diffci.com/docs/grok.html
+- Adoption kit: https://github.com/DiffCI/DiffCI.com/blob/main/docs/agent-adoption-kit.md
+- Adoption outreach: https://github.com/DiffCI/DiffCI.com/blob/main/docs/adoption-outreach.md
+- Adoption metrics: https://github.com/DiffCI/DiffCI.com/blob/main/docs/adoption-metrics.md
+- Adoption targets: https://github.com/DiffCI/DiffCI.com/blob/main/docs/agent-adoption-targets.md
+- MCP server: https://github.com/DiffCI/DiffCI.com/blob/main/docs/mcp.md
+- Distribution: https://github.com/DiffCI/DiffCI.com/blob/main/docs/distribution.md
+- Language support: https://github.com/DiffCI/DiffCI.com/blob/main/docs/language-support.md

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diffci.com/diffci",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "DiffCI - deterministic change-aware CI planning",
   "keywords": [
     "ci",
@@ -16,6 +16,7 @@
     "github-actions"
   ],
   "license": "AGPL-3.0-only",
+  "mcpName": "io.github.DiffCI/diffci",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/DiffCI/DiffCI.com.git"
@@ -33,8 +34,12 @@
     "action.yml",
     "dist-client/src/client",
     "README.md",
+    "server.json",
+    "glama.json",
     "llms.txt",
     "docs/ai-agents.md",
+    "docs/adoption-outreach.md",
+    "docs/adoption-metrics.md",
     "docs/agent-adoption-kit.md",
     "docs/agent-adoption-targets.md",
     "docs/mcp.md",

package/server.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.DiffCI/diffci",
+  "title": "DiffCI",
+  "description": "Observation-only CI/CD validation for AI coding agents.",
+  "version": "0.2.3",
+  "websiteUrl": "https://diffci.com/docs/ai-agents.html",
+  "repository": {
+    "url": "https://github.com/DiffCI/DiffCI.com",
+    "source": "github"
+  },
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@diffci.com/diffci",
+      "version": "0.2.3",
+      "transport": {
+        "type": "stdio"
+      },
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "mcp"
+        }
+      ]
+    }
+  ]
+}