@yawlabs/ctxlint 0.18.0 → 0.18.1

package/.pre-commit-hooks.yaml

@@ -4,7 +4,7 @@
   # Version-pinned so a checkout at `rev: vX.Y.Z` runs exactly that release
   # of ctxlint — matches the pinning done by `ctxlint init`. release.sh keeps
   # this in sync with package.json on each bump.
-  entry: npx @yawlabs/ctxlint@0.18.0 --strict
+  entry: npx @yawlabs/ctxlint@0.18.1 --strict
   language: node
   always_run: true
   pass_filenames: false

package/dist/index.js

@@ -13769,6 +13769,7 @@ function extractPathReferences(lines, sections) {
         cleanValue = cleanValue.slice(0, -1);
       }
       if (!cleanValue.includes("/")) continue;
+      if (/(^|\/)\.git\//.test(cleanValue) || /\.app\//.test(cleanValue)) continue;
       const column = match.index + match[0].length - match[1].length + 1;
       paths.push({
         value: cleanValue,
@@ -20432,12 +20433,34 @@ async function checkPaths(file2, projectRoot) {
   const contextDir = path4.dirname(file2.filePath);
   const pending = [];
   for (const ref of file2.references.paths) {
-    const normalizedRef = ref.value.replace(/\\/g, "/");
-    const baseDir = /^\.\.?\//.test(normalizedRef) ? contextDir : projectRoot;
-    const resolvedPath = path4.resolve(baseDir, normalizedRef);
+    const rawNormalized = ref.value.replace(/\\/g, "/");
+    const isImport = rawNormalized.startsWith("@");
+    const normalizedRef = isImport ? rawNormalized.slice(1) : rawNormalized;
+    if (isImport && normalizedRef.startsWith("~/")) continue;
+    if (isImport && /^[\w.-]+\/[\w.-]+$/.test(normalizedRef) && !/\.\w+$/.test(normalizedRef)) {
+      continue;
+    }
+    const explicitRel = /^\.\.?\//.test(normalizedRef);
+    const baseDirs = explicitRel || isImport ? [contextDir] : [projectRoot, contextDir];
+    const primaryBase = baseDirs[0];
     if (normalizedRef.includes("*")) {
-      const iter = path4.isAbsolute(normalizedRef) ? es(normalizedRef, { absolute: true, nodir: false, ignore: GLOB_IGNORE }) : es(normalizedRef, { cwd: baseDir, nodir: false, ignore: GLOB_IGNORE });
-      const hasMatch = !(await iter.next()).done;
+      let hasMatch = false;
+      if (path4.isAbsolute(normalizedRef)) {
+        const iter = es(normalizedRef, {
+          absolute: true,
+          nodir: false,
+          ignore: GLOB_IGNORE
+        });
+        hasMatch = !(await iter.next()).done;
+      } else {
+        for (const b2 of baseDirs) {
+          const iter = es(normalizedRef, { cwd: b2, nodir: false, ignore: GLOB_IGNORE });
+          if (!(await iter.next()).done) {
+            hasMatch = true;
+            break;
+          }
+        }
+      }
       if (!hasMatch) {
         issues.push({
           severity: "error",
@@ -20452,8 +20475,7 @@ async function checkPaths(file2, projectRoot) {
     }
     const isDir = normalizedRef.endsWith("/");
     if (isDir) {
-      const dirPath = path4.resolve(baseDir, normalizedRef);
-      if (!isDirectory(dirPath)) {
+      if (!baseDirs.some((b2) => isDirectory(path4.resolve(b2, normalizedRef)))) {
         issues.push({
           severity: "error",
           check: "paths",
@@ -20464,18 +20486,25 @@ async function checkPaths(file2, projectRoot) {
       }
       continue;
     }
-    if (fileExists(resolvedPath) || isDirectory(resolvedPath)) {
+    const resolvedCandidates = baseDirs.map((b2) => path4.resolve(b2, normalizedRef));
+    if (resolvedCandidates.some((p2) => fileExists(p2) || isDirectory(p2))) {
       continue;
     }
+    const insideRoot = resolvedCandidates.some((p2) => {
+      const rel = path4.relative(projectRoot, p2);
+      return rel === "" || !rel.startsWith("..") && !path4.isAbsolute(rel);
+    });
+    if (!insideRoot) continue;
+    const resolvedPath = path4.resolve(primaryBase, normalizedRef);
     const relTarget = path4.relative(projectRoot, resolvedPath).replace(/\\/g, "/");
-    pending.push({ ref, normalizedRef, baseDir, relTarget });
+    pending.push({ ref, normalizedRef, baseDir: primaryBase, relTarget, isImport });
   }
   if (pending.length > 0) {
     const batchResult = await findRenamesBatch(
       projectRoot,
       pending.map((p2) => p2.relTarget)
     );
-    for (const { ref, normalizedRef, baseDir, relTarget } of pending) {
+    for (const { ref, normalizedRef, baseDir, relTarget, isImport } of pending) {
       const rename = batchResult.get(relTarget) ?? null;
       let suggestion;
       let detail;
@@ -20498,6 +20527,9 @@ async function checkPaths(file2, projectRoot) {
           fixText = `./${fixText}`;
         }
       }
+      if (fixText && isImport) {
+        fixText = `@${fixText}`;
+      }
       issues.push({
         severity: "error",
         check: "paths",
@@ -27683,7 +27715,7 @@ import { readFileSync as readFileSync7 } from "node:fs";
 import { resolve as resolve14, dirname as dirname6 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 function loadVersion() {
-  if (true) return "0.18.0";
+  if (true) return "0.18.1";
   try {
     const __dir = dirname6(fileURLToPath2(import.meta.url));
     const pkgPath = resolve14(__dir, "../package.json");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yawlabs/ctxlint",
-  "version": "0.18.0",
+  "version": "0.18.1",
   "mcpName": "io.github.YawLabs/ctxlint",
   "description": "Lint your AI agent context files, MCP server configs, and session data against your actual codebase",
   "bin": {