@yawlabs/ctxlint 0.2.2 → 0.4.0

package/dist/server-7C2IQ7VV.js

@@ -0,0 +1,202 @@
+#!/usr/bin/env node
+import {
+  ALL_CHECKS,
+  VERSION,
+  applyFixes,
+  fileExists,
+  findRenames,
+  freeEncoder,
+  isDirectory,
+  parseContextFile,
+  resetGit,
+  runAudit,
+  scanForContextFiles
+} from "./chunk-WEYNMCAH.js";
+
+// src/mcp/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import * as path from "path";
+var checkEnum = z.enum([
+  "paths",
+  "commands",
+  "staleness",
+  "tokens",
+  "redundancy",
+  "contradictions",
+  "frontmatter"
+]);
+var server = new McpServer({
+  name: "ctxlint",
+  version: VERSION
+});
+server.tool(
+  "ctxlint_audit",
+  "Audit all AI agent context files (CLAUDE.md, AGENTS.md, etc.) in the project for stale references, invalid commands, redundant content, contradictions, frontmatter issues, and token waste.",
+  {
+    projectPath: z.string().optional().describe("Path to the project root. Defaults to current working directory."),
+    checks: z.array(checkEnum).optional().describe("Which checks to run. Defaults to all.")
+  },
+  {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+  },
+  async ({ projectPath, checks }) => {
+    const root = path.resolve(projectPath || process.cwd());
+    const activeChecks = checks || ALL_CHECKS;
+    try {
+      const result = await runAudit(root, activeChecks);
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return {
+        content: [{ type: "text", text: JSON.stringify({ error: msg }) }],
+        isError: true
+      };
+    } finally {
+      freeEncoder();
+      resetGit();
+    }
+  }
+);
+server.tool(
+  "ctxlint_validate_path",
+  "Check if a file path referenced in a context file actually exists in the project. Returns the file status and suggests corrections if the path is invalid.",
+  {
+    path: z.string().describe("The file path to validate"),
+    projectPath: z.string().optional().describe("Project root. Defaults to cwd.")
+  },
+  {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+  },
+  async ({ path: filePath, projectPath }) => {
+    try {
+      const root = path.resolve(projectPath || process.cwd());
+      const resolved = path.resolve(root, filePath);
+      const result = {
+        path: filePath,
+        exists: fileExists(resolved) || isDirectory(resolved)
+      };
+      if (!result.exists) {
+        const rename = await findRenames(root, filePath);
+        if (rename) {
+          result.renamed = true;
+          result.newPath = rename.newPath;
+          result.renameCommit = rename.commitHash;
+          result.daysAgo = rename.daysAgo;
+        }
+      }
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return {
+        content: [{ type: "text", text: JSON.stringify({ error: msg }) }],
+        isError: true
+      };
+    } finally {
+      resetGit();
+    }
+  }
+);
+server.tool(
+  "ctxlint_token_report",
+  "Get a token count breakdown for all context files in the project. Shows per-file and aggregate token usage, plus estimated waste from redundant content.",
+  {
+    projectPath: z.string().optional().describe("Project root. Defaults to cwd.")
+  },
+  {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+  },
+  async ({ projectPath }) => {
+    const root = path.resolve(projectPath || process.cwd());
+    try {
+      const discovered = await scanForContextFiles(root);
+      const parsed = discovered.map((f) => parseContextFile(f));
+      const files = parsed.map((f) => ({
+        path: f.relativePath,
+        tokens: f.totalTokens,
+        lines: f.totalLines,
+        isSymlink: f.isSymlink
+      }));
+      const totalTokens = files.reduce((sum, f) => sum + f.tokens, 0);
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(
+              { files, totalTokens, note: "Token counts use GPT-4 cl100k_base tokenizer" },
+              null,
+              2
+            )
+          }
+        ]
+      };
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return {
+        content: [{ type: "text", text: JSON.stringify({ error: msg }) }],
+        isError: true
+      };
+    } finally {
+      freeEncoder();
+    }
+  }
+);
+server.tool(
+  "ctxlint_fix",
+  "Run the linter with --fix mode to auto-correct broken file paths in context files using git history and fuzzy matching. Returns a summary of what was fixed.",
+  {
+    projectPath: z.string().optional().describe("Path to the project root. Defaults to current working directory."),
+    checks: z.array(checkEnum).optional().describe("Which checks to run before fixing. Defaults to all.")
+  },
+  {
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false
+  },
+  async ({ projectPath, checks }) => {
+    const root = path.resolve(projectPath || process.cwd());
+    const activeChecks = checks || ALL_CHECKS;
+    try {
+      const result = await runAudit(root, activeChecks);
+      const fixSummary = applyFixes(result);
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(
+              {
+                totalFixes: fixSummary.totalFixes,
+                filesModified: fixSummary.filesModified,
+                remainingIssues: result.summary
+              },
+              null,
+              2
+            )
+          }
+        ]
+      };
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return {
+        content: [{ type: "text", text: JSON.stringify({ error: msg }) }],
+        isError: true
+      };
+    } finally {
+      freeEncoder();
+      resetGit();
+    }
+  }
+);
+var transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yawlabs/ctxlint",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "description": "Lint your AI agent context files (CLAUDE.md, AGENTS.md, etc.) against your actual codebase",
   "bin": {
     "ctxlint": "dist/index.js"
@@ -11,11 +11,19 @@
     "agents",
     "context",
     "lint",
+    "linter",
     "claude-md",
     "agents-md",
     "ai-coding",
     "context-engineering",
-    "mcp"
+    "mcp",
+    "cursorrules",
+    "copilot-instructions",
+    "windsurfrules",
+    "pre-commit",
+    "agentic",
+    "codex",
+    "sarif"
   ],
   "files": [
     "dist",
@@ -30,7 +38,7 @@
   "homepage": "https://github.com/yawlabs/ctxlint",
   "author": "Yaw Labs <contact@yaw.sh>",
   "engines": {
-    "node": ">=20"
+    "node": ">=18"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",