@agent-lint/mcp 0.2.0 → 0.3.0

package/README.md

@@ -1,17 +1,17 @@
 # @agent-lint/mcp
 
-MCP server for AI agent context artifact analysis and quality scoring.
+MCP server for AI agent context artifact orchestration.
 
 **Zero LLM dependencies.** Fully deterministic. Local-first. No database. No auth.
 
 ## What It Does
 
-Provides a [Model Context Protocol](https://modelcontextprotocol.io/) server that evaluates AI-agent context artifacts:
+Provides a [Model Context Protocol](https://modelcontextprotocol.io/) server that guides your coding agent in creating, maintaining, and improving AI-agent context artifacts:
 
 - `AGENTS.md` / `CLAUDE.md`
 - Skills, Rules, Workflows, Plans
 
-Reproducible quality scoring across **12 metrics**, evidence-backed assessment, guardrail checks, and repeatable improvement loops — all without calling any LLM.
+Comprehensive guidelines, workspace scanning, maintenance rules, and repeatable improvement loops — all without calling any LLM.
 
 ## Quick Start
 
@@ -28,7 +28,7 @@ Add to `.cursor/mcp.json`:
 ```json
 {
   "mcpServers": {
-    "agent-lint": {
+    "agentlint": {
       "command": "npx",
       "args": ["-y", "@agent-lint/mcp"]
     }
@@ -43,7 +43,7 @@ Add to `claude_desktop_config.json`:
 ```json
 {
   "mcpServers": {
-    "agent-lint": {
+    "agentlint": {
       "command": "npx",
       "args": ["-y", "@agent-lint/mcp"]
     }
@@ -53,16 +53,15 @@ Add to `claude_desktop_config.json`:
 
 ### VS Code
 
-Add to your VS Code `settings.json`:
+Add to `.vscode/mcp.json`:
 
 ```json
 {
-  "mcp": {
-    "servers": {
-      "agent-lint": {
-        "command": "npx",
-        "args": ["-y", "@agent-lint/mcp"]
-      }
+  "servers": {
+    "agentlint": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@agent-lint/mcp"]
     }
   }
 }
@@ -70,12 +69,12 @@ Add to your VS Code `settings.json`:
 
 ### Windsurf
 
-Add to your Windsurf MCP config:
+Add to `.windsurf/mcp_config.json`:
 
 ```json
 {
   "mcpServers": {
-    "agent-lint": {
+    "agentlint": {
       "command": "npx",
       "args": ["-y", "@agent-lint/mcp"]
     }
@@ -83,19 +82,32 @@ Add to your Windsurf MCP config:
 }
 ```
 
-## Available Tools
+## Available Tools (4)
+
+| Tool | Description |
+| ---- | ----------- |
+| `agentlint_get_guidelines` | Returns comprehensive guidelines for creating or updating any artifact type — mandatory sections, do/don't lists, anti-patterns, templates, and quality checklist |
+| `agentlint_plan_workspace_autofix` | Scans your workspace, discovers all context artifacts, identifies missing files and incomplete sections, and returns a step-by-step fix plan |
+| `agentlint_quick_check` | After structural changes (new modules, config changes, dependency updates), checks if context artifacts need updating |
+| `agentlint_emit_maintenance_snippet` | Returns a persistent rule snippet for your IDE that keeps your agent maintaining context automatically |
+
+## MCP Resources (3)
+
+| Resource | Content |
+| -------- | ------- |
+| `agentlint://guidelines/{type}` | Full guidelines for an artifact type |
+| `agentlint://template/{type}` | Skeleton template for creating a new artifact |
+| `agentlint://path-hints/{type}` | File discovery patterns per IDE client |
+
+## Supported Artifact Types
 
-| Tool                           | Description                                                                          |
-| ------------------------------ | ------------------------------------------------------------------------------------ |
-| `analyze_artifact`             | Analyze a single artifact — returns scores across 12 metrics with findings and hints |
-| `analyze_workspace_artifacts`  | Scan a workspace directory for AI agent artifacts with framework detection           |
-| `analyze_context_bundle`       | Analyze multiple artifacts together for cross-artifact consistency                   |
-| `prepare_artifact_fix_context` | Prepare context for an artifact improvement loop                                     |
-| `submit_client_assessment`     | Submit a client LLM assessment with evidence-backed scores                           |
-| `quality_gate_artifact`        | Check if an artifact meets a target quality score                                    |
-| `suggest_patch`                | Generate patch suggestions to improve an artifact                                    |
-| `apply_patches`                | Apply patches to local files with hash guard, allowlist, and backup protection       |
-| `validate_export`              | Validate final artifact output for safety and correctness                            |
+| Type | File Patterns |
+| ---- | ------------- |
+| **Agents** | `AGENTS.md`, `CLAUDE.md`, `.github/copilot-instructions.md` |
+| **Rules** | `.cursor/rules/*.md`, `.windsurf/rules/*.md` |
+| **Skills** | `.cursor/skills/*/SKILL.md`, `.windsurf/skills/*/SKILL.md` |
+| **Workflows** | `.cursor/workflows/*.md`, `.windsurf/workflows/*.md` |
+| **Plans** | `docs/*.md`, `.windsurf/plans/*.md` |
 
 ## Quality Metrics (12)
 
@@ -121,7 +133,7 @@ npx @agent-lint/mcp --http --port 3001
 
 - **No LLM**: Fully deterministic. No API calls, no tokens, no cost.
 - **No State**: Every call is stateless. No database, no cache.
-- **No File Writes**: Read-only by default. `apply_patches` requires explicit flags + hash guard.
+- **No File Writes**: Read-only. Agent Lint provides guidance — your coding agent does the work.
 - **Minimum Dependencies**: Published package under 500 KB packed.
 
 ## Related

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -4,7 +4,7 @@ import {
   logMcp,
   runHttpServer,
   runStdioServer
-} from "./chunk-VAI3GWJA.js";
+} from "./chunk-ZYDIOQXE.js";
 
 // src/bin.ts
 var nodeVersion = parseInt(process.versions.node.split(".")[0], 10);