@yawlabs/ctxlint 0.2.0 → 0.2.2

package/README.md

@@ -32,18 +32,23 @@ npx @yawlabs/ctxlint
 |------|------|
 | `CLAUDE.md`, `CLAUDE.local.md` | Claude Code |
 | `AGENTS.md` | Multi-agent |
-| `.cursorrules`, `.cursor/rules/*.md` | Cursor |
-| `copilot-instructions.md` | GitHub Copilot |
+| `.cursorrules`, `.cursor/rules/*.md`, `.cursor/rules/*.mdc` | Cursor |
+| `copilot-instructions.md`, `.github/copilot-instructions.md`, `.github/instructions/*.md` | GitHub Copilot |
 | `.windsurfrules`, `.windsurf/rules/*.md` | Windsurf |
 | `GEMINI.md` | Gemini |
 | `JULES.md` | Jules |
 | `.clinerules` | Cline |
+| `CODEX.md` | OpenAI Codex CLI |
+| `.aiderules` | Aider |
+| `.aide/rules/*.md` | Aide / Codestory |
+| `.amazonq/rules/*.md` | Amazon Q Developer |
+| `.goose/instructions.md` | Goose by Block |
 | `CONVENTIONS.md` | General |
 
 ## Example Output
 
 ```
-ctxlint v0.1.0
+ctxlint v0.2.1
 
 Scanning /Users/you/my-app...
 
@@ -133,11 +138,11 @@ CLI flags override config file settings.
 
 ## Use as MCP Server
 
-ctxlint ships with an MCP server that exposes three tools (`ctxlint_audit`, `ctxlint_validate_path`, `ctxlint_token_report`):
+ctxlint ships with an MCP server that exposes four tools (`ctxlint_audit`, `ctxlint_validate_path`, `ctxlint_token_report`, `ctxlint_fix`):
 
 ```bash
 # Claude Code
-claude mcp add ctxlint -- node node_modules/ctxlint/dist/mcp/server.js
+claude mcp add ctxlint -- node node_modules/@yawlabs/ctxlint/dist/mcp/server.js
 
 # Or run from source
 claude mcp add ctxlint -- node /path/to/ctxlint/dist/mcp/server.js

package/dist/index.js

@@ -18,6 +18,14 @@ import { glob } from "glob";
 // src/utils/fs.ts
 import * as fs from "fs";
 import * as path from "path";
