instrlint 0.1.2 → 0.1.5

package/dist/cli.js

@@ -5,6 +5,7 @@ import { Command } from "commander";
 
 // src/commands/run-command.ts
 import { execSync } from "child_process";
+import { createInterface } from "readline";
 import { basename as basename2 } from "path";
 import chalk4 from "chalk";
 
@@ -787,8 +788,12 @@ function analyzeBudget(instructions) {
       autoFixable: false
     });
   }
-  const { tokens: rulesTokens, method: rulesMethod } = sumTokens(instructions.rules);
-  const { tokens: skillsTokens, method: skillsMethod } = sumTokens(instructions.skills);
+  const { tokens: rulesTokens, method: rulesMethod } = sumTokens(
+    instructions.rules
+  );
+  const { tokens: skillsTokens, method: skillsMethod } = sumTokens(
+    instructions.skills
+  );
   const { tokens: subFilesTokens, method: subFilesMethod } = sumTokens(
     instructions.subFiles
   );
@@ -826,11 +831,18 @@ function analyzeBudget(instructions) {
       autoFixable: false
     });
   }
-  const tokenMethod = [rootFileMethod, rulesMethod, skillsMethod, subFilesMethod].every(
-    (m) => m === "measured"
-  ) ? "measured" : "estimated";
+  const tokenMethod = [
+    rootFileMethod,
+    rulesMethod,
+    skillsMethod,
+    subFilesMethod
+  ].every((m) => m === "measured") ? "measured" : "estimated";
   const fileBreakdown = [
-    { path: instructions.rootFile.path, tokenCount: rootFileTokens, tokenMethod: rootFileMethod },
+    {
+      path: instructions.rootFile.path,
+      tokenCount: rootFileTokens,
+      tokenMethod: rootFileMethod
+    },
     ...instructions.rules.map((r) => ({
       path: r.path,
       tokenCount: r.tokenCount,
@@ -850,6 +862,7 @@ function analyzeBudget(instructions) {
   const summary = {
     systemPromptTokens: SYSTEM_PROMPT_TOKENS,
     rootFileTokens,
+    rootFileLines: rootLines,
     rootFileMethod,
     rulesTokens,
     rulesMethod,
@@ -1426,6 +1439,8 @@ var INFO_DEDUCTION = 1;
 var MAX_CRITICAL_DEDUCTION = 40;
 var MAX_WARNING_DEDUCTION = 30;
 var MAX_INFO_DEDUCTION = 10;
+var MAX_ROOT_FILE_PENALTY = 30;
+var MAX_BUDGET_DEDUCTION = 30;
 function gradeFromScore(score) {
   if (score >= 90) return "A";
   if (score >= 80) return "B";
@@ -1437,16 +1452,32 @@ function calculateScore(findings, budget) {
   const criticals = findings.filter((f) => f.severity === "critical").length;
   const warnings = findings.filter((f) => f.severity === "warning").length;
   const infos = findings.filter((f) => f.severity === "info").length;
-  const criticalDeduction = Math.min(criticals * CRITICAL_DEDUCTION, MAX_CRITICAL_DEDUCTION);
-  const warningDeduction = Math.min(warnings * WARNING_DEDUCTION, MAX_WARNING_DEDUCTION);
+  const criticalDeduction = Math.min(
+    criticals * CRITICAL_DEDUCTION,
+    MAX_CRITICAL_DEDUCTION
+  );
+  const warningDeduction = Math.min(
+    warnings * WARNING_DEDUCTION,
+    MAX_WARNING_DEDUCTION
+  );
   const infoDeduction = Math.min(infos * INFO_DEDUCTION, MAX_INFO_DEDUCTION);
+  const rootLines = budget.rootFileLines;
+  let rootFilePenalty = 0;
+  if (rootLines > 400) {
+    rootFilePenalty = 10 + Math.floor((rootLines - 400) / 100) * 5;
+  } else if (rootLines > 200) {
+    rootFilePenalty = 5 + Math.floor((rootLines - 200) / 100) * 3;
+  }
+  rootFilePenalty = Math.min(rootFilePenalty, MAX_ROOT_FILE_PENALTY);
   const baselinePct = budget.totalBaseline / CONTEXT_WINDOW2;
   let budgetDeduction = 0;
-  if (baselinePct > 0.5) budgetDeduction = 15;
-  else if (baselinePct > 0.25) budgetDeduction = 5;
+  if (baselinePct > 0.25) {
+    budgetDeduction = 5 + Math.floor((baselinePct - 0.25) * 40);
+  }
+  budgetDeduction = Math.min(budgetDeduction, MAX_BUDGET_DEDUCTION);
   const score = Math.max(
     0,
-    100 - criticalDeduction - warningDeduction - infoDeduction - budgetDeduction
+    100 - criticalDeduction - warningDeduction - infoDeduction - rootFilePenalty - budgetDeduction
   );
   return { score, grade: gradeFromScore(score) };
 }
@@ -1558,6 +1589,8 @@ var en_default = {
   "markdown.budgetIssues": "Budget Issues",
   "markdown.refactoringOpportunities": "Refactoring Opportunities",
   "markdown.lineRef": "(line {{line}})",
+  "markdown.budgetCategory": "Category",
+  "markdown.budgetTokens": "Tokens",
   "markdown.actionPlan": "## Action Plan",
   "markdown.attribution": "*Generated by [instrlint](https://github.com/jed1978/instrlint)*",
   "ci.passed": "\u2713 instrlint passed  score={{score}} grade={{grade}}",
@@ -1565,9 +1598,13 @@ var en_default = {
   "ci.writtenTo": "\u2192 written to {{file}}",
   "initCi.created": "\u2713 Created {{path}}",
   "initCi.alreadyExists": "{{path}} already exists. Use --force to overwrite.",
-  "install.installed": "\u2713 Installed to {{path}}",
+  "install.installed": "\u2713 Installed to {{path}}\n  \u2192 Restart Claude Code to activate /instrlint",
   "install.alreadyExists": "{{path}} already exists. Use --force to overwrite.",
   "install.unknownTarget": "Specify --claude-code or --codex",
+  "install.outdatedTitle": "instrlint skill is outdated",
+  "install.outdatedVersions": "installed: {{installed}} \u2192 current: {{current}}",
+  "install.updateCmd": "npx instrlint install {{flag}} --force",
+  "install.updatePrompt": "Update skill now?",
   "fix.manualActions": "MANUAL ACTIONS NEEDED",
   "fix.hookCreate": "Add to .claude/settings.json:",
   "fix.hookWarning": "\u26A0 Hook executes shell commands \u2014 review carefully before adding",
@@ -1659,6 +1696,8 @@ var zh_TW_default = {
   "markdown.budgetIssues": "Token \u9810\u7B97\u554F\u984C",
   "markdown.refactoringOpportunities": "\u91CD\u69CB\u5EFA\u8B70",
   "markdown.lineRef": "\uFF08\u7B2C {{line}} \u884C\uFF09",
+  "markdown.budgetCategory": "\u985E\u5225",
+  "markdown.budgetTokens": "Token \u6578",
   "markdown.actionPlan": "## \u884C\u52D5\u8A08\u756B",
   "markdown.attribution": "*\u7531 [instrlint](https://github.com/jed1978/instrlint) \u751F\u6210*",
   "ci.passed": "\u2713 instrlint \u901A\u904E  \u5206\u6578={{score}} \u7B49\u7D1A={{grade}}",
@@ -1666,9 +1705,13 @@ var zh_TW_default = {
   "ci.writtenTo": "\u2192 \u5DF2\u5BEB\u5165 {{file}}",
   "initCi.created": "\u2713 \u5DF2\u5EFA\u7ACB {{path}}",
   "initCi.alreadyExists": "{{path}} \u5DF2\u5B58\u5728\u3002\u4F7F\u7528 --force \u8986\u84CB\u3002",
-  "install.installed": "\u2713 \u5DF2\u5B89\u88DD\u81F3 {{path}}",
+  "install.installed": "\u2713 \u5DF2\u5B89\u88DD\u81F3 {{path}}\n  \u2192 \u91CD\u65B0\u555F\u52D5 Claude Code \u5F8C\u5373\u53EF\u4F7F\u7528 /instrlint",
   "install.alreadyExists": "{{path}} \u5DF2\u5B58\u5728\u3002\u4F7F\u7528 --force \u8986\u84CB\u3002",
   "install.unknownTarget": "\u8ACB\u6307\u5B9A --claude-code \u6216 --codex",
+  "install.outdatedTitle": "instrlint skill \u7248\u672C\u904E\u820A",
+  "install.outdatedVersions": "\u5DF2\u5B89\u88DD\uFF1A{{installed}} \u2192 \u6700\u65B0\uFF1A{{current}}",
+  "install.updateCmd": "npx instrlint install {{flag}} --force",
+  "install.updatePrompt": "\u662F\u5426\u7ACB\u5373\u66F4\u65B0\uFF1F",
   "fix.manualActions": "\u9700\u8981\u624B\u52D5\u64CD\u4F5C",
   "fix.hookCreate": "\u52A0\u5165 .claude/settings.json\uFF1A",
   "fix.hookWarning": "\u26A0 Hook \u6703\u57F7\u884C shell command\uFF0C\u8ACB\u4ED4\u7D30\u78BA\u8A8D\u5F8C\u518D\u52A0\u5165",
@@ -1998,15 +2041,25 @@ function mdSeverityIcon(f) {
   if (f.severity === "warning") return "\u{1F7E1}";
   return "\u2139\uFE0F";
 }
+function mdBar(fraction, width = 20) {
+  const filled = Math.round(Math.min(1, Math.max(0, fraction)) * width);
+  const empty = width - filled;
+  return "`" + "\u2588".repeat(filled) + "\u2591".repeat(empty) + "`";
+}
+function mdFormatTokens(count, method) {
+  const fmt = new Intl.NumberFormat(getLocale());
+  return method === "estimated" ? `~${fmt.format(count)}` : fmt.format(count);
+}
 function reportMarkdown(report, extraSections = []) {
-  const { project, tool, score, grade, findings } = report;
+  const { project, tool, score, grade, findings, budget } = report;
   const criticals = findings.filter((f) => f.severity === "critical").length;
   const warnings = findings.filter((f) => f.severity === "warning").length;
   const infos = findings.filter((f) => f.severity === "info").length;
+  const gradeEmoji = grade === "A" ? "\u{1F7E2}" : grade === "B" ? "\u{1F535}" : grade === "C" ? "\u{1F7E1}" : grade === "D" ? "\u{1F7E0}" : "\u{1F534}";
   const lines = [
     `# ${t("markdown.title", { project })}`,
     "",
-    t("markdown.scoreLine", { score: String(score), grade, tool }),
+    `${gradeEmoji} **${score}/100 (${grade})** ${mdBar(score / 100, 25)} \xB7 \`${tool}\``,
     "",
     t("markdown.summary"),
     "",
@@ -2017,6 +2070,58 @@ function reportMarkdown(report, extraSections = []) {
     `| ${t("markdown.info")} | ${infos} |`,
     ""
   ];
+  const window = budget.totalBaseline + budget.availableTokens;
+  const budgetRows = [
+    {
+      labelKey: "label.systemPrompt",
+      tokens: budget.systemPromptTokens,
+      method: "estimated"
+    },
+    {
+      labelKey: "label.rootFile",
+      tokens: budget.rootFileTokens,
+      method: budget.rootFileMethod
+    },
+    {
+      labelKey: "label.ruleFiles",
+      tokens: budget.rulesTokens,
+      method: budget.rulesMethod
+    },
+    {
+      labelKey: "label.skillFiles",
+      tokens: budget.skillsTokens,
+      method: budget.skillsMethod
+    },
+    {
+      labelKey: "label.subDirFiles",
+      tokens: budget.subFilesTokens,
+      method: budget.subFilesMethod
+    },
+    {
+      labelKey: "label.mcpServers",
+      tokens: budget.mcpTokens,
+      method: "estimated"
+    }
+  ].filter((r) => r.tokens > 0);
+  lines.push(`## ${t("label.tokenBudget")}`, "");
+  lines.push(
+    `| ${t("markdown.budgetCategory")} | ${t("markdown.budgetTokens")} | % | |`,
+    "|------|--------|---|---|"
+  );
+  for (const row of budgetRows) {
+    const pctVal = Math.round(row.tokens / window * 100);
+    lines.push(
+      `| ${t(row.labelKey)} | ${mdFormatTokens(row.tokens, row.method)} | ${pctVal}% | ${mdBar(row.tokens / window, 12)} |`
+    );
+  }
+  const baselinePct = Math.round(budget.totalBaseline / window * 100);
+  lines.push(
+    `| **${t("label.baselineTotal")}** | **${mdFormatTokens(budget.totalBaseline, budget.tokenMethod)}** | **${baselinePct}%** | ${mdBar(budget.totalBaseline / window, 12)} |`
+  );
+  lines.push(
+    `| ${t("label.available")} | ${mdFormatTokens(budget.availableTokens, "estimated")} | ${100 - baselinePct}% | |`
+  );
+  lines.push("");
   const categories = [
     {
       labelKey: "markdown.contradictions",
@@ -2263,6 +2368,163 @@ function markdownStructureSuggestions(suggestions, projectRoot) {
   return lines;
 }
 
+// src/utils/skill-version.ts
+import { existsSync as existsSync7, readFileSync as readFileSync8 } from "fs";
+import { join as join7 } from "path";
+import { homedir } from "os";
+import { fileURLToPath } from "url";
+function readPackageVersion() {
+  const thisFile = fileURLToPath(import.meta.url);
+  for (const levels of [2, 3]) {
+    const pkgPath = join7(thisFile, ...Array(levels).fill(".."), "package.json");
+    if (existsSync7(pkgPath)) {
+      const raw = JSON.parse(readFileSync8(pkgPath, "utf8"));
+      if (typeof raw === "object" && raw !== null && "version" in raw && typeof raw.version === "string") {
+        return raw.version;
+      }
+    }
+  }
+  return "0.0.0";
+}
+var CURRENT_VERSION = readPackageVersion();
+var VERSION_RE = /^instrlint-version:\s*(.+)$/m;
+function extractVersion(content) {
+  const m = VERSION_RE.exec(content);
+  return m ? m[1].trim() : null;
+}
+function readInstalledVersion(path) {
+  if (!existsSync7(path)) return null;
+  try {
+    return extractVersion(readFileSync8(path, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function checkSkillUpdate(projectRoot) {
+  const candidates = [
+    {
+      path: join7(projectRoot, ".claude", "commands", "instrlint.md"),
+      isProject: true
+    },
+    {
+      path: join7(homedir(), ".claude", "commands", "instrlint.md"),
+      isProject: false
+    }
+  ];
+  for (const { path, isProject } of candidates) {
+    const installed = readInstalledVersion(path);
+    if (installed !== null && installed !== CURRENT_VERSION) {
+      return {
+        installedVersion: installed,
+        currentVersion: CURRENT_VERSION,
+        installPath: path,
+        isProject
+      };
+    }
+  }
+  return null;
+}
+function injectVersion(content, version) {
+  if (/^instrlint-version:/m.test(content)) {
+    return content.replace(
+      /^instrlint-version:.*$/m,
+      `instrlint-version: ${version}`
+    );
+  }
+  const updated = content.replace(
+    /^(---\n[\s\S]*?)(---)$/m,
+    `$1instrlint-version: ${version}
+$2`
+  );
+  if (updated === content) {
+    throw new Error("injectVersion: no YAML frontmatter found in skill file");
+  }
+  return updated;
+}
+
+// src/commands/install-command.ts
+import { existsSync as existsSync8, mkdirSync, readFileSync as readFileSync9, writeFileSync as writeFileSync2 } from "fs";
+import { join as join8 } from "path";
+import { homedir as homedir2 } from "os";
+import { fileURLToPath as fileURLToPath2 } from "url";
+function resolveSkillFile(target) {
+  const thisFile = fileURLToPath2(import.meta.url);
+  const subDir = target === "claude-code" ? "claude-code" : "codex";
+  for (const levels of [2, 3]) {
+    const parts = Array(levels).fill("..");
+    const candidate = join8(thisFile, ...parts, "skills", subDir, "SKILL.md");
+    if (existsSync8(candidate)) return candidate;
+  }
+  return join8(thisFile, "..", "..", "skills", subDir, "SKILL.md");
+}
+function readSkillContent(target) {
+  const skillPath = resolveSkillFile(target);
+  try {
+    const raw = readFileSync9(skillPath, "utf8");
+    return injectVersion(raw, CURRENT_VERSION);
+  } catch {
+    throw new Error(
+      `Could not read skill file at ${skillPath}. Make sure the package is properly installed.`
+    );
+  }
+}
+function installClaudeCode(content, projectRoot, isProject, force, output) {
+  const targetDir = isProject ? join8(projectRoot, ".claude", "commands") : join8(homedir2(), ".claude", "commands");
+  const targetPath = join8(targetDir, "instrlint.md");
+  if (existsSync8(targetPath) && !force) {
+    output.error(t("install.alreadyExists", { path: targetPath }));
+    return { exitCode: 1, errorMessage: "file already exists" };
+  }
+  mkdirSync(targetDir, { recursive: true });
+  writeFileSync2(targetPath, content, "utf8");
+  output.log(t("install.installed", { path: targetPath }));
+  return { exitCode: 0 };
+}
+function installCodex(content, projectRoot, force, output) {
+  const targetDir = join8(projectRoot, ".agents", "skills", "instrlint");
+  const targetPath = join8(targetDir, "SKILL.md");
+  if (existsSync8(targetPath) && !force) {
+    output.error(t("install.alreadyExists", { path: targetPath }));
+    return { exitCode: 1, errorMessage: "file already exists" };
+  }
+  mkdirSync(targetDir, { recursive: true });
+  writeFileSync2(targetPath, content, "utf8");
+  output.log(t("install.installed", { path: targetPath }));
+  return { exitCode: 0 };
+}
+function runInstall(opts, output = console) {
+  const projectRoot = opts.projectRoot ?? process.cwd();
+  const force = opts.force ?? false;
+  if (opts.claudeCode) {
+    let content;
+    try {
+      content = readSkillContent("claude-code");
+    } catch (err) {
+      output.error(String(err));
+      return { exitCode: 1, errorMessage: String(err) };
+    }
+    return installClaudeCode(
+      content,
+      projectRoot,
+      opts.project ?? false,
+      force,
+      output
+    );
+  }
+  if (opts.codex) {
+    let content;
+    try {
+      content = readSkillContent("codex");
+    } catch (err) {
+      output.error(String(err));
+      return { exitCode: 1, errorMessage: String(err) };
+    }
+    return installCodex(content, projectRoot, force, output);
+  }
+  output.error(t("install.unknownTarget"));
+  return { exitCode: 1, errorMessage: "no target specified" };
+}
+
 // src/commands/run-command.ts
 function isGitClean(cwd) {
   try {
@@ -2352,6 +2614,7 @@ async function runAll(opts, output = console) {
     printStructureSuggestions(suggestions, projectRoot, output);
     return { exitCode: 0 };
   }
+  const skillUpdate = checkSkillUpdate(projectRoot);
   if (opts.format === "json") {
     output.log(reportJson(report));
     return { exitCode: 0 };
@@ -2359,12 +2622,54 @@ async function runAll(opts, output = console) {
   if (opts.format === "markdown") {
     const mdSuggestions = buildStructureSuggestions(allFindings);
     const mdExtra = markdownStructureSuggestions(mdSuggestions, projectRoot);
-    output.log(reportMarkdown(report, mdExtra));
+    const updateSection = skillUpdate ? [
+      "",
+      `> \u26A0\uFE0F **${t("install.outdatedTitle")}** (${t("install.outdatedVersions", { installed: skillUpdate.installedVersion, current: skillUpdate.currentVersion })})`,
+      `> \`${t("install.updateCmd", { flag: skillUpdate.isProject ? "--claude-code --project" : "--claude-code" })}\``
+    ] : [];
+    output.log(reportMarkdown(report, [...mdExtra, ...updateSection]));
     return { exitCode: 0 };
   }
   printCombinedTerminal(report, output);
+  if (skillUpdate && process.stdout.isTTY) {
+    output.log("");
+    output.log(
+      `  ${chalk4.yellow("\u26A0")}  ${chalk4.bold(t("install.outdatedTitle"))} (${t("install.outdatedVersions", { installed: skillUpdate.installedVersion, current: skillUpdate.currentVersion })})`
+    );
+    const confirmed = await promptYesNo(`  ${t("install.updatePrompt")}`);
+    if (confirmed) {
+      const installResult = runInstall(
+        {
+          claudeCode: true,
+          project: skillUpdate.isProject,
+          force: true,
+          projectRoot
+        },
+        output
+      );
+      if (installResult.exitCode !== 0) {
+        output.error?.(
+          `Update failed: ${installResult.errorMessage ?? "unknown error"}`
+        );
+      }
+    }
+    output.log("");
+  }
   return { exitCode: 0 };
 }
+function promptYesNo(question) {
+  return new Promise((resolve) => {
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+    rl.question(`${question} ${chalk4.gray("[Y/n]")} `, (answer) => {
+      rl.close();
+      const trimmed = answer.trim().toLowerCase();
+      resolve(trimmed === "" || trimmed === "y");
+    });
+  });
+}
 
 // src/commands/deadrules-command.ts
 import chalk5 from "chalk";
@@ -2525,7 +2830,7 @@ async function runStructure(opts, output = console) {
 }
 
 // src/commands/ci-command.ts
-import { writeFileSync as writeFileSync2 } from "fs";
+import { writeFileSync as writeFileSync3 } from "fs";
 import { basename as basename3 } from "path";
 
 // src/reporters/sarif.ts
@@ -2653,7 +2958,7 @@ async function runCi(opts, output = console) {
     formatted = reportJson(report);
   }
   if (opts.output != null) {
-    writeFileSync2(opts.output, formatted, "utf8");
+    writeFileSync3(opts.output, formatted, "utf8");
     const pass = !shouldFail(allFindings, failOn);
     const statusKey = pass ? "ci.passed" : "ci.failed";
     output.error(
@@ -2667,8 +2972,8 @@ async function runCi(opts, output = console) {
 }
 
 // src/commands/init-ci-command.ts
-import { existsSync as existsSync7, mkdirSync, writeFileSync as writeFileSync3 } from "fs";
-import { join as join7 } from "path";
+import { existsSync as existsSync9, mkdirSync as mkdirSync2, writeFileSync as writeFileSync4 } from "fs";
+import { join as join9 } from "path";
 function githubWorkflow() {
   return `name: instrlint
 
@@ -2737,14 +3042,14 @@ instrlint:
 function runInitCi(opts, output = console) {
   const projectRoot = opts.projectRoot ?? process.cwd();
   if (opts.github) {
-    const workflowDir = join7(projectRoot, ".github", "workflows");
-    const workflowPath = join7(workflowDir, "instrlint.yml");
-    if (existsSync7(workflowPath) && !opts.force) {
+    const workflowDir = join9(projectRoot, ".github", "workflows");
+    const workflowPath = join9(workflowDir, "instrlint.yml");
+    if (existsSync9(workflowPath) && !opts.force) {
       output.error(t("initCi.alreadyExists", { path: workflowPath }));
       return { exitCode: 1, errorMessage: "file already exists" };
     }
-    mkdirSync(workflowDir, { recursive: true });
-    writeFileSync3(workflowPath, githubWorkflow(), "utf8");
+    mkdirSync2(workflowDir, { recursive: true });
+    writeFileSync4(workflowPath, githubWorkflow(), "utf8");
     output.log(t("initCi.created", { path: workflowPath }));
     return { exitCode: 0 };
   }
@@ -2756,93 +3061,11 @@ function runInitCi(opts, output = console) {
   return { exitCode: 1, errorMessage: "no target specified" };
 }
 
-// src/commands/install-command.ts
-import { existsSync as existsSync8, mkdirSync as mkdirSync2, readFileSync as readFileSync8, writeFileSync as writeFileSync4 } from "fs";
-import { join as join8 } from "path";
-import { homedir } from "os";
-import { fileURLToPath } from "url";
-function resolveSkillFile(target) {
-  const thisFile = fileURLToPath(import.meta.url);
-  const subDir = target === "claude-code" ? "claude-code" : "codex";
-  for (const levels of [2, 3]) {
-    const parts = Array(levels).fill("..");
-    const candidate = join8(thisFile, ...parts, "skills", subDir, "SKILL.md");
-    if (existsSync8(candidate)) return candidate;
-  }
-  return join8(thisFile, "..", "..", "skills", subDir, "SKILL.md");
-}
-function readSkillContent(target) {
-  const skillPath = resolveSkillFile(target);
-  try {
-    return readFileSync8(skillPath, "utf8");
-  } catch {
-    throw new Error(
-      `Could not read skill file at ${skillPath}. Make sure the package is properly installed.`
-    );
-  }
-}
-function installClaudeCode(content, projectRoot, isProject, force, output) {
-  const targetDir = isProject ? join8(projectRoot, ".claude", "commands") : join8(homedir(), ".claude", "commands");
-  const targetPath = join8(targetDir, "instrlint.md");
-  if (existsSync8(targetPath) && !force) {
-    output.error(t("install.alreadyExists", { path: targetPath }));
-    return { exitCode: 1, errorMessage: "file already exists" };
-  }
-  mkdirSync2(targetDir, { recursive: true });
-  writeFileSync4(targetPath, content, "utf8");
-  output.log(t("install.installed", { path: targetPath }));
-  return { exitCode: 0 };
-}
-function installCodex(content, projectRoot, force, output) {
-  const targetDir = join8(projectRoot, ".agents", "skills", "instrlint");
-  const targetPath = join8(targetDir, "SKILL.md");
-  if (existsSync8(targetPath) && !force) {
-    output.error(t("install.alreadyExists", { path: targetPath }));
-    return { exitCode: 1, errorMessage: "file already exists" };
-  }
-  mkdirSync2(targetDir, { recursive: true });
-  writeFileSync4(targetPath, content, "utf8");
-  output.log(t("install.installed", { path: targetPath }));
-  return { exitCode: 0 };
-}
-function runInstall(opts, output = console) {
-  const projectRoot = opts.projectRoot ?? process.cwd();
-  const force = opts.force ?? false;
-  if (opts.claudeCode) {
-    let content;
-    try {
-      content = readSkillContent("claude-code");
-    } catch (err) {
-      output.error(String(err));
-      return { exitCode: 1, errorMessage: String(err) };
-    }
-    return installClaudeCode(
-      content,
-      projectRoot,
-      opts.project ?? false,
-      force,
-      output
-    );
-  }
-  if (opts.codex) {
-    let content;
-    try {
-      content = readSkillContent("codex");
-    } catch (err) {
-      output.error(String(err));
-      return { exitCode: 1, errorMessage: String(err) };
-    }
-    return installCodex(content, projectRoot, force, output);
-  }
-  output.error(t("install.unknownTarget"));
-  return { exitCode: 1, errorMessage: "no target specified" };
-}
-
 // src/cli.ts
 var program = new Command();
 program.enablePositionalOptions().name("instrlint").description(
   "Lint and optimize your CLAUDE.md / AGENTS.md \u2014 find dead rules, token waste, and structural issues"
-).version("0.1.0").option(
+).version(CURRENT_VERSION).option(
   "--format <type>",
   "output format (terminal|json|markdown)",
   "terminal"
@@ -2855,27 +3078,27 @@ program.command("budget").description("Token budget analysis only").option(
   "--format <type>",
   "output format (terminal|json|markdown)",
   "terminal"
-).option("--tool <name>", "force tool detection (claude-code|codex|cursor)").action(async function() {
+).option("--lang <locale>", "output language (en|zh-TW)").option("--tool <name>", "force tool detection (claude-code|codex|cursor)").action(async function() {
   const opts = this.opts();
-  const lang = this.parent?.opts()?.lang;
+  const lang = opts.lang ?? this.parent?.opts()?.lang;
   const result = await runBudget({
     ...opts,
     ...lang !== void 0 && { lang }
   });
   if (result.exitCode !== 0) process.exit(result.exitCode);
 });
-program.command("deadrules").description("Dead rule detection only").option("--format <type>", "output format (terminal|json)", "terminal").option("--tool <name>", "force tool detection (claude-code|codex|cursor)").action(async function() {
+program.command("deadrules").description("Dead rule detection only").option("--format <type>", "output format (terminal|json)", "terminal").option("--lang <locale>", "output language (en|zh-TW)").option("--tool <name>", "force tool detection (claude-code|codex|cursor)").action(async function() {
   const opts = this.opts();
-  const lang = this.parent?.opts()?.lang;
+  const lang = opts.lang ?? this.parent?.opts()?.lang;
   const result = await runDeadRules({
     ...opts,
     ...lang !== void 0 && { lang }
   });
   if (result.exitCode !== 0) process.exit(result.exitCode);
 });
-program.command("structure").description("Structural analysis only").option("--format <type>", "output format (terminal|json)", "terminal").option("--tool <name>", "force tool detection (claude-code|codex|cursor)").action(async function() {
+program.command("structure").description("Structural analysis only").option("--format <type>", "output format (terminal|json)", "terminal").option("--lang <locale>", "output language (en|zh-TW)").option("--tool <name>", "force tool detection (claude-code|codex|cursor)").action(async function() {
   const opts = this.opts();
-  const lang = this.parent?.opts()?.lang;
+  const lang = opts.lang ?? this.parent?.opts()?.lang;
   const result = await runStructure({
     ...opts,
     ...lang !== void 0 && { lang }