@yawlabs/ctxlint 0.9.1 → 0.9.2

package/dist/index.js

@@ -447,8 +447,8 @@ var init_parseUtil = __esm({
     init_errors();
     init_en();
     makeIssue = (params) => {
-      const { data, path: path11, errorMaps, issueData } = params;
-      const fullPath = [...path11, ...issueData.path || []];
+      const { data, path: path12, errorMaps, issueData } = params;
+      const fullPath = [...path12, ...issueData.path || []];
       const fullIssue = {
         ...issueData,
         path: fullPath
@@ -728,11 +728,11 @@ var init_types = __esm({
     init_parseUtil();
     init_util();
     ParseInputLazyPath = class {
-      constructor(parent, value, path11, key) {
+      constructor(parent, value, path12, key) {
         this._cachedPath = [];
         this.parent = parent;
         this.data = value;
-        this._path = path11;
+        this._path = path12;
         this._key = key;
       }
       get path() {
@@ -4237,10 +4237,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path11) {
-  if (!path11)
+function getElementAtPath(obj, path12) {
+  if (!path12)
     return obj;
-  return path11.reduce((acc, key) => acc?.[key], obj);
+  return path12.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -4552,11 +4552,11 @@ function aborted(x3, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path11, issues) {
+function prefixIssues(path12, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path11);
+    iss.path.unshift(path12);
     return iss;
   });
 }
@@ -4798,7 +4798,7 @@ function formatError(error49, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error49, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error50, path11 = []) => {
+  const processError = (error50, path12 = []) => {
     var _a3, _b;
     for (const issue2 of error50.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
@@ -4808,7 +4808,7 @@ function treeifyError(error49, mapper = (issue2) => issue2.message) {
       } else if (issue2.code === "invalid_element") {
         processError({ issues: issue2.issues }, issue2.path);
       } else {
-        const fullpath = [...path11, ...issue2.path];
+        const fullpath = [...path12, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -4840,8 +4840,8 @@ function treeifyError(error49, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path11 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path11) {
+  const path12 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path12) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -17791,13 +17791,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path11 = ref.slice(1).split("/").filter(Boolean);
-  if (path11.length === 0) {
+  const path12 = ref.slice(1).split("/").filter(Boolean);
+  if (path12.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path11[0] === defsKey) {
-    const key = path11[1];
+  if (path12[0] === defsKey) {
+    const key = path12[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -25887,8 +25887,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path11) {
-      let input = path11;
+    function removeDotSegments(path12) {
+      let input = path12;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -26087,8 +26087,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path11, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path11 && path11 !== "/" ? path11 : void 0;
+        const [path12, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path12 && path12 !== "/" ? path12 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -29450,12 +29450,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f2;
     };
-    function addFormats(ajv, list, fs9, exportName) {
+    function addFormats(ajv, list, fs10, exportName) {
       var _a3;
       var _b;
       (_a3 = (_b = ajv.opts.code).formats) !== null && _a3 !== void 0 ? _a3 : _b.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
       for (const f2 of list)
-        ajv.addFormat(f2, fs9[f2]);
+        ajv.addFormat(f2, fs10[f2]);
     }
     module.exports = exports = formatsPlugin;
     Object.defineProperty(exports, "__esModule", { value: true });
@@ -34904,13 +34904,13 @@ var require_tiktoken = __commonJS({
     var wasm = require_tiktoken_bg();
     var imports = {};
     imports["./tiktoken_bg.js"] = wasm;
-    var path11 = __require("path");
-    var fs9 = __require("fs");
-    var candidates = __dirname.split(path11.sep).reduce((memo, _3, index, array2) => {
-      const prefix = array2.slice(0, index + 1).join(path11.sep) + path11.sep;
-      if (!prefix.includes("node_modules" + path11.sep)) {
+    var path12 = __require("path");
+    var fs10 = __require("fs");
+    var candidates = __dirname.split(path12.sep).reduce((memo, _3, index, array2) => {
+      const prefix = array2.slice(0, index + 1).join(path12.sep) + path12.sep;
+      if (!prefix.includes("node_modules" + path12.sep)) {
         memo.unshift(
-          path11.join(
+          path12.join(
             prefix,
             "node_modules",
             "tiktoken",
@@ -34921,11 +34921,11 @@ var require_tiktoken = __commonJS({
       }
       return memo;
     }, []);
-    candidates.unshift(path11.join(__dirname, "./tiktoken_bg.wasm"));
+    candidates.unshift(path12.join(__dirname, "./tiktoken_bg.wasm"));
     var bytes = null;
     for (const candidate of candidates) {
       try {
-        bytes = fs9.readFileSync(candidate);
+        bytes = fs10.readFileSync(candidate);
         break;
       } catch {
       }
@@ -35841,15 +35841,15 @@ var require_src2 = __commonJS({
     var fs_1 = __require("fs");
     var debug_1 = __importDefault(require_src());
     var log = debug_1.default("@kwsites/file-exists");
-    function check2(path11, isFile, isDirectory2) {
-      log(`checking %s`, path11);
+    function check2(path12, isFile, isDirectory2) {
+      log(`checking %s`, path12);
       try {
-        const stat2 = fs_1.statSync(path11);
-        if (stat2.isFile() && isFile) {
+        const stat3 = fs_1.statSync(path12);
+        if (stat3.isFile() && isFile) {
           log(`[OK] path represents a file`);
           return true;
         }
-        if (stat2.isDirectory() && isDirectory2) {
+        if (stat3.isDirectory() && isDirectory2) {
           log(`[OK] path represents a directory`);
           return true;
         }
@@ -35864,8 +35864,8 @@ var require_src2 = __commonJS({
         throw e;
       }
     }
-    function exists2(path11, type = exports.READABLE) {
-      return check2(path11, (type & exports.FILE) > 0, (type & exports.FOLDER) > 0);
+    function exists2(path12, type = exports.READABLE) {
+      return check2(path12, (type & exports.FILE) > 0, (type & exports.FOLDER) > 0);
     }
     exports.exists = exists2;
     exports.FILE = 1;
@@ -36359,8 +36359,8 @@ function toLinesWithContent(input = "", trimmed2 = true, separator = "\n") {
 function forEachLineWithContent(input, callback) {
   return toLinesWithContent(input, true).map((line) => callback(line));
 }
-function folderExists(path11) {
-  return (0, import_file_exists.exists)(path11, import_file_exists.FOLDER);
+function folderExists(path12) {
+  return (0, import_file_exists.exists)(path12, import_file_exists.FOLDER);
 }
 function append(target, item) {
   if (Array.isArray(target)) {
@@ -36551,8 +36551,8 @@ function checkIsRepoRootTask() {
     commands,
     format: "utf-8",
     onError,
-    parser(path11) {
-      return /^\.(git)?$/.test(path11.trim());
+    parser(path12) {
+      return /^\.(git)?$/.test(path12.trim());
     }
   };
 }
@@ -36808,11 +36808,11 @@ function parseGrep(grep) {
   const paths = /* @__PURE__ */ new Set();
   const results = {};
   forEachLineWithContent(grep, (input) => {
-    const [path11, line, preview] = input.split(NULL);
-    paths.add(path11);
-    (results[path11] = results[path11] || []).push({
+    const [path12, line, preview] = input.split(NULL);
+    paths.add(path12);
+    (results[path12] = results[path12] || []).push({
       line: asNumber(line),
-      path: path11,
+      path: path12,
       preview
     });
   });
@@ -37109,14 +37109,14 @@ function hashObjectTask(filePath, write) {
   }
   return straightThroughStringTask(commands, true);
 }
-function parseInit(bare, path11, text) {
+function parseInit(bare, path12, text) {
   const response = String(text).trim();
   let result;
   if (result = initResponseRegex.exec(response)) {
-    return new InitSummary(bare, path11, false, result[1]);
+    return new InitSummary(bare, path12, false, result[1]);
   }
   if (result = reInitResponseRegex.exec(response)) {
-    return new InitSummary(bare, path11, true, result[1]);
+    return new InitSummary(bare, path12, true, result[1]);
   }
   let gitDir = "";
   const tokens = response.split(" ");
@@ -37127,12 +37127,12 @@ function parseInit(bare, path11, text) {
       break;
     }
   }
-  return new InitSummary(bare, path11, /^re/i.test(response), gitDir);
+  return new InitSummary(bare, path12, /^re/i.test(response), gitDir);
 }
 function hasBareCommand(command) {
   return command.includes(bareCommand);
 }
-function initTask(bare = false, path11, customArgs) {
+function initTask(bare = false, path12, customArgs) {
   const commands = ["init", ...customArgs];
   if (bare && !hasBareCommand(commands)) {
     commands.splice(1, 0, bareCommand);
@@ -37141,7 +37141,7 @@ function initTask(bare = false, path11, customArgs) {
     commands,
     format: "utf-8",
     parser(text) {
-      return parseInit(commands.includes("--bare"), path11, text);
+      return parseInit(commands.includes("--bare"), path12, text);
     }
   };
 }
@@ -37420,14 +37420,14 @@ function splitLine(result, lineStr) {
     default:
       return;
   }
-  function data(index, workingDir, path11) {
+  function data(index, workingDir, path12) {
     const raw = `${index}${workingDir}`;
     const handler = parsers6.get(raw);
     if (handler) {
-      handler(result, path11);
+      handler(result, path12);
     }
     if (raw !== "##" && raw !== "!!") {
-      result.files.push(new FileStatusSummary(path11, index, workingDir));
+      result.files.push(new FileStatusSummary(path12, index, workingDir));
     }
   }
 }
@@ -37614,8 +37614,8 @@ function deleteBranchTask(branch, forceDelete = false) {
   return task;
 }
 function toPath(input) {
-  const path11 = input.trim().replace(/^["']|["']$/g, "");
-  return path11 && normalize2(path11);
+  const path12 = input.trim().replace(/^["']|["']$/g, "");
+  return path12 && normalize2(path12);
 }
 function checkIgnoreTask(paths) {
   return {
@@ -37754,8 +37754,8 @@ function stashListTask(opt = {}, customArgs) {
     parser: parser4
   };
 }
-function addSubModuleTask(repo, path11) {
-  return subModuleTask(["add", repo, path11]);
+function addSubModuleTask(repo, path12) {
+  return subModuleTask(["add", repo, path12]);
 }
 function initSubModuleTask(customArgs) {
   return subModuleTask(["init", ...customArgs]);
@@ -39019,9 +39019,9 @@ var init_esm2 = __esm({
       "src/lib/responses/InitSummary.ts"() {
         "use strict";
         InitSummary = class {
-          constructor(bare, path11, existing, gitDir) {
+          constructor(bare, path12, existing, gitDir) {
             this.bare = bare;
-            this.path = path11;
+            this.path = path12;
             this.existing = existing;
             this.gitDir = gitDir;
           }
@@ -39554,12 +39554,12 @@ var init_esm2 = __esm({
         "use strict";
         fromPathRegex = /^(.+)\0(.+)$/;
         FileStatusSummary = class {
-          constructor(path11, index, working_dir) {
-            this.path = path11;
+          constructor(path12, index, working_dir) {
+            this.path = path12;
             this.index = index;
             this.working_dir = working_dir;
             if (index === "R" || working_dir === "R") {
-              const detail = fromPathRegex.exec(path11) || [null, path11, path11];
+              const detail = fromPathRegex.exec(path12) || [null, path12, path12];
               this.from = detail[2] || "";
               this.path = detail[1] || "";
             }
@@ -39821,9 +39821,9 @@ var init_esm2 = __esm({
               next
             );
           }
-          hashObject(path11, write) {
+          hashObject(path12, write) {
             return this._runTask(
-              hashObjectTask(path11, write === true),
+              hashObjectTask(path12, write === true),
               trailingFunctionArgument(arguments)
             );
           }
@@ -40460,8 +40460,8 @@ var init_esm2 = __esm({
           }
           return this._runTask(straightThroughStringTask2(command, this._trimmed), next);
         };
-        Git2.prototype.submoduleAdd = function(repo, path11, then) {
-          return this._runTask(addSubModuleTask2(repo, path11), trailingFunctionArgument2(arguments));
+        Git2.prototype.submoduleAdd = function(repo, path12, then) {
+          return this._runTask(addSubModuleTask2(repo, path12), trailingFunctionArgument2(arguments));
         };
         Git2.prototype.submoduleUpdate = function(args, then) {
           return this._runTask(
@@ -41470,6 +41470,9 @@ function setTokenThresholds(overrides) {
 function resetTokenThresholds() {
   currentThresholds = DEFAULT_THRESHOLDS;
 }
+function getTokenThresholds() {
+  return currentThresholds;
+}
 async function checkTokens(file2, _projectRoot) {
   const issues = [];
   const tokens = file2.totalTokens;
@@ -41520,14 +41523,187 @@ var init_tokens2 = __esm({
       info: 1e3,
       warning: 3e3,
       error: 8e3,
-      aggregate: 5e3
+      aggregate: 5e3,
+      tierBreakdown: 1e3,
+      tierAggregate: 4e3
     };
     currentThresholds = DEFAULT_THRESHOLDS;
   }
 });
 
-// src/core/checks/redundancy.ts
+// src/core/checks/tier-tokens.ts
+import * as fs5 from "node:fs";
 import * as path6 from "node:path";
+function hasPathsFrontmatter(content) {
+  const lines = content.split("\n");
+  if (lines[0]?.trim() !== "---") return false;
+  for (let i = 1; i < lines.length; i++) {
+    const line = lines[i];
+    if (line.trim() === "---") return false;
+    const match = line.match(/^paths\s*:\s*(.*)$/);
+    if (match) {
+      const val = match[1].trim();
+      if (val && val !== "[]") return true;
+      for (let j3 = i + 1; j3 < lines.length; j3++) {
+        const next = lines[j3];
+        if (next.trim() === "---") return false;
+        if (next.trim() === "") continue;
+        if (next.trim().startsWith("- ")) return true;
+        break;
+      }
+    }
+  }
+  return false;
+}
+function isAlwaysLoaded(file2) {
+  const rel = file2.relativePath.replace(/\\/g, "/");
+  if (rel.endsWith(".mdc")) return false;
+  if (rel.startsWith(".github/instructions/")) return false;
+  if (rel.includes("/rules/")) {
+    return !hasPathsFrontmatter(file2.content);
+  }
+  const basename2 = rel.split("/").pop() ?? "";
+  return ALWAYS_LOADED_BASENAMES.has(basename2);
+}
+function computeSectionCosts(file2) {
+  if (file2.sections.length === 0) return [];
+  const hasH2 = file2.sections.some((s) => s.level === 2);
+  const topLevel = hasH2 ? 2 : 1;
+  const lines = file2.content.split("\n");
+  return file2.sections.filter((s) => s.level === topLevel).map((s) => {
+    const body = lines.slice(s.startLine - 1, s.endLine).join("\n");
+    return { title: s.title, line: s.startLine, tokens: countTokens(body) };
+  }).sort((a, b2) => b2.tokens - a.tokens);
+}
+function loadSettingsSources(projectRoot) {
+  const sources = [];
+  const candidates = [
+    path6.join(projectRoot, ".claude", "settings.json"),
+    path6.join(projectRoot, ".claude", "settings.local.json"),
+    path6.join(process.env.HOME || process.env.USERPROFILE || "", ".claude", "settings.json")
+  ];
+  for (const p of candidates) {
+    try {
+      const content = fs5.readFileSync(p, "utf-8");
+      sources.push(JSON.parse(content));
+    } catch {
+    }
+  }
+  return sources;
+}
+function commandIsEnforced(cmd, settings) {
+  const lower = cmd.toLowerCase();
+  for (const s of settings) {
+    for (const entry of s.permissions?.deny ?? []) {
+      if (entry.toLowerCase().includes(lower)) return true;
+    }
+    for (const h of s.hooks?.PreToolUse ?? []) {
+      if ((h.matcher || "").toLowerCase().includes(lower)) return true;
+      for (const sub of h.hooks ?? []) {
+        if ((sub.command || "").toLowerCase().includes(lower)) return true;
+      }
+    }
+  }
+  return false;
+}
+function checkHardEnforcement(file2, settings) {
+  const issues = [];
+  const lines = file2.content.split("\n");
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (!INVIOLABLE_FRAMING.test(line)) continue;
+    COMMAND_IN_BACKTICKS.lastIndex = 0;
+    const matches = [...line.matchAll(COMMAND_IN_BACKTICKS)].map((m) => m[1]);
+    const cmd = matches.find((m) => /^[\w.-][\w\s.-]*/.test(m) && !m.includes("/"));
+    if (!cmd) continue;
+    if (commandIsEnforced(cmd, settings)) continue;
+    issues.push({
+      severity: "info",
+      check: "tier-tokens",
+      ruleId: "tier-tokens/hard-enforcement-missing",
+      line: i + 1,
+      message: `Inviolable framing ("${line.trim().slice(0, 80)}") without a hook to back it up`,
+      suggestion: `Rules in always-loaded files are advisory. For "${cmd}", add a PreToolUse hook (or permissions.deny entry) in .claude/settings.json so the command is physically blocked.`
+    });
+  }
+  return issues;
+}
+async function checkTierTokens(file2, projectRoot) {
+  if (!isAlwaysLoaded(file2)) return [];
+  const issues = [];
+  const threshold = getTokenThresholds().tierBreakdown;
+  if (file2.totalTokens >= threshold) {
+    const sectionCosts = computeSectionCosts(file2);
+    if (sectionCosts.length > 0) {
+      const top = sectionCosts.slice(0, TOP_SECTIONS_TO_REPORT);
+      const heaviest = top[0];
+      const pct = Math.round(heaviest.tokens / file2.totalTokens * 100);
+      const detail = top.map((s) => `  - "${s.title}" (L${s.line}): ~${s.tokens.toLocaleString()} tokens`).join("\n");
+      issues.push({
+        severity: "info",
+        check: "tier-tokens",
+        ruleId: "tier-tokens/section-breakdown",
+        line: heaviest.line,
+        message: `${file2.totalTokens.toLocaleString()} tokens loaded every session \u2014 heaviest top-level section${top.length === 1 ? "" : "s"}:`,
+        detail,
+        suggestion: `"${heaviest.title}" is ~${heaviest.tokens.toLocaleString()} tokens (${pct}% of file). Consider demoting to an on-demand tier (skill, subagent, or memory) so it loads only when relevant.`
+      });
+    }
+  }
+  const settings = loadSettingsSources(projectRoot);
+  issues.push(...checkHardEnforcement(file2, settings));
+  return issues;
+}
+function checkAggregateTierTokens(files) {
+  const alwaysLoaded = files.filter(isAlwaysLoaded);
+  if (alwaysLoaded.length < 2) return null;
+  const total = alwaysLoaded.reduce((sum, f2) => sum + f2.totalTokens, 0);
+  const threshold = getTokenThresholds().tierAggregate;
+  if (total < threshold) return null;
+  const breakdown = alwaysLoaded.slice().sort((a, b2) => b2.totalTokens - a.totalTokens).slice(0, 5).map((f2) => `  - ${f2.relativePath}: ~${f2.totalTokens.toLocaleString()} tokens`).join("\n");
+  return {
+    severity: "warning",
+    check: "tier-tokens",
+    ruleId: "tier-tokens/aggregate",
+    line: 0,
+    message: `${alwaysLoaded.length} always-loaded files total ${total.toLocaleString()} tokens \u2014 loaded every session`,
+    detail: breakdown,
+    suggestion: "Consider moving the largest files or their heaviest sections to on-demand tiers (skills, subagents, memory)."
+  };
+}
+var ALWAYS_LOADED_BASENAMES, TOP_SECTIONS_TO_REPORT, INVIOLABLE_FRAMING, COMMAND_IN_BACKTICKS;
+var init_tier_tokens = __esm({
+  async "src/core/checks/tier-tokens.ts"() {
+    "use strict";
+    await init_tokens();
+    init_tokens2();
+    ALWAYS_LOADED_BASENAMES = /* @__PURE__ */ new Set([
+      "CLAUDE.md",
+      "CLAUDE.local.md",
+      "AGENTS.md",
+      "AGENTS.override.md",
+      "AGENT.md",
+      "GEMINI.md",
+      ".cursorrules",
+      ".windsurfrules",
+      ".clinerules",
+      ".aiderules",
+      ".continuerules",
+      ".rules",
+      ".goosehints",
+      "replit.md",
+      "copilot-instructions.md",
+      "guidelines.md",
+      "instructions.md"
+    ]);
+    TOP_SECTIONS_TO_REPORT = 3;
+    INVIOLABLE_FRAMING = /\b(NEVER|ALWAYS|DON'?T|DO NOT|MUST NOT)\b/i;
+    COMMAND_IN_BACKTICKS = /`([^`]+)`/g;
+  }
+});
+
+// src/core/checks/redundancy.ts
+import * as path7 from "node:path";
 function compilePatterns(allDeps) {
   const compiled = [];
   for (const [pkg, mentions] of Object.entries(PACKAGE_TECH_MAP)) {
@@ -41591,7 +41767,7 @@ async function checkRedundancy(file2, projectRoot) {
     );
     if (dirMatch) {
       const dir = dirMatch[1].replace(/[`"]/g, "");
-      const fullPath = path6.resolve(projectRoot, dir);
+      const fullPath = path7.resolve(projectRoot, dir);
       if (isDirectory(fullPath)) {
         issues.push({
           severity: "info",
@@ -42411,8 +42587,8 @@ var init_security = __esm({
 });
 
 // src/core/checks/mcp/commands.ts
-import * as fs5 from "node:fs";
-import * as path7 from "node:path";
+import * as fs6 from "node:fs";
+import * as path8 from "node:path";
 async function checkMcpCommands(config2, projectRoot) {
   const issues = [];
   if (config2.parseErrors.length > 0) return issues;
@@ -42429,7 +42605,7 @@ async function checkMcpCommands(config2, projectRoot) {
       });
     }
     if (LOCAL_PATH_PATTERN.test(server2.command)) {
-      const resolved = path7.resolve(projectRoot, server2.command);
+      const resolved = path8.resolve(projectRoot, server2.command);
       if (!fileExistsSafe(resolved)) {
         issues.push({
           severity: "warning",
@@ -42443,7 +42619,7 @@ async function checkMcpCommands(config2, projectRoot) {
     if (server2.args) {
       for (const arg of server2.args) {
         if (LOCAL_PATH_PATTERN.test(arg) || FILE_PATH_PATTERN.test(arg)) {
-          const resolved = path7.resolve(projectRoot, arg);
+          const resolved = path8.resolve(projectRoot, arg);
           if (!fileExistsSafe(resolved)) {
             issues.push({
               severity: "warning",
@@ -42461,7 +42637,7 @@ async function checkMcpCommands(config2, projectRoot) {
 }
 function fileExistsSafe(filePath) {
   try {
-    fs5.accessSync(filePath);
+    fs6.accessSync(filePath);
     return true;
   } catch {
     return false;
@@ -42951,7 +43127,7 @@ var init_session_parser = __esm({
 import { readdir, stat } from "node:fs/promises";
 import { createReadStream } from "node:fs";
 import { createInterface } from "node:readline";
-import { dirname as dirname2, join as join4, resolve as resolve4 } from "node:path";
+import { dirname as dirname2, join as join5, resolve as resolve4 } from "node:path";
 import { existsSync } from "node:fs";
 function detectProviders() {
   return AGENT_DIRS.filter((a) => existsSync(a.dir)).map((a) => a.provider);
@@ -42975,7 +43151,7 @@ async function parseJsonlFiltered(filePath, filter) {
   return results;
 }
 async function readClaudeHistory() {
-  const historyPath = join4(home, ".claude", "history.jsonl");
+  const historyPath = join5(home, ".claude", "history.jsonl");
   return parseJsonlFiltered(historyPath, (entry) => {
     if (!entry.display || !entry.project) return null;
     return {
@@ -42988,7 +43164,7 @@ async function readClaudeHistory() {
   });
 }
 async function readCodexHistory() {
-  const historyPath = join4(home, ".codex", "history.jsonl");
+  const historyPath = join5(home, ".codex", "history.jsonl");
   return parseJsonlFiltered(historyPath, (entry) => {
     if (!entry.display && !entry.command) return null;
     return {
@@ -43001,18 +43177,18 @@ async function readCodexHistory() {
   });
 }
 async function readClaudeMemories() {
-  const projectsDir = join4(home, ".claude", "projects");
+  const projectsDir = join5(home, ".claude", "projects");
   if (!existsSync(projectsDir)) return [];
   const memories = [];
   const projectDirs = await readdir(projectsDir).catch(() => []);
   for (const projDir of projectDirs) {
-    const memoryDir = join4(projectsDir, projDir, "memory");
+    const memoryDir = join5(projectsDir, projDir, "memory");
     if (!existsSync(memoryDir)) continue;
     const files = await readdir(memoryDir).catch(() => []);
     for (const file2 of files) {
       if (!file2.endsWith(".md") || file2 === "MEMORY.md") continue;
       try {
-        const entry = await parseMemoryFile(join4(memoryDir, file2), projDir);
+        const entry = await parseMemoryFile(join5(memoryDir, file2), projDir);
         memories.push(entry);
       } catch {
       }
@@ -43022,7 +43198,7 @@ async function readClaudeMemories() {
 }
 function detectAiderInSiblings(siblings) {
   for (const sib of siblings) {
-    if (existsSync(join4(sib.path, ".aider.chat.history.md"))) {
+    if (existsSync(join5(sib.path, ".aider.chat.history.md"))) {
       return "aider";
     }
   }
@@ -43039,7 +43215,7 @@ async function detectSiblings(projectRoot) {
   const candidates = [];
   for (const entry of entries) {
     if (entry.startsWith(".") || entry === "node_modules") continue;
-    const fullPath = join4(parentDir, entry);
+    const fullPath = join5(parentDir, entry);
     const entryPath = resolve4(fullPath);
     if (entryPath === resolve4(projectRoot)) continue;
     try {
@@ -43048,7 +43224,7 @@ async function detectSiblings(projectRoot) {
     } catch {
       continue;
     }
-    const isProject = existsSync(join4(fullPath, ".git")) || existsSync(join4(fullPath, "package.json")) || existsSync(join4(fullPath, "Cargo.toml")) || existsSync(join4(fullPath, "go.mod")) || existsSync(join4(fullPath, "pyproject.toml"));
+    const isProject = existsSync(join5(fullPath, ".git")) || existsSync(join5(fullPath, "package.json")) || existsSync(join5(fullPath, "Cargo.toml")) || existsSync(join5(fullPath, "go.mod")) || existsSync(join5(fullPath, "pyproject.toml"));
     if (!isProject) continue;
     candidates.push({ fullPath, entryPath, name: entry });
   }
@@ -43062,7 +43238,7 @@ async function detectSiblings(projectRoot) {
       if (orgMatch) currentOrg = orgMatch[1];
     } catch {
     }
-    const gitCandidates = candidates.filter((c2) => existsSync(join4(c2.fullPath, ".git")));
+    const gitCandidates = candidates.filter((c2) => existsSync(join5(c2.fullPath, ".git")));
     const results = await Promise.all(
       gitCandidates.map(async (c2) => {
         const sibling = { path: c2.entryPath.replace(/\\/g, "/"), name: c2.name };
@@ -43134,21 +43310,21 @@ var init_session_scanner = __esm({
     init_session_parser();
     home = process.env.HOME || process.env.USERPROFILE || "";
     AGENT_DIRS = [
-      { provider: "claude-code", dir: join4(home, ".claude"), historyFile: "history.jsonl" },
-      { provider: "codex-cli", dir: join4(home, ".codex"), historyFile: "history.jsonl" },
-      { provider: "vibe-cli", dir: join4(home, ".vibe") },
+      { provider: "claude-code", dir: join5(home, ".claude"), historyFile: "history.jsonl" },
+      { provider: "codex-cli", dir: join5(home, ".codex"), historyFile: "history.jsonl" },
+      { provider: "vibe-cli", dir: join5(home, ".vibe") },
       {
         provider: "amazon-q",
-        dir: join4(home, ".aws", "amazonq")
+        dir: join5(home, ".aws", "amazonq")
       },
       {
         provider: "goose",
-        dir: process.platform === "win32" ? join4(process.env.APPDATA || "", "Block", "goose") : join4(home, ".config", "goose")
+        dir: process.platform === "win32" ? join5(process.env.APPDATA || "", "Block", "goose") : join5(home, ".config", "goose")
       },
-      { provider: "continue", dir: join4(home, ".continue") },
+      { provider: "continue", dir: join5(home, ".continue") },
       {
         provider: "windsurf",
-        dir: join4(home, ".windsurf")
+        dir: join5(home, ".windsurf")
       }
     ];
   }
@@ -43210,7 +43386,7 @@ var init_missing_secret = __esm({
 
 // src/core/checks/session/diverged-file.ts
 import { readFile as readFile2 } from "node:fs/promises";
-import { join as join5 } from "node:path";
+import { join as join6 } from "node:path";
 import { existsSync as existsSync2 } from "node:fs";
 function calculateOverlap(a, b2) {
   const linesA = a.split("\n").map((l) => l.trim()).filter((l) => l.length > 3);
@@ -43228,7 +43404,7 @@ function calculateOverlap(a, b2) {
 async function checkDivergedFile(ctx) {
   const issues = [];
   for (const fileName of CANONICAL_FILES) {
-    const currentPath = join5(ctx.currentProject, fileName);
+    const currentPath = join6(ctx.currentProject, fileName);
     if (!existsSync2(currentPath)) continue;
     let currentContent;
     try {
@@ -43238,7 +43414,7 @@ async function checkDivergedFile(ctx) {
     }
     const diverged = [];
     for (const sib of ctx.siblings) {
-      const sibPath = join5(sib.path, fileName);
+      const sibPath = join6(sib.path, fileName);
       if (!existsSync2(sibPath)) continue;
       try {
         const sibContent = await readFile2(sibPath, "utf-8");
@@ -43284,12 +43460,12 @@ var init_diverged_file = __esm({
 
 // src/core/checks/session/missing-workflow.ts
 import { readdir as readdir2 } from "node:fs/promises";
-import { join as join6 } from "node:path";
+import { join as join7 } from "node:path";
 import { existsSync as existsSync3 } from "node:fs";
 async function checkMissingWorkflow(ctx) {
   const issues = [];
-  const currentWorkflowDir = join6(ctx.currentProject, ".github", "workflows");
-  if (!existsSync3(join6(ctx.currentProject, ".github"))) return issues;
+  const currentWorkflowDir = join7(ctx.currentProject, ".github", "workflows");
+  if (!existsSync3(join7(ctx.currentProject, ".github"))) return issues;
   const currentWorkflows = /* @__PURE__ */ new Set();
   if (existsSync3(currentWorkflowDir)) {
     try {
@@ -43302,7 +43478,7 @@ async function checkMissingWorkflow(ctx) {
   }
   const workflowMap = /* @__PURE__ */ new Map();
   for (const sib of ctx.siblings) {
-    const sibWorkflowDir = join6(sib.path, ".github", "workflows");
+    const sibWorkflowDir = join7(sib.path, ".github", "workflows");
     if (!existsSync3(sibWorkflowDir)) continue;
     try {
       const files = await readdir2(sibWorkflowDir);
@@ -43515,12 +43691,68 @@ var init_loop_detection = __esm({
   }
 });
 
+// src/core/checks/session/memory-index-overflow.ts
+import { readFile as readFile3, stat as stat2 } from "node:fs/promises";
+import { join as join8 } from "node:path";
+async function checkMemoryIndexOverflow(ctx) {
+  const home2 = process.env.HOME || process.env.USERPROFILE || "";
+  if (!home2) return [];
+  const encoded = encodeProjectDir(ctx.currentProject);
+  const memoryFile = join8(home2, ".claude", "projects", encoded, "memory", "MEMORY.md");
+  let stats;
+  try {
+    stats = await stat2(memoryFile);
+  } catch {
+    return [];
+  }
+  const content = await readFile3(memoryFile, "utf-8").catch(() => "");
+  if (!content) return [];
+  const lines = content.split("\n");
+  const lineCount = lines.length;
+  const byteSize = stats.size;
+  const issues = [];
+  if (lineCount > MAX_LINES) {
+    const excess = lineCount - MAX_LINES;
+    issues.push({
+      severity: "warning",
+      check: "session-memory-index-overflow",
+      ruleId: "session/memory-index-overflow",
+      line: MAX_LINES + 1,
+      message: `MEMORY.md has ${lineCount.toLocaleString()} lines \u2014 only the first ${MAX_LINES} are loaded. ${excess.toLocaleString()} line(s) are effectively invisible to the agent.`,
+      detail: `File: ${memoryFile}`,
+      suggestion: "Trim older entries, consolidate duplicates, or split into topic files (topic files stay on-demand and don't count toward this cap)."
+    });
+  }
+  if (byteSize > MAX_BYTES) {
+    const excess = byteSize - MAX_BYTES;
+    issues.push({
+      severity: "warning",
+      check: "session-memory-index-overflow",
+      ruleId: "session/memory-index-overflow",
+      line: 0,
+      message: `MEMORY.md is ${byteSize.toLocaleString()} bytes \u2014 only the first ${MAX_BYTES.toLocaleString()} bytes are loaded. ~${excess.toLocaleString()} bytes are effectively invisible.`,
+      detail: `File: ${memoryFile}`,
+      suggestion: "Each index entry should stay under ~150 characters. Trim verbose lines or move details into the corresponding topic file."
+    });
+  }
+  return issues;
+}
+var MAX_LINES, MAX_BYTES;
+var init_memory_index_overflow = __esm({
+  "src/core/checks/session/memory-index-overflow.ts"() {
+    "use strict";
+    init_session_parser();
+    MAX_LINES = 200;
+    MAX_BYTES = 25 * 1024;
+  }
+});
+
 // src/core/checks/ci-coverage.ts
-import { readdir as readdir3, readFile as readFile3 } from "node:fs/promises";
-import { join as join7 } from "node:path";
+import { readdir as readdir3, readFile as readFile4 } from "node:fs/promises";
+import { join as join9 } from "node:path";
 import { existsSync as existsSync5 } from "node:fs";
 async function findReleaseWorkflows(projectRoot) {
-  const workflowDir = join7(projectRoot, ".github", "workflows");
+  const workflowDir = join9(projectRoot, ".github", "workflows");
   if (!existsSync5(workflowDir)) return [];
   let files;
   try {
@@ -43536,7 +43768,7 @@ async function findReleaseWorkflows(projectRoot) {
       continue;
     }
     try {
-      const content = await readFile3(join7(workflowDir, f2), "utf-8");
+      const content = await readFile4(join9(workflowDir, f2), "utf-8");
       const nameMatch = content.match(/^name:\s*(.+)$/m);
       if (nameMatch && RELEASE_FILENAME_PATTERNS.some((p) => p.test(nameMatch[1]))) {
         releaseWorkflows.push(f2);
@@ -43590,11 +43822,11 @@ var init_ci_coverage = __esm({
 });
 
 // src/core/checks/ci-secrets.ts
-import { readdir as readdir4, readFile as readFile4 } from "node:fs/promises";
-import { join as join8 } from "node:path";
+import { readdir as readdir4, readFile as readFile5 } from "node:fs/promises";
+import { join as join10 } from "node:path";
 import { existsSync as existsSync6 } from "node:fs";
 async function findSecretUsages(projectRoot) {
-  const workflowDir = join8(projectRoot, ".github", "workflows");
+  const workflowDir = join10(projectRoot, ".github", "workflows");
   if (!existsSync6(workflowDir)) return [];
   let files;
   try {
@@ -43607,7 +43839,7 @@ async function findSecretUsages(projectRoot) {
     if (!(f2.endsWith(".yml") || f2.endsWith(".yaml"))) continue;
     let content;
     try {
-      content = await readFile4(join8(workflowDir, f2), "utf-8");
+      content = await readFile5(join10(workflowDir, f2), "utf-8");
     } catch {
       continue;
     }
@@ -43664,14 +43896,14 @@ var init_ci_secrets = __esm({
 });
 
 // src/version.ts
-import { readFileSync as readFileSync3 } from "node:fs";
+import { readFileSync as readFileSync4 } from "node:fs";
 import { resolve as resolve8, dirname as dirname3 } from "node:path";
 import { fileURLToPath } from "node:url";
 function loadVersion() {
-  if (true) return "0.9.1";
+  if (true) return "0.9.2";
   const __dir = dirname3(fileURLToPath(import.meta.url));
   const pkgPath = resolve8(__dir, "../package.json");
-  const pkg = JSON.parse(readFileSync3(pkgPath, "utf-8"));
+  const pkg = JSON.parse(readFileSync4(pkgPath, "utf-8"));
   return pkg.version;
 }
 var VERSION;
@@ -43706,6 +43938,8 @@ async function runAudit(projectRoot, activeChecks, options = {}) {
       if (activeChecks.includes("commands")) checkPromises.push(checkCommands(file2, projectRoot));
       if (activeChecks.includes("staleness")) checkPromises.push(checkStaleness(file2, projectRoot));
       if (activeChecks.includes("tokens")) checkPromises.push(checkTokens(file2, projectRoot));
+      if (activeChecks.includes("tier-tokens"))
+        checkPromises.push(checkTierTokens(file2, projectRoot));
       if (activeChecks.includes("redundancy"))
         checkPromises.push(checkRedundancy(file2, projectRoot));
       if (activeChecks.includes("frontmatter"))
@@ -43728,6 +43962,10 @@ async function runAudit(projectRoot, activeChecks, options = {}) {
       );
       if (aggIssue) crossFileIssues.push(aggIssue);
     }
+    if (activeChecks.includes("tier-tokens")) {
+      const tierAgg = checkAggregateTierTokens(parsed);
+      if (tierAgg) crossFileIssues.push(tierAgg);
+    }
     if (activeChecks.includes("redundancy")) {
       crossFileIssues.push(...checkDuplicateContent(parsed));
     }
@@ -43825,6 +44063,8 @@ async function runAudit(projectRoot, activeChecks, options = {}) {
         sessionPromises.push(checkDuplicateMemory(sessionCtx));
       if (sessionChecksToRun.includes("session-loop-detection"))
         sessionPromises.push(checkLoopDetection(sessionCtx));
+      if (sessionChecksToRun.includes("session-memory-index-overflow"))
+        sessionPromises.push(checkMemoryIndexOverflow(sessionCtx));
       const sessionResults = await Promise.all(sessionPromises);
       const sessionIssues = sessionResults.flat();
       if (sessionIssues.length > 0) {
@@ -43882,6 +44122,7 @@ var init_audit = __esm({
     init_commands();
     init_staleness();
     init_tokens2();
+    await init_tier_tokens();
     await init_redundancy();
     init_contradictions();
     init_frontmatter();
@@ -43900,6 +44141,7 @@ var init_audit = __esm({
     init_stale_memory();
     init_duplicate_memory();
     init_loop_detection();
+    init_memory_index_overflow();
     init_ci_coverage();
     init_ci_secrets();
     init_version2();
@@ -43908,6 +44150,7 @@ var init_audit = __esm({
       "commands",
       "staleness",
       "tokens",
+      "tier-tokens",
       "redundancy",
       "contradictions",
       "frontmatter",
@@ -43930,7 +44173,8 @@ var init_audit = __esm({
       "session-missing-workflow",
       "session-stale-memory",
       "session-duplicate-memory",
-      "session-loop-detection"
+      "session-loop-detection",
+      "session-memory-index-overflow"
     ];
   }
 });
@@ -44474,7 +44718,7 @@ var init_source = __esm({
 });
 
 // src/core/fixer.ts
-import * as fs6 from "node:fs";
+import * as fs7 from "node:fs";
 function applyFixes(result, options = {}) {
   const log = options.quiet ? () => {
   } : console.log.bind(console);
@@ -44491,7 +44735,7 @@ function applyFixes(result, options = {}) {
   let totalFixes = 0;
   const filesModified = [];
   for (const [filePath, fixes] of fixesByFile) {
-    const content = fs6.readFileSync(filePath, "utf-8");
+    const content = fs7.readFileSync(filePath, "utf-8");
     const lines = content.split("\n");
     let modified = false;
     const sortedFixes = [...fixes].sort((a, b2) => b2.line - a.line);
@@ -44529,7 +44773,7 @@ function applyFixes(result, options = {}) {
           continue;
         }
       }
-      fs6.writeFileSync(filePath, newContent, "utf-8");
+      fs7.writeFileSync(filePath, newContent, "utf-8");
       filesModified.push(filePath);
     }
   }
@@ -44544,7 +44788,7 @@ var init_fixer = __esm({
 
 // src/mcp/server.ts
 var server_exports = {};
-import * as path8 from "node:path";
+import * as path9 from "node:path";
 var allCheckNames, checkEnum, server, transport;
 var init_server3 = __esm({
   async "src/mcp/server.ts"() {
@@ -44582,7 +44826,7 @@ var init_server3 = __esm({
         openWorldHint: false
       },
       async ({ projectPath, checks }) => {
-        const root = path8.resolve(projectPath || process.cwd());
+        const root = path9.resolve(projectPath || process.cwd());
         const activeChecks = checks?.length ? checks : ALL_CHECKS;
         try {
           const result = await runAudit(root, activeChecks);
@@ -44616,8 +44860,8 @@ var init_server3 = __esm({
       },
       async ({ path: filePath, projectPath }) => {
         try {
-          const root = path8.resolve(projectPath || process.cwd());
-          const resolved = path8.resolve(root, filePath);
+          const root = path9.resolve(projectPath || process.cwd());
+          const resolved = path9.resolve(root, filePath);
           const result = {
             path: filePath,
             exists: fileExists(resolved) || isDirectory(resolved)
@@ -44658,7 +44902,7 @@ var init_server3 = __esm({
         openWorldHint: false
       },
       async ({ projectPath }) => {
-        const root = path8.resolve(projectPath || process.cwd());
+        const root = path9.resolve(projectPath || process.cwd());
         try {
           const discovered = await scanForContextFiles(root);
           const parsed = discovered.map((f2) => parseContextFile(f2));
@@ -44706,7 +44950,7 @@ var init_server3 = __esm({
         openWorldHint: false
       },
       async ({ projectPath, checks }) => {
-        const root = path8.resolve(projectPath || process.cwd());
+        const root = path9.resolve(projectPath || process.cwd());
         const activeChecks = checks?.length ? checks : ALL_CHECKS;
         try {
           const result = await runAudit(root, activeChecks);
@@ -44756,7 +45000,7 @@ var init_server3 = __esm({
         openWorldHint: false
       },
       async ({ projectPath, checks, includeGlobal }) => {
-        const root = path8.resolve(projectPath || process.cwd());
+        const root = path9.resolve(projectPath || process.cwd());
         const activeChecks = checks?.length ? checks : ALL_MCP_CHECKS;
         try {
           const result = await runAudit(root, activeChecks, {
@@ -44793,7 +45037,7 @@ var init_server3 = __esm({
         openWorldHint: true
       },
       async ({ projectPath, checks }) => {
-        const root = path8.resolve(projectPath || process.cwd());
+        const root = path9.resolve(projectPath || process.cwd());
         const activeChecks = checks?.length ? checks : ALL_SESSION_CHECKS;
         try {
           const result = await runAudit(root, activeChecks, {
@@ -45984,8 +46228,8 @@ var require_command = __commonJS({
   "node_modules/.pnpm/commander@14.0.3/node_modules/commander/lib/command.js"(exports) {
     var EventEmitter2 = __require("node:events").EventEmitter;
     var childProcess = __require("node:child_process");
-    var path11 = __require("node:path");
-    var fs9 = __require("node:fs");
+    var path12 = __require("node:path");
+    var fs10 = __require("node:fs");
     var process11 = __require("node:process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -46979,7 +47223,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} subcommandName
        */
       _checkForMissingExecutable(executableFile, executableDir, subcommandName) {
-        if (fs9.existsSync(executableFile)) return;
+        if (fs10.existsSync(executableFile)) return;
         const executableDirMessage = executableDir ? `searched for local subcommand relative to directory '${executableDir}'` : "no directory for search for local subcommand, use .executableDir() to supply a custom directory";
         const executableMissing = `'${executableFile}' does not exist
  - if '${subcommandName}' is not meant to be an executable command, remove description parameter from '.command()' and use '.description()' instead
@@ -46997,11 +47241,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path11.resolve(baseDir, baseName);
-          if (fs9.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path11.extname(baseName))) return void 0;
+          const localBin = path12.resolve(baseDir, baseName);
+          if (fs10.existsSync(localBin)) return localBin;
+          if (sourceExt.includes(path12.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
-            (ext) => fs9.existsSync(`${localBin}${ext}`)
+            (ext) => fs10.existsSync(`${localBin}${ext}`)
           );
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
@@ -47013,21 +47257,21 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs9.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs10.realpathSync(this._scriptPath);
           } catch {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path11.resolve(
-            path11.dirname(resolvedScriptPath),
+          executableDir = path12.resolve(
+            path12.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path11.basename(
+            const legacyName = path12.basename(
               this._scriptPath,
-              path11.extname(this._scriptPath)
+              path12.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -47038,7 +47282,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path11.extname(executableFile));
+        launchWithNode = sourceExt.includes(path12.extname(executableFile));
         let proc;
         if (process11.platform !== "win32") {
           if (launchWithNode) {
@@ -47953,7 +48197,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path11.basename(filename, path11.extname(filename));
+        this._name = path12.basename(filename, path12.extname(filename));
         return this;
       }
       /**
@@ -47967,9 +48211,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path12) {
-        if (path12 === void 0) return this._executableDir;
-        this._executableDir = path12;
+      executableDir(path13) {
+        if (path13 === void 0) return this._executableDir;
+        this._executableDir = path13;
         return this;
       }
       /**
@@ -51606,14 +51850,14 @@ var init_reporter = __esm({
 });
 
 // src/core/config.ts
-import * as fs7 from "node:fs";
-import * as path9 from "node:path";
+import * as fs8 from "node:fs";
+import * as path10 from "node:path";
 function loadConfig(projectRoot) {
   for (const filename of CONFIG_FILENAMES) {
-    const filePath = path9.join(projectRoot, filename);
+    const filePath = path10.join(projectRoot, filename);
     let content;
     try {
-      content = fs7.readFileSync(filePath, "utf-8");
+      content = fs8.readFileSync(filePath, "utf-8");
     } catch {
       continue;
     }
@@ -51639,8 +51883,8 @@ var cli_exports = {};
 __export(cli_exports, {
   runCli: () => runCli
 });
-import * as fs8 from "node:fs";
-import * as path10 from "node:path";
+import * as fs9 from "node:fs";
+import * as path11 from "node:path";
 function validateCheckNames(names, source) {
   const invalid = names.filter((n7) => n7 && !VALID_CHECKS.has(n7));
   if (invalid.length > 0) {
@@ -51659,8 +51903,8 @@ async function runCli() {
   ).version(VERSION).argument("[path]", "Project directory to scan", ".").option("--strict", "Exit code 1 on any warning or error (for CI)", false).option("--checks <checks>", "Comma-separated list of checks to run", "").addOption(
     new Option("--format <format>", "Output format: text, json, or sarif").choices(["text", "json", "sarif"]).default("text")
   ).option("--tokens", "Show token breakdown per file", false).option("--verbose", "Show passing checks too", false).option("--fix", "Auto-fix broken paths using git history and fuzzy matching", false).option("--ignore <checks>", "Comma-separated list of checks to ignore", "").option("--quiet", "Suppress all output except errors (exit code only)", false).option("--config <path>", "Path to config file (default: .ctxlintrc in project root)").option("--depth <n>", "Max subdirectory depth to scan (default: 2)", "2").option("--mcp", "Enable MCP config linting alongside context file checks", false).option("--mcp-only", "Run only MCP config checks, skip context file checks", false).option("--mcp-global", "Also scan user/global MCP config files (implies --mcp)", false).option("--mcp-server", "Start the MCP server (for IDE/agent integration)").option("--session", "Run session audit checks (cross-project consistency)", false).option("--session-only", "Run only session checks, skip context and MCP checks", false).option("--watch", "Re-lint on context file changes", false).action(async (projectPath, opts) => {
-    const resolvedPath = path10.resolve(projectPath);
-    const configPath = opts.config ? path10.resolve(opts.config) : void 0;
+    const resolvedPath = path11.resolve(projectPath);
+    const configPath = opts.config ? path11.resolve(opts.config) : void 0;
     const config2 = configPath ? loadConfigFromPath(configPath) : loadConfig(resolvedPath);
     const mcpGlobal = opts.mcpGlobal || false;
     const mcpOnly = opts.mcpOnly || false;
@@ -51779,34 +52023,34 @@ Fixed ${fixSummary.totalFixes} issue${fixSummary.totalFixes !== 1 ? "s" : ""} in
       const chalk2 = (await Promise.resolve().then(() => (init_source(), source_exports))).default;
       console.log(chalk2.dim("\nWatching for changes... (Ctrl+C to stop)\n"));
       const watchPaths = [
-        path10.join(resolvedPath, "CLAUDE.md"),
-        path10.join(resolvedPath, "CLAUDE.local.md"),
-        path10.join(resolvedPath, "AGENTS.md"),
-        path10.join(resolvedPath, "AGENT.md"),
-        path10.join(resolvedPath, ".cursorrules"),
-        path10.join(resolvedPath, ".windsurfrules"),
-        path10.join(resolvedPath, ".clinerules"),
-        path10.join(resolvedPath, ".aiderules"),
-        path10.join(resolvedPath, ".continuerules"),
-        path10.join(resolvedPath, ".rules"),
-        path10.join(resolvedPath, ".goosehints"),
-        path10.join(resolvedPath, "GEMINI.md"),
-        path10.join(resolvedPath, "replit.md"),
-        path10.join(resolvedPath, "package.json"),
-        path10.join(resolvedPath, ".mcp.json")
+        path11.join(resolvedPath, "CLAUDE.md"),
+        path11.join(resolvedPath, "CLAUDE.local.md"),
+        path11.join(resolvedPath, "AGENTS.md"),
+        path11.join(resolvedPath, "AGENT.md"),
+        path11.join(resolvedPath, ".cursorrules"),
+        path11.join(resolvedPath, ".windsurfrules"),
+        path11.join(resolvedPath, ".clinerules"),
+        path11.join(resolvedPath, ".aiderules"),
+        path11.join(resolvedPath, ".continuerules"),
+        path11.join(resolvedPath, ".rules"),
+        path11.join(resolvedPath, ".goosehints"),
+        path11.join(resolvedPath, "GEMINI.md"),
+        path11.join(resolvedPath, "replit.md"),
+        path11.join(resolvedPath, "package.json"),
+        path11.join(resolvedPath, ".mcp.json")
       ];
       const watchDirs = [
-        path10.join(resolvedPath, ".claude"),
-        path10.join(resolvedPath, ".cursor"),
-        path10.join(resolvedPath, ".github"),
-        path10.join(resolvedPath, ".windsurf"),
-        path10.join(resolvedPath, ".aide"),
-        path10.join(resolvedPath, ".amazonq"),
-        path10.join(resolvedPath, ".goose"),
-        path10.join(resolvedPath, ".junie"),
-        path10.join(resolvedPath, ".aiassistant"),
-        path10.join(resolvedPath, ".continue"),
-        path10.join(resolvedPath, ".vscode")
+        path11.join(resolvedPath, ".claude"),
+        path11.join(resolvedPath, ".cursor"),
+        path11.join(resolvedPath, ".github"),
+        path11.join(resolvedPath, ".windsurf"),
+        path11.join(resolvedPath, ".aide"),
+        path11.join(resolvedPath, ".amazonq"),
+        path11.join(resolvedPath, ".goose"),
+        path11.join(resolvedPath, ".junie"),
+        path11.join(resolvedPath, ".aiassistant"),
+        path11.join(resolvedPath, ".continue"),
+        path11.join(resolvedPath, ".vscode")
       ];
       let debounceTimer = null;
       const rerun = () => {
@@ -51849,13 +52093,13 @@ Fixed ${fixSummary.totalFixes} issue${fixSummary.totalFixes !== 1 ? "s" : ""} in
       };
       for (const filePath of watchPaths) {
         try {
-          fs8.watch(filePath, rerun);
+          fs9.watch(filePath, rerun);
         } catch {
         }
       }
       for (const dir of watchDirs) {
         try {
-          fs8.watch(dir, { recursive: true }, rerun);
+          fs9.watch(dir, { recursive: true }, rerun);
         } catch {
         }
       }
@@ -51864,17 +52108,17 @@ Fixed ${fixSummary.totalFixes} issue${fixSummary.totalFixes !== 1 ? "s" : ""} in
     }
   });
   program2.command("init").description("Set up a git pre-commit hook that runs ctxlint --strict").argument("[path]", "Project directory", ".").action(async (projectPath) => {
-    const resolvedRoot = path10.resolve(projectPath);
-    const gitDir = path10.join(resolvedRoot, ".git");
-    const hooksDir = path10.join(gitDir, "hooks");
-    if (!fs8.existsSync(gitDir)) {
+    const resolvedRoot = path11.resolve(projectPath);
+    const gitDir = path11.join(resolvedRoot, ".git");
+    const hooksDir = path11.join(gitDir, "hooks");
+    if (!fs9.existsSync(gitDir)) {
       console.error('Error: not a git repository. Run "git init" first.');
       process.exit(1);
     }
-    if (!fs8.existsSync(hooksDir)) {
-      fs8.mkdirSync(hooksDir, { recursive: true });
+    if (!fs9.existsSync(hooksDir)) {
+      fs9.mkdirSync(hooksDir, { recursive: true });
     }
-    const hookPath = path10.join(hooksDir, "pre-commit");
+    const hookPath = path11.join(hooksDir, "pre-commit");
     const fullHookContent = `#!/bin/sh
 # ctxlint pre-commit hook
 npx @yawlabs/ctxlint --strict
@@ -51883,16 +52127,16 @@ npx @yawlabs/ctxlint --strict
 # ctxlint pre-commit hook
 npx @yawlabs/ctxlint --strict
 `;
-    if (fs8.existsSync(hookPath)) {
-      const existing = fs8.readFileSync(hookPath, "utf-8");
+    if (fs9.existsSync(hookPath)) {
+      const existing = fs9.readFileSync(hookPath, "utf-8");
       if (existing.includes("ctxlint")) {
         console.log("Pre-commit hook already includes ctxlint.");
         return;
       }
-      fs8.appendFileSync(hookPath, appendHookContent);
+      fs9.appendFileSync(hookPath, appendHookContent);
       console.log("Added ctxlint to existing pre-commit hook.");
     } else {
-      fs8.writeFileSync(hookPath, fullHookContent, { mode: 493 });
+      fs9.writeFileSync(hookPath, fullHookContent, { mode: 493 });
       console.log("Created pre-commit hook at .git/hooks/pre-commit");
     }
     console.log("ctxlint will now run automatically before each commit.");
@@ -51901,7 +52145,7 @@ npx @yawlabs/ctxlint --strict
 }
 function loadConfigFromPath(configPath) {
   try {
-    const content = fs8.readFileSync(configPath, "utf-8");
+    const content = fs9.readFileSync(configPath, "utf-8");
     return JSON.parse(content);
   } catch (err) {
     const detail = err instanceof Error ? err.message : String(err);