+function loadPackageJson(projectRoot) {
+  try {
+    const content = fs.readFileSync(path.join(projectRoot, "package.json"), "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
 function fileExists(filePath) {
   try {
     fs.accessSync(filePath);
@@ -93,12 +101,18 @@ var CONTEXT_FILE_PATTERNS = [
   ".cursor/rules/*.mdc",
   "copilot-instructions.md",
   ".github/copilot-instructions.md",
+  ".github/instructions/*.md",
   ".windsurfrules",
   ".windsurf/rules/*.md",
   "GEMINI.md",
   "JULES.md",
   ".clinerules",
-  "CONVENTIONS.md"
+  "CONVENTIONS.md",
+  "CODEX.md",
+  ".aiderules",
+  ".aide/rules/*.md",
+  ".amazonq/rules/*.md",
+  ".goose/instructions.md"
 ];
 var IGNORED_DIRS2 = /* @__PURE__ */ new Set(["node_modules", ".git", "dist", "build", "vendor"]);
 async function scanForContextFiles(projectRoot) {
@@ -554,7 +568,7 @@ function findClosestMatch(target, files) {
 // src/core/checks/commands.ts
 import * as fs3 from "fs";
 import * as path4 from "path";
-var NPM_SCRIPT_PATTERN = /^(?:npm\s+run|pnpm(?:\s+run)?|yarn(?:\s+run)?)\s+(\S+)/;
+var NPM_SCRIPT_PATTERN = /^(?:npm\s+run|pnpm(?:\s+run)?|yarn(?:\s+run)?|bun(?:\s+run)?)\s+(\S+)/;
 var MAKE_PATTERN = /^make\s+(\S+)/;
 async function checkCommands(file, projectRoot) {
   const issues = [];
@@ -577,7 +591,7 @@ async function checkCommands(file, projectRoot) {
       }
       continue;
     }
-    const shorthandMatch = cmd.match(/^(npm|pnpm|yarn)\s+(test|start|build|dev|lint|format)\b/);
+    const shorthandMatch = cmd.match(/^(npm|pnpm|yarn|bun)\s+(test|start|build|dev|lint|format|check|typecheck|clean|serve|preview|e2e)\b/);
     if (shorthandMatch && pkgJson) {
       const scriptName = shorthandMatch[2];
       if (pkgJson.scripts && !(scriptName in pkgJson.scripts)) {
@@ -634,14 +648,6 @@ async function checkCommands(file, projectRoot) {
   }
   return issues;
 }
-function loadPackageJson(projectRoot) {
-  try {
-    const content = fs3.readFileSync(path4.join(projectRoot, "package.json"), "utf-8");
-    return JSON.parse(content);
-  } catch {
-    return null;
-  }
-}
 function loadMakefile(projectRoot) {
   try {
     return fs3.readFileSync(path4.join(projectRoot, "Makefile"), "utf-8");
@@ -764,7 +770,6 @@ function checkAggregateTokens(files) {
 }
 
 // src/core/checks/redundancy.ts
-import * as fs4 from "fs";
 import * as path6 from "path";
 var PACKAGE_TECH_MAP = {
   react: ["React", "react"],
@@ -819,7 +824,7 @@ var PACKAGE_TECH_MAP = {
 };
 async function checkRedundancy(file, projectRoot) {
   const issues = [];
-  const pkgJson = loadPackageJson2(projectRoot);
+  const pkgJson = loadPackageJson(projectRoot);
   if (pkgJson) {
     const allDeps = /* @__PURE__ */ new Set([
       ...Object.keys(pkgJson.dependencies || {}),
@@ -914,14 +919,6 @@ function calculateLineOverlap(contentA, contentB) {
   }
   return overlap / Math.min(linesA.size, linesB.size);
 }
-function loadPackageJson2(projectRoot) {
-  try {
-    const content = fs4.readFileSync(path6.join(projectRoot, "package.json"), "utf-8");
-    return JSON.parse(content);
-  } catch {
-    return null;
-  }
-}
 function escapeRegex(str) {
   return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
@@ -1026,7 +1023,7 @@ function formatIssue(issue) {
 }
 
 // src/core/fixer.ts
-import * as fs5 from "fs";
+import * as fs4 from "fs";
 import chalk2 from "chalk";
 function applyFixes(result) {
   const fixesByFile = /* @__PURE__ */ new Map();
@@ -1042,7 +1039,7 @@ function applyFixes(result) {
   let totalFixes = 0;
   const filesModified = [];
   for (const [filePath, fixes] of fixesByFile) {
-    const content = fs5.readFileSync(filePath, "utf-8");
+    const content = fs4.readFileSync(filePath, "utf-8");
     const lines = content.split("\n");
     let modified = false;
     const sortedFixes = [...fixes].sort((a, b) => b.line - a.line);
@@ -1060,7 +1057,7 @@ function applyFixes(result) {
       }
     }
     if (modified) {
-      fs5.writeFileSync(filePath, lines.join("\n"), "utf-8");
+      fs4.writeFileSync(filePath, lines.join("\n"), "utf-8");
       filesModified.push(filePath);
     }
   }
@@ -1068,14 +1065,14 @@ function applyFixes(result) {
 }
 
 // src/core/config.ts
-import * as fs6 from "fs";
+import * as fs5 from "fs";
 import * as path7 from "path";
 var CONFIG_FILENAMES = [".ctxlintrc", ".ctxlintrc.json"];
 function loadConfig(projectRoot) {
   for (const filename of CONFIG_FILENAMES) {
     const filePath = path7.join(projectRoot, filename);
     try {
-      const content = fs6.readFileSync(filePath, "utf-8");
+      const content = fs5.readFileSync(filePath, "utf-8");
       return JSON.parse(content);
     } catch {
       continue;
@@ -1089,11 +1086,11 @@ import * as path8 from "path";
 
 // src/version.ts
 function loadVersion() {
-  if (true) return "0.2.0";
-  const fs7 = __require("fs");
+  if (true) return "0.2.2";
+  const fs6 = __require("fs");
   const path9 = __require("path");
   const pkgPath = path9.resolve(__dirname, "../package.json");
-  const pkg = JSON.parse(fs7.readFileSync(pkgPath, "utf-8"));
+  const pkg = JSON.parse(fs6.readFileSync(pkgPath, "utf-8"));
   return pkg.version;
 }
 var VERSION = loadVersion();
@@ -1251,30 +1248,30 @@ Fixed ${fixSummary.totalFixes} issue${fixSummary.totalFixes !== 1 ? "s" : ""} in
   }
 });
 program.command("init").description("Set up a git pre-commit hook that runs ctxlint --strict").action(async () => {
-  const fs7 = await import("fs");
+  const fs6 = await import("fs");
   const hooksDir = path8.resolve(".git", "hooks");
-  if (!fs7.existsSync(path8.resolve(".git"))) {
+  if (!fs6.existsSync(path8.resolve(".git"))) {
     console.error('Error: not a git repository. Run "git init" first.');
     process.exit(1);
   }
-  if (!fs7.existsSync(hooksDir)) {
-    fs7.mkdirSync(hooksDir, { recursive: true });
+  if (!fs6.existsSync(hooksDir)) {
+    fs6.mkdirSync(hooksDir, { recursive: true });
   }
   const hookPath = path8.join(hooksDir, "pre-commit");
   const hookContent = `#!/bin/sh
 # ctxlint pre-commit hook
 npx @yawlabs/ctxlint --strict
 `;
-  if (fs7.existsSync(hookPath)) {
-    const existing = fs7.readFileSync(hookPath, "utf-8");
+  if (fs6.existsSync(hookPath)) {
+    const existing = fs6.readFileSync(hookPath, "utf-8");
     if (existing.includes("ctxlint")) {
       console.log("Pre-commit hook already includes ctxlint.");
       return;
     }
-    fs7.appendFileSync(hookPath, "\n" + hookContent);
+    fs6.appendFileSync(hookPath, "\n" + hookContent);
     console.log("Added ctxlint to existing pre-commit hook.");
   } else {
-    fs7.writeFileSync(hookPath, hookContent, { mode: 493 });
+    fs6.writeFileSync(hookPath, hookContent, { mode: 493 });
     console.log("Created pre-commit hook at .git/hooks/pre-commit");
   }
   console.log("ctxlint will now run automatically before each commit.");

package/dist/mcp/server.js

@@ -18,6 +18,14 @@ import { glob } from "glob";
 // src/utils/fs.ts
 import * as fs from "fs";
 import * as path from "path";
+function loadPackageJson(projectRoot) {
+  try {
+    const content = fs.readFileSync(path.join(projectRoot, "package.json"), "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
 function fileExists(filePath) {
   try {
     fs.accessSync(filePath);
@@ -93,12 +101,18 @@ var CONTEXT_FILE_PATTERNS = [
   ".cursor/rules/*.mdc",
   "copilot-instructions.md",
   ".github/copilot-instructions.md",
+  ".github/instructions/*.md",
   ".windsurfrules",
   ".windsurf/rules/*.md",
   "GEMINI.md",
   "JULES.md",
   ".clinerules",
-  "CONVENTIONS.md"
+  "CONVENTIONS.md",
+  "CODEX.md",
+  ".aiderules",
+  ".aide/rules/*.md",
+  ".amazonq/rules/*.md",
+  ".goose/instructions.md"
 ];
 var IGNORED_DIRS2 = /* @__PURE__ */ new Set(["node_modules", ".git", "dist", "build", "vendor"]);
 async function scanForContextFiles(projectRoot) {
@@ -551,7 +565,7 @@ function findClosestMatch(target, files) {
 // src/core/checks/commands.ts
 import * as fs3 from "fs";
 import * as path4 from "path";
-var NPM_SCRIPT_PATTERN = /^(?:npm\s+run|pnpm(?:\s+run)?|yarn(?:\s+run)?)\s+(\S+)/;
+var NPM_SCRIPT_PATTERN = /^(?:npm\s+run|pnpm(?:\s+run)?|yarn(?:\s+run)?|bun(?:\s+run)?)\s+(\S+)/;
 var MAKE_PATTERN = /^make\s+(\S+)/;
 async function checkCommands(file, projectRoot) {
   const issues = [];
@@ -574,7 +588,7 @@ async function checkCommands(file, projectRoot) {
       }
       continue;
     }
-    const shorthandMatch = cmd.match(/^(npm|pnpm|yarn)\s+(test|start|build|dev|lint|format)\b/);
+    const shorthandMatch = cmd.match(/^(npm|pnpm|yarn|bun)\s+(test|start|build|dev|lint|format|check|typecheck|clean|serve|preview|e2e)\b/);
     if (shorthandMatch && pkgJson) {
       const scriptName = shorthandMatch[2];
       if (pkgJson.scripts && !(scriptName in pkgJson.scripts)) {
@@ -631,14 +645,6 @@ async function checkCommands(file, projectRoot) {
   }
   return issues;
 }
-function loadPackageJson(projectRoot) {
-  try {
-    const content = fs3.readFileSync(path4.join(projectRoot, "package.json"), "utf-8");
-    return JSON.parse(content);
-  } catch {
-    return null;
-  }
-}
 function loadMakefile(projectRoot) {
   try {
     return fs3.readFileSync(path4.join(projectRoot, "Makefile"), "utf-8");
@@ -755,7 +761,6 @@ function checkAggregateTokens(files) {
 }
 
 // src/core/checks/redundancy.ts
-import * as fs4 from "fs";
 import * as path6 from "path";
 var PACKAGE_TECH_MAP = {
   react: ["React", "react"],
@@ -810,7 +815,7 @@ var PACKAGE_TECH_MAP = {
 };
 async function checkRedundancy(file, projectRoot) {
   const issues = [];
-  const pkgJson = loadPackageJson2(projectRoot);
+  const pkgJson = loadPackageJson(projectRoot);
   if (pkgJson) {
     const allDeps = /* @__PURE__ */ new Set([
       ...Object.keys(pkgJson.dependencies || {}),
@@ -905,24 +910,58 @@ function calculateLineOverlap(contentA, contentB) {
   }
   return overlap / Math.min(linesA.size, linesB.size);
 }
-function loadPackageJson2(projectRoot) {
-  try {
-    const content = fs4.readFileSync(path6.join(projectRoot, "package.json"), "utf-8");
-    return JSON.parse(content);
-  } catch {
-    return null;
-  }
-}
 function escapeRegex(str) {
   return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 
+// src/core/fixer.ts
+import * as fs4 from "fs";
+import chalk from "chalk";
+function applyFixes(result) {
+  const fixesByFile = /* @__PURE__ */ new Map();
+  for (const file of result.files) {
+    for (const issue of file.issues) {
+      if (issue.fix) {
+        const existing = fixesByFile.get(issue.fix.file) || [];
+        existing.push(issue.fix);
+        fixesByFile.set(issue.fix.file, existing);
+      }
+    }
+  }
+  let totalFixes = 0;
+  const filesModified = [];
+  for (const [filePath, fixes] of fixesByFile) {
+    const content = fs4.readFileSync(filePath, "utf-8");
+    const lines = content.split("\n");
+    let modified = false;
+    const sortedFixes = [...fixes].sort((a, b) => b.line - a.line);
+    for (const fix of sortedFixes) {
+      const lineIdx = fix.line - 1;
+      if (lineIdx < 0 || lineIdx >= lines.length) continue;
+      const line = lines[lineIdx];
+      if (line.includes(fix.oldText)) {
+        lines[lineIdx] = line.replace(fix.oldText, fix.newText);
+        modified = true;
+        totalFixes++;
+        console.log(
+          chalk.green("  Fixed") + ` Line ${fix.line}: ${chalk.dim(fix.oldText)} ${chalk.dim("\u2192")} ${fix.newText}`
+        );
+      }
+    }
+    if (modified) {
+      fs4.writeFileSync(filePath, lines.join("\n"), "utf-8");
+      filesModified.push(filePath);
+    }
+  }
+  return { totalFixes, filesModified };
+}
+
 // src/mcp/server.ts
 import * as path7 from "path";
 
 // src/version.ts
 function loadVersion() {
-  if (true) return "0.2.0";
+  if (true) return "0.2.2";
   const fs5 = __require("fs");
   const path8 = __require("path");
   const pkgPath = path8.resolve(__dirname, "../package.json");
@@ -1035,6 +1074,47 @@ server.tool(
     }
   }
 );
+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(z.enum(["paths", "commands", "staleness", "tokens", "redundancy"])).optional().describe("Which checks to run before fixing. Defaults to all.")
+  },
+  async ({ projectPath, checks }) => {
+    const root = path7.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();
+    }
+  }
+);
 async function runAudit(projectRoot, activeChecks) {
   const discovered = await scanForContextFiles(projectRoot);
   const parsed = discovered.map((f) => parseContextFile(f));

package/package.json

@@ -1,20 +1,11 @@
 {
   "name": "@yawlabs/ctxlint",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Lint your AI agent context files (CLAUDE.md, AGENTS.md, etc.) against your actual codebase",
   "bin": {
     "ctxlint": "dist/index.js"
   },
   "type": "module",
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "test": "vitest",
-    "test:run": "vitest run",
-    "lint": "eslint src/",
-    "format": "prettier --write src/",
-    "mcp": "node dist/mcp/server.js"
-  },
   "keywords": [
     "claude",
     "agents",
@@ -41,7 +32,6 @@
   "engines": {
     "node": ">=20"
   },
-  "packageManager": "pnpm@10.33.0",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "chalk": "^5.6.2",
@@ -64,9 +54,13 @@
     "typescript-eslint": "^8.58.0",
     "vitest": "^4.1.2"
   },
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "esbuild"
-    ]
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "lint": "eslint src/",
+    "format": "prettier --write src/",
+    "mcp": "node dist/mcp/server.js"
   }
-}
+}