@agent-lint/mcp 0.3.0 → 0.3.4

package/CHANGELOG.md

@@ -0,0 +1,44 @@
+# @agent-lint/mcp Changelog
+
+## 0.3.4
+
+### Patch Changes
+
+- a4047fa: Fix doctor workspace discovery and report persistence regressions, and align cross-platform fixture coverage for CLI and MCP outputs.
+
+## [0.3.3]
+
+### Fixed
+
+- GitLab publish jobs now support both plain and file-based `NPM_TOKEN` variables and fail fast on invalid npm auth
+
+## [0.3.2]
+
+### Changed
+
+- README and npm description now use the current public positioning around structured, current, codebase-aware agent context
+- Public repository cleanup removed internal planning docs from the published surface
+
+## [0.3.1]
+
+### Changed
+
+- README, npm metadata, and release metadata now match the current 4-tool MCP surface
+
+### Fixed
+
+- Tool timeout wiring is now attached to the active public tools
+- Server version resolution now prefers the package version instead of unrelated workspace env values
+
+## [0.3.0]
+
+### Added
+
+- Read-only MCP server with 4 tools and 3 resources
+- Stdio and HTTP transports
+- Programmatic server creation helpers
+
+### Fixed
+
+- Current tool timeout wiring now matches the public tool surface
+- Server version reporting now resolves to the real package version

package/README.md

@@ -1,121 +1,39 @@
 # @agent-lint/mcp
 
-MCP server for AI agent context artifact orchestration.
+Read-only MCP server for keeping `AGENTS.md`, rules, and skills structured, current, and codebase-aware.
 
-**Zero LLM dependencies.** Fully deterministic. Local-first. No database. No auth.
-
-## What It Does
-
-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
-
-Comprehensive guidelines, workspace scanning, maintenance rules, and repeatable improvement loops — all without calling any LLM.
-
-## Quick Start
+## Start the Server
 
 ```bash
 npx -y @agent-lint/mcp
 ```
 
-## MCP Client Configuration
-
-### Cursor
-
-Add to `.cursor/mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "agentlint": {
-      "command": "npx",
-      "args": ["-y", "@agent-lint/mcp"]
-    }
-  }
-}
-```
-
-### Claude Desktop
-
-Add to `claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "agentlint": {
-      "command": "npx",
-      "args": ["-y", "@agent-lint/mcp"]
-    }
-  }
-}
-```
-
-### VS Code
-
-Add to `.vscode/mcp.json`:
-
-```json
-{
-  "servers": {
-    "agentlint": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@agent-lint/mcp"]
-    }
-  }
-}
-```
+For most users, the fastest setup path is still:
 
-### Windsurf
-
-Add to `.windsurf/mcp_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "agentlint": {
-      "command": "npx",
-      "args": ["-y", "@agent-lint/mcp"]
-    }
-  }
-}
+```bash
+npx @agent-lint/cli init
 ```
 
-## Available Tools (4)
+## Current Tool Surface
 
-| 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 |
+| Tool | Purpose |
+| --- | --- |
+| `agentlint_get_guidelines` | Return artifact guidance before creating or updating context files |
+| `agentlint_plan_workspace_autofix` | Scan a workspace and return a step-by-step fix plan |
+| `agentlint_quick_check` | Decide whether recent code changes require context updates |
+| `agentlint_emit_maintenance_snippet` | Return a reusable maintenance rule snippet for supported IDEs |
 
-## MCP Resources (3)
+## Current Resource Surface
 
-| 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
-
-| 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)
-
-`clarity` · `specificity` · `scope-control` · `completeness` · `actionability` · `verifiability` · `safety` · `injection-resistance` · `secret-hygiene` · `token-efficiency` · `platform-fit` · `maintainability`
+| Resource | Purpose |
+| --- | --- |
+| `agentlint://guidelines/{type}` | Readable guidelines for one artifact type |
+| `agentlint://template/{type}` | Skeleton template for a new artifact |
+| `agentlint://path-hints/{type}` | IDE-specific file discovery hints |
 
 ## Programmatic Usage
 
-```typescript
+```ts
 import { createAgentLintMcpServer } from "@agent-lint/mcp";
 
 const server = createAgentLintMcpServer({
@@ -129,17 +47,23 @@ const server = createAgentLintMcpServer({
 npx @agent-lint/mcp --http --port 3001
 ```
 
-## Design Principles
+Notes:
+
+- HTTP mode keeps the public surface read-only.
+- Workspace scanning is disabled in HTTP mode unless you explicitly enable it.
+
+## Design Constraints
 
-- **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. Agent Lint provides guidance — your coding agent does the work.
-- **Minimum Dependencies**: Published package under 500 KB packed.
+- No server-side LLM calls
+- No database or cache
+- No file writes from the MCP server
+- Local stderr logging only
 
 ## Related
 
-- [`@agent-lint/cli`](https://www.npmjs.com/package/@agent-lint/cli) — CLI interface
-- [Repository](https://gitlab.com/bsamilozturk/agentlint)
+- [Root README](https://github.com/samilytu/agentlint)
+- [CLI package](https://www.npmjs.com/package/@agent-lint/cli)
+- [Authoritative publish source](https://gitlab.com/bsamilozturk/agentlint)
 
 ## License
 

package/dist/bin.js

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

package/dist/catalog.d.ts

@@ -0,0 +1,5 @@
+export declare const CURRENT_TOOL_IDS: readonly ["agentlint_get_guidelines", "agentlint_plan_workspace_autofix", "agentlint_quick_check", "agentlint_emit_maintenance_snippet"];
+export declare const CURRENT_RESOURCE_URIS: readonly ["agentlint://guidelines/{type}", "agentlint://template/{type}", "agentlint://path-hints/{type}"];
+export declare const CURRENT_TOOL_TIMEOUTS: Record<(typeof CURRENT_TOOL_IDS)[number], number>;
+export declare const LEGACY_TOOL_TIMEOUT_ALIASES: Record<string, number>;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,0IAKnB,CAAC;AAEX,eAAO,MAAM,qBAAqB,4GAIxB,CAAC;AAEX,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAKnF,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAU9D,CAAC"}