instrlint 0.1.10 → 0.2.3

package/README.md

@@ -178,6 +178,10 @@ The `--verify` flag triggers a two-pass protocol where the host agent (Claude Co
 
 instrlint never calls an LLM API. It delegates judgment to whatever model is already running the session.
 
+### Refactoring walkthrough (`/instrlint` interactive)
+
+After the report, the skill can walk you through CLAUDE.md splitting decisions interactively. Each section is classified into one of four buckets: worth extracting (load rate < 30%), extractable but always-loaded (> 80%, no token saving), should delete not move (duplicates source code), or must stay (cross-conversation context). Run `/instrlint` and follow the prompts.
+
 ## Score and grade
 
 | Grade | Score | Meaning |

package/README.zh-TW.md

@@ -184,6 +184,10 @@ npx instrlint install --codex
 
 instrlint 從不呼叫任何 LLM API，而是將判斷委託給當前 session 中正在運行的 model。
 
+### CLAUDE.md 拆分引導（`/instrlint` 互動模式）
+
+報告結束後，skill 可以互動引導你決定 CLAUDE.md 的拆分方式。每個段落會被分入四個桶：值得抽出（載入率 < 30%）、可抽出但不省 token（> 80%，一律載入）、該刪不是該搬（與原始碼或 config 重複）、或必須留在 CLAUDE.md（跨 conversation 的上下文）。執行 `/instrlint` 後依提示操作即可。
+
 ## 分數與等級
 
 | 等級 | 分數 | 說明 |

package/dist/cli.cjs

@@ -199,7 +199,8 @@ var KEYWORD_REGEX = new RegExp(
   "gi"
 );
 var PATH_REGEX = /(?<!\w)(?:\.{1,2}\/|(?:src|tests?|dist|lib|docs?|config|scripts?|packages?)\/)[^\s,;`'")\]>]+/g;
-var RULE_IMPERATIVE_WORDS = /\b(must|should|never|always|prefer|avoid|ensure|require|forbid|use|do not|don't)\b/i;
+var AT_REF_REGEX = /(?<![a-zA-Z0-9_])@((?:\.\.?\/)?[\w./-]+\.(?:md|txt|json|yaml|yml))\b/g;
+var RULE_IMPERATIVE_WORDS = /\b(must|should|never|always|prefer|avoid|ensure|require|forbid|use|do not|don't)\b|必須|應該|應當|永遠|總是|禁止|不要|不可|不得|避免|請使用|優先使用|請勿/i;
 var RULE_NEGATION_PATTERN = /\b(not|don't|do not)\s+\w+/i;
 var STRONG_IMPERATIVE = /\b(must|shall|always|never)\b/i;
 function parseYamlFrontmatter(content) {
@@ -255,6 +256,8 @@ function isRule(text) {
     if (STRONG_IMPERATIVE.test(body) && /^[A-Z]/.test(body)) return true;
     if (RULE_IMPERATIVE_WORDS.test(body) && /^[A-Z][a-z]/.test(body))
       return true;
+    if (RULE_IMPERATIVE_WORDS.test(body) && /^[\u4e00-\u9fff\u3400-\u4dbf]/.test(body))
+      return true;
   }
   return false;
 }
@@ -267,12 +270,15 @@ function extractKeywords(text) {
   return [...found];
 }
 function extractPaths(text) {
-  const matches = text.matchAll(PATH_REGEX);
   const found = [];
-  for (const m of matches) {
+  for (const m of text.matchAll(PATH_REGEX)) {
     const cleaned = m[0].replace(/[.,;)>\]'"]+$/, "");
     if (cleaned.length > 1) found.push(cleaned);
   }
+  for (const m of text.matchAll(AT_REF_REGEX)) {
+    const cleaned = (m[1] ?? "").replace(/[.,;)>\]'"]+$/, "");
+    if (cleaned.length > 0) found.push(cleaned);
+  }
   return [...new Set(found)];
 }
 function parseInstructionFile(filePath) {
@@ -953,6 +959,31 @@ function getPrettierField(projectRoot, field) {
   }
   return void 0;
 }
+function readCsprojContent(projectRoot) {
+  const buildProps = readTextFile(projectRoot, "Directory.Build.props");
+  if (buildProps) return buildProps;
+  try {
+    const files = (0, import_fs6.readdirSync)(projectRoot);
+    for (const f of files) {
+      if (f.endsWith(".csproj") || f.endsWith(".fsproj")) {
+        const content = readTextFile(projectRoot, f);
+        if (content) return content;
+      }
+    }
+  } catch {
+  }
+  return null;
+}
+function checkCsprojProperty(projectRoot, tag, value) {
+  const content = readCsprojContent(projectRoot);
+  if (!content) return false;
+  return new RegExp(`<${tag}>\\s*${value}\\s*</${tag}>`, "i").test(content);
+}
+function checkEditorConfigPattern(projectRoot, pattern) {
+  const content = readTextFile(projectRoot, ".editorconfig");
+  if (!content) return false;
+  return pattern.test(content);
+}
 function checkEslintRule(projectRoot, ruleName) {
   const parsed = readJsonFile(projectRoot, ".eslintrc.json");
   if (!parsed || typeof parsed !== "object") return false;
@@ -1118,6 +1149,52 @@ var PATTERNS = [
     rulePattern: /\b(no|avoid|prefer\s*named)\s*(default\s*export)/i,
     configCheck: (root) => checkEslintRule(root, "import/no-default-export") || checkEslintRule(root, "no-restricted-exports"),
     configName: "eslint-plugin-import (no-default-export)"
+  },
+  // ─── C# patterns ─────────────────────────────────────────────────────────
+  {
+    id: "csharp-nullable",
+    rulePattern: /\b(nullable\s*reference\s*type|#nullable\s*enable|enable\s*nullable|null\s*reference\s*exception)\b/i,
+    configCheck: (root) => checkCsprojProperty(root, "Nullable", "enable") || checkCsprojProperty(root, "Nullable", "annotations") || checkCsprojProperty(root, "Nullable", "warnings"),
+    configName: ".csproj (<Nullable>enable</Nullable>)"
+  },
+  {
+    id: "csharp-implicit-usings",
+    rulePattern: /\b(global\s*usings?|implicit\s*usings?)\b/i,
+    configCheck: (root) => checkCsprojProperty(root, "ImplicitUsings", "enable"),
+    configName: ".csproj (<ImplicitUsings>enable</ImplicitUsings>)"
+  },
+  {
+    id: "csharp-test-framework",
+    rulePattern: /\b(xunit|nunit|mstest|microsoft\.testing\.framework)\b/i,
+    configCheck: (root) => {
+      const content = readCsprojContent(root);
+      if (!content) return false;
+      return /PackageReference\s+Include="(xunit|NUnit|MSTest|Microsoft\.Testing)/i.test(
+        content
+      );
+    },
+    configName: ".csproj (PackageReference xUnit / NUnit / MSTest)"
+  },
+  {
+    id: "csharp-formatter",
+    rulePattern: /\bdotnet\s*format\b/i,
+    configCheck: (root) => checkEditorConfigPattern(root, /^\[.*\.cs\]/m) && checkEditorConfigPattern(root, /^csharp_/m),
+    configName: ".editorconfig ([*.cs] csharp_style_* settings)"
+  },
+  {
+    id: "csharp-naming",
+    rulePattern: /\bdotnet_naming\b|PascalCase\s+for\s+(all\s+)?(public|class|method|property|type)\b/i,
+    configCheck: (root) => checkEditorConfigPattern(root, /^dotnet_naming_rule\./m),
+    configName: ".editorconfig (dotnet_naming_rule.*)"
+  },
+  {
+    id: "csharp-unused",
+    rulePattern: /\b(IDE0059|CS0168|CS0219|dead\s*code|unused.*IDE|roslyn.*unused)\b/i,
+    configCheck: (root) => checkEditorConfigPattern(
+      root,
+      /^dotnet_diagnostic\.(IDE0059|CS0168|CS0219)/m
+    ),
+    configName: ".editorconfig (dotnet_diagnostic.IDE0059 / CS0168)"
   }
 ];
 function collectRuleLines(instructions) {
@@ -1168,6 +1245,7 @@ function detectConfigOverlaps(instructions, projectRoot) {
 
 // src/utils/text.ts
 var STOP_WORDS = /* @__PURE__ */ new Set([
+  // English grammatical function words
   "the",
   "a",
   "an",
@@ -1181,10 +1259,30 @@ var STOP_WORDS = /* @__PURE__ */ new Set([
   "of",
   "with",
   "that",
-  "this"
+  "this",
+  // Chinese filler bigrams (grammatical / no topic content)
+  "\u7684\u6642",
+  "\u6642\u5019",
+  "\u4E00\u500B",
+  "\u6240\u6709",
+  "\u6BCF\u500B"
 ]);
+var CJK_RUN = /[\u4e00-\u9fff\u3400-\u4dbf]+/g;
+var ASCII_WORD = /[a-z0-9]+/g;
 function tokenizeWords(text) {
-  return text.toLowerCase().split(/[^a-z0-9]+/).filter((w) => w.length > 1);
+  const words = [];
+  const lower = text.toLowerCase();
+  for (const m of lower.matchAll(ASCII_WORD)) {
+    if (m[0].length > 1) words.push(m[0]);
+  }
+  for (const m of text.matchAll(CJK_RUN)) {
+    const run = m[0];
+    if (run.length < 2) continue;
+    for (let i = 0; i < run.length - 1; i++) {
+      words.push(run.slice(i, i + 2));
+    }
+  }
+  return words;
 }
 function removeStopWords(words) {
   return words.filter((w) => !STOP_WORDS.has(w));
@@ -1265,8 +1363,10 @@ function analyzeDeadRules(instructions, projectRoot) {
 
 // src/detectors/contradiction.ts
 var NEGATION_WORDS = ["never", "don't", "avoid", "forbid"];
+var CJK_NEGATIONS = ["\u7981\u6B62", "\u4E0D\u8981", "\u4E0D\u53EF", "\u4E0D\u5F97", "\u907F\u514D", "\u8ACB\u52FF", "\u52FF"];
+var CJK_ONLY_RE = /^[\u4e00-\u9fff\u3400-\u4dbf]+$/;
 function isNegated(text, word) {
-  const sentences = text.split(/[.!?]+\s+/);
+  const sentences = text.split(/[.!?。！？]+\s*/);
   const escapedWord = word.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   const wordPresent = new RegExp(`\\b${escapedWord}\\b`, "i");
   for (const sentence of sentences) {
@@ -1285,6 +1385,14 @@ function isNegated(text, word) {
     );
     if (notPattern.test(lower)) return true;
   }
+  if (CJK_ONLY_RE.test(word)) {
+    for (const sentence of sentences) {
+      if (!sentence.includes(word)) continue;
+      for (const neg of CJK_NEGATIONS) {
+        if (sentence.includes(neg)) return true;
+      }
+    }
+  }
   return false;
 }
 var POLARITY_STOP_WORDS = /* @__PURE__ */ new Set([
@@ -1321,7 +1429,26 @@ var POLARITY_STOP_WORDS = /* @__PURE__ */ new Set([
   "be",
   "by",
   "own",
-  "on"
+  "on",
+  // Chinese polarity / imperative bigrams (analogues of English never/always/use/must)
+  "\u6C38\u9060",
+  "\u7E3D\u662F",
+  "\u7981\u6B62",
+  "\u4E0D\u8981",
+  "\u4E0D\u53EF",
+  "\u4E0D\u5F97",
+  "\u907F\u514D",
+  "\u8ACB\u52FF",
+  "\u5FC5\u9808",
+  "\u61C9\u8A72",
+  "\u61C9\u7576",
+  // Chinese generic verb bigrams (HOW to comply, not WHAT topic)
+  "\u4F7F\u7528",
+  "\u63A1\u7528",
+  "\u57F7\u884C",
+  "\u9032\u884C",
+  "\u53EF\u4EE5",
+  "\u9700\u8981"
 ]);
 function collectRuleLines3(instructions) {
   const sources = [
@@ -1426,7 +1553,7 @@ function detectStaleRefs(instructions, projectRoot) {
 
 // src/detectors/scope-classifier.ts
 var PATH_REF_PATTERN = /\b(?:src|tests?|lib|dist)\//i;
-var HOOK_PATTERN = /\b(?:never|don't|do\s+not|forbid)\b.*\b(?:commit|push|merge|build|run)\b/i;
+var HOOK_PATTERN = /\b(?:never|don't|do\s+not|forbid)\b(?:\s+\w+){0,3}\s+\b(?:commit|push|merge|rebase|tag|checkout|amend)\b/i;
 function classifyScope(instructions) {
   const findings = [];
   const rootFile = instructions.rootFile;
@@ -2463,14 +2590,15 @@ function readInstalledVersion(path) {
     return null;
   }
 }
-function checkSkillUpdate(projectRoot) {
+function checkSkillUpdate(projectRoot, globalRoot) {
+  const resolvedGlobal = globalRoot ?? (0, import_os.homedir)();
   const candidates = [
     {
       path: (0, import_path8.join)(projectRoot, ".claude", "commands", "instrlint.md"),
       isProject: true
     },
     {
-      path: (0, import_path8.join)((0, import_os.homedir)(), ".claude", "commands", "instrlint.md"),
+      path: (0, import_path8.join)(resolvedGlobal, ".claude", "commands", "instrlint.md"),
       isProject: false
     }
   ];
@@ -2513,7 +2641,7 @@ var import_path9 = require("path");
 function shouldVerify(finding) {
   if (finding.category === "stale-ref") return false;
   if (finding.category === "budget") return false;
-  if (finding.category === "structure") return false;
+  if (finding.category === "structure") return true;
   if (finding.category === "dead-rule") return !finding.autoFixable;
   if (finding.category === "contradiction") return true;
   if (finding.category === "duplicate") {
@@ -2560,6 +2688,13 @@ function buildContext(finding, parsed, projectRoot) {
       ruleB: ruleRef(parsed, finding.file, finding.line ?? 0, projectRoot)
     };
   }
+  if (finding.category === "structure") {
+    return {
+      type: "structure",
+      rule: ruleRef(parsed, finding.file, finding.line ?? 0, projectRoot),
+      suggestion: finding.suggestion
+    };
+  }
   return null;
 }
 function hashFinding(finding) {
@@ -2574,6 +2709,10 @@ var QUESTIONS = {
   duplicate: {
     en: 'Are rules A and B true semantic duplicates \u2014 do they say the same thing in different words, such that keeping both adds no value? Respond with JSON only: {"verdict":"confirmed"|"rejected"|"uncertain","reason":"<\u226420 words>"}',
     "zh-TW": '\u898F\u5247 A \u548C\u898F\u5247 B \u5728\u8A9E\u610F\u4E0A\u771F\u7684\u662F\u91CD\u8907\u7684\u55CE\u2014\u2014\u7528\u4E0D\u540C\u7684\u63AA\u8FAD\u8AAA\u540C\u4E00\u4EF6\u4E8B\uFF0C\u4FDD\u7559\u5169\u689D\u6BEB\u7121\u984D\u5916\u50F9\u503C\uFF1F\u50C5\u7528 JSON \u56DE\u7B54\uFF1A{"verdict":"confirmed"|"rejected"|"uncertain","reason":"<20 \u5B57\u4EE5\u5167>"}'
+  },
+  structure: {
+    en: 'Is this structural suggestion accurate? Should this rule truly move to a git hook or path-scoped rule file, or is it an architectural principle / general guidance that belongs in CLAUDE.md? Respond with JSON only: {"verdict":"confirmed"|"rejected"|"uncertain","reason":"<\u226420 words>"}',
+    "zh-TW": '\u9019\u689D\u7D50\u69CB\u5EFA\u8B70\u662F\u5426\u6E96\u78BA\uFF1F\u9019\u689D\u898F\u5247\u771F\u7684\u66F4\u9069\u5408\u79FB\u5230 git hook \u6216 path-scoped rule file \u4E2D\uFF0C\u9084\u662F\u5B83\u662F\u67B6\u69CB\u8AAA\u660E / \u4E00\u822C\u539F\u5247\uFF0C\u61C9\u7559\u5728 CLAUDE.md \u4E2D\uFF1F\u50C5\u7528 JSON \u56DE\u7B54\uFF1A{"verdict":"confirmed"|"rejected"|"uncertain","reason":"<20 \u5B57\u4EE5\u5167>"}'
   }
 };
 function questionFor(category, locale) {