deadrule 0.2.0 → 0.3.0

package/LICENSE

@@ -1,21 +1,190 @@
-MIT License
-
-Copyright (c) 2026 JSK9999
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 JSK9999
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.ko.md

@@ -0,0 +1,158 @@
+# deadrule
+
+AI 코딩 어시스턴트 설정에서 죽은 규칙을 찾아줍니다.
+
+AI 코딩 도구(Claude Code, Cursor, Codex)에서 규칙과 스킬을 정의할 수 있습니다. 시간이 지나면 규칙이 쌓입니다. 어떤 건 작업과 전혀 관련이 없고, 어떤 건 서로 중복되고, 어떤 건 AI가 이미 하는 것을 또 지시합니다. **deadrule**이 찾아줍니다.
+
+**[English README](README.md)**
+
+## 데모
+
+![deadrule 데모](demo/demo.gif)
+
+## 바로 시작
+
+```bash
+npx deadrule
+```
+
+API 키 불필요. 설정 불필요. 런타임 의존성 0개.
+
+## 검사 항목
+
+| 검사 | 찾는 것 |
+|------|---------|
+| **죽은 규칙** | 한 번도 쓰지 않는 언어의 규칙 (세션 로그 기반) |
+| **중복 파일** | 서로 겹치는 규칙 파일 |
+| **겹치는 지시사항** | 여러 파일에 복붙된 동일 지시문 |
+| **기본 동작 중복** | Claude가 이미 하는 행동을 또 지시하는 규칙 |
+| **모호한 지시사항** | 너무 추상적이라 실행 불가능한 지시문 |
+| **토큰 비용** | 각 규칙 파일이 소비하는 토큰 수 |
+| **오래된 규칙** | 90일 이상 수정되지 않은 규칙 |
+
+## 죽은 규칙을 찾는 방법
+
+deadrule은 모든 프로젝트의 Claude Code 세션 로그(JSONL)를 읽습니다. 실제로 편집한 파일 확장자(`.ts`, `.py`, `.go` 등)를 추출한 뒤, 규칙과 대조합니다. Python 규칙이 있는데 `.py` 파일을 한 번도 편집하지 않았다면 — 그 규칙은 **죽은 규칙**입니다.
+
+## 커스텀 경로
+
+```bash
+# 특정 디렉토리 스캔
+deadrule ./my-rules/
+
+# 여러 경로 동시 스캔
+deadrule ./rules/ ./agents/
+
+# 클론한 규칙 세트 스캔
+deadrule ~/everything-claude-code/rules/
+```
+
+## 기본 스캔 위치
+
+- `~/.claude/rules/*.md` (글로벌 규칙)
+- `.claude/rules/*.md` (프로젝트 규칙)
+- `CLAUDE.md` (프로젝트 루트)
+- `.cursorrules` (Cursor)
+
+## 실전 테스트: Everything Claude Code (136개 규칙)
+
+```
+$ deadrule ./rules/ ./agents/
+
+deadrule v0.2.1
+================
+
+Scanned: 136 rules (0 global, 136 project)
+Total token cost: ~90,077 tokens (45.0% of context)
+
+DEAD RULES (based on 34 sessions across all projects)
+  Languages you actually use:
+    .js      8 file edits
+    .ts      7 file edits
+    .tsx     7 file edits
+    .html    7 file edits
+    .py      4 file edits
+
+  Rules for languages you NEVER use:
+    cpp/coding-style.md
+    -> No C++ files edited in 34 sessions
+    dart/coding-style.md
+    -> No Dart/Flutter files edited in 34 sessions
+    rust/coding-style.md
+    -> No Rust files edited in 34 sessions
+    ... (총 61개 죽은 규칙)
+
+OVERLAPPING DIRECTIVES (50 found, showing top 5)
+  "Surgical fixes only - don't refactor, just fix the error"
+  -> repeated in: 7 files
+
+  "Approve: No CRITICAL or HIGH issues"
+  -> repeated in: 11 files
+
+REDUNDANT WITH CLAUDE DEFAULTS
+  "SQL injection prevention (parameterized queries)"
+  -> Claude already uses parameterized queries by default
+
+SUMMARY
+  61 DEAD rule(s) - never relevant to your work
+  1 duplicate pair(s)
+  50 overlapping directive(s)
+  13 redundant with Claude defaults
+  25 vague directive(s)
+```
+
+주요 발견:
+- **136개 규칙 중 61개가 죽은 규칙** — 매 세션 로드되지만 한 번도 관련 없음
+- **약 9만 토큰 (컨텍스트의 45%)** 이 규칙에만 소비됨
+
+## GitHub Action
+
+워크플로우에 추가하면 PR마다 자동으로 규칙 건강 상태를 체크합니다:
+
+```yaml
+# .github/workflows/deadrule.yml
+name: Rule Health Check
+on: [pull_request]
+
+jobs:
+  deadrule:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: JSK9999/deadrule@main
+        with:
+          paths: '.claude/rules'
+```
+
+문제가 발견되면 PR에 자동으로 리포트 코멘트가 달립니다.
+
+## CLI 옵션
+
+```bash
+# 기본 스캔
+npx deadrule
+
+# 커스텀 경로 스캔
+npx deadrule ./rules/ ./agents/
+
+# CI/CD용 JSON 출력
+npx deadrule --json
+```
+
+## 로드맵
+
+[이슈 목록](https://github.com/JSK9999/deadrule/issues)에서 계획된 기능을 확인하세요.
+
+- [x] CI/CD용 `--json` 출력
+- [x] GitHub Action + PR 코멘트
+- [ ] `--fix` 중복 규칙 자동 병합
+- [ ] Cursor `.mdc` 및 Codex `AGENTS.md` 지원
+- [ ] 프로젝트 간 규칙 비교
+
+## 기여
+
+[CONTRIBUTING.md](CONTRIBUTING.md)에서 설정 방법과 가이드라인을 확인하세요.
+
+## 라이선스
+
+Apache 2.0

package/README.md

@@ -2,7 +2,13 @@
 
 Find dead rules in your AI coding assistant config.
 
-AI coding tools (Claude Code, Cursor, Codex) let you define rules and skills. Over time, rules pile up. Some duplicate each other. Some repeat what the AI already does. Some are too vague to follow. **deadrule** finds them.
+AI coding tools (Claude Code, Cursor, Codex) let you define rules and skills. Over time, rules pile up. Some are never relevant to your work. Some duplicate each other. Some repeat what the AI already does. **deadrule** finds them.
+
+**[한국어 README](README.ko.md)**
+
+## Demo
+
+![deadrule demo](demo/demo.gif)
 
 ## Quick Start
 
@@ -16,6 +22,7 @@ No API keys. No setup. No runtime dependencies.
 
 | Check | What it finds |
 |-------|--------------|
+| **Dead rules** | Rules for languages you never use (based on session logs) |
 | **Duplicates** | Rules that overlap with each other |
 | **Overlapping directives** | Same instruction copied across multiple files |
 | **Claude defaults** | Rules that repeat Claude's built-in behavior |
@@ -23,12 +30,14 @@ No API keys. No setup. No runtime dependencies.
 | **Token cost** | How many tokens each rule file consumes |
 | **Stale rules** | Rules not modified in 90+ days |
 
-## Custom Paths
+## How it finds dead rules
+
+deadrule reads your Claude Code session logs (JSONL) across all projects. It extracts which file types you actually edit (`.ts`, `.py`, `.go`, etc.), then cross-references with your rules. If you have Python rules but never edited a `.py` file — those rules are **dead**.
 
-Scan any directory of rules:
+## Custom Paths
 
 ```bash
-# Scan a specific rules directory
+# Scan a specific directory
 deadrule ./my-rules/
 
 # Scan multiple paths
@@ -38,7 +47,7 @@ deadrule ./rules/ ./agents/
 deadrule ~/everything-claude-code/rules/
 ```
 
-## Where it scans (default)
+## Default scan locations
 
 - `~/.claude/rules/*.md` (global rules)
 - `.claude/rules/*.md` (project rules)
@@ -50,55 +59,94 @@ deadrule ~/everything-claude-code/rules/
 ```
 $ deadrule ./rules/ ./agents/
 
-deadrule v0.1.0
+deadrule v0.2.1
 ================
 
 Scanned: 136 rules (0 global, 136 project)
 Total token cost: ~90,077 tokens (45.0% of context)
 
-DUPLICATES
-  agents/java-build-resolver.md <-> agents/kotlin-build-resolver.md  (51% overlap)
-
-OVERLAPPING DIRECTIVES (50 found, showing top 10)
+DEAD RULES (based on 34 sessions across all projects)
+  Languages you actually use:
+    .js      8 file edits
+    .ts      7 file edits
+    .tsx     7 file edits
+    .html    7 file edits
+    .py      4 file edits
+
+  Rules for languages you NEVER use:
+    cpp/coding-style.md
+    -> No C++ files edited in 34 sessions
+    dart/coding-style.md
+    -> No Dart/Flutter files edited in 34 sessions
+    rust/coding-style.md
+    -> No Rust files edited in 34 sessions
+    ... (61 dead rules total)
+
+OVERLAPPING DIRECTIVES (50 found, showing top 5)
   "Surgical fixes only - don't refactor, just fix the error"
-  -> repeated in: agents/cpp-build-resolver.md, agents/dart-build-resolver.md,
-     agents/java-build-resolver.md, agents/rust-build-resolver.md,
-     agents/go-build-resolver.md, agents/kotlin-build-resolver.md,
-     agents/pytorch-build-resolver.md
+  -> repeated in: 7 files
 
   "Approve: No CRITICAL or HIGH issues"
-  -> repeated in: common/code-review.md, agents/code-reviewer.md,
-     agents/cpp-reviewer.md, agents/csharp-reviewer.md, ... (11 files)
+  -> repeated in: 11 files
 
 REDUNDANT WITH CLAUDE DEFAULTS
-  common/security.md: "SQL injection prevention (parameterized queries)"
-  -> Claude already uses parameterized queries by default
-
-  java/security.md: "Always use parameterized queries - never concat..."
+  "SQL injection prevention (parameterized queries)"
   -> Claude already uses parameterized queries by default
 
-TOKEN COST BREAKDOWN (top 10)
-  agents/flutter-reviewer.md       ~ 3510 tokens  ||||......  4%
-  agents/performance-optimizer.md  ~ 3111 tokens  |||.......  3%
-  agents/code-reviewer.md          ~ 2187 tokens  ||........  2%
-  ... 126 more files (~69,115 tokens)
-
 SUMMARY
+  61 DEAD rule(s) - never relevant to your work
   1 duplicate pair(s)
   50 overlapping directive(s)
   13 redundant with Claude defaults
   25 vague directive(s)
 ```
 
-Key finding: **ECC loads ~90K tokens (45% of context window) in rules alone.**
+Key findings:
+- **61 out of 136 rules are dead** — loaded every session but never relevant
+- **~90K tokens (45% of context window)** consumed by rules alone
+
+## GitHub Action
+
+Add to your workflow to automatically check rule health on every PR:
+
+```yaml
+# .github/workflows/deadrule.yml
+name: Rule Health Check
+on: [pull_request]
+
+jobs:
+  deadrule:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: JSK9999/deadrule@main
+        with:
+          paths: '.claude/rules'
+```
+
+This will comment on PRs with a rule health report when issues are found.
+
+## CLI Options
+
+```bash
+# Default scan
+npx deadrule
+
+# Scan custom paths
+npx deadrule ./rules/ ./agents/
+
+# JSON output for CI/CD
+npx deadrule --json
+```
 
 ## Roadmap
 
 See [open issues](https://github.com/JSK9999/deadrule/issues) for planned features.
 
-- [ ] Runtime rule tracking via hooks (find truly unused rules)
-- [ ] `--json` output for CI/CD
+- [x] `--json` output for CI/CD
+- [x] GitHub Action with PR comments
 - [ ] `--fix` auto-merge duplicate rules
+- [ ] Cursor `.mdc` and Codex `AGENTS.md` support
 - [ ] Cross-project rule comparison
 
 ## Contributing
@@ -107,4 +155,4 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for setup and guidelines.
 
 ## License
 
-MIT
+Apache 2.0

package/dist/index.js

@@ -9,8 +9,10 @@ import { analyzeStaleness } from "./analyzers/staleness.js";
 import { analyzeUsage } from "./analyzers/usage.js";
 import { printReport } from "./reporter.js";
 async function main() {
+    const args = process.argv.slice(2);
+    const jsonMode = args.includes("--json");
     const cwd = process.cwd();
-    const customPaths = process.argv.slice(2).filter((a) => !a.startsWith("-"));
+    const customPaths = args.filter((a) => !a.startsWith("-"));
     const scanResults = await scanRuleFiles(cwd, customPaths);
     if (scanResults.length === 0) {
         console.log("No rule files found.");
@@ -44,13 +46,18 @@ async function main() {
             }
             : undefined,
     };
-    printReport(result);
     const issues = duplicates.length +
         directiveOverlaps.length +
         defaultMatches.length +
         vagueDirectives.length +
         staleRules.length +
         (result.usage?.deadRules.length ?? 0);
+    if (jsonMode) {
+        console.log(JSON.stringify({ ...result, issueCount: issues }, null, 2));
+    }
+    else {
+        printReport(result);
+    }
     process.exit(issues > 0 ? 1 : 0);
 }
 main().catch((err) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deadrule",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Find dead rules in your AI coding assistant config",
   "type": "module",
   "bin": {
@@ -23,7 +23,7 @@
     "rules",
     "linter"
   ],
-  "license": "MIT",
+  "license": "Apache-2.0",
   "devDependencies": {
     "typescript": "^5.7.0",
     "@types/node": "^22.0.0"