claude-nagger 1.3.9__tar.gz

claude_nagger-1.3.9/.claude/settings.json

@@ -0,0 +1,68 @@
+{
+  "statusLine": {
+    "type": "command",
+    "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/statusline.js"
+  },
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 -m domain.hooks.session_startup_hook"
+          }
+        ]
+      },
+      {
+        "matcher": "mcp__.*__write.*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 -m domain.hooks.implementation_design_hook"
+          }
+        ]
+      },
+      {
+        "matcher": "mcp__.*replace.*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 -m domain.hooks.implementation_design_hook"
+          }
+        ]
+      },
+      {
+        "matcher": "mcp__.*insert.*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 -m domain.hooks.implementation_design_hook"
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 -m infrastructure.notifiers.discord_notifier \"📢 Claude Code から通知があります\""
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 -m infrastructure.notifiers.discord_notifier \"🛑 Claude Code セッションが停止されました\""
+          }
+        ]
+      }
+    ]
+  }
+}

claude_nagger-1.3.9/.claude/statusline.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+
+// I pull here "https://zenn.dev/pnd/articles/claude-code-statusline"
+// this code written by ogino
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+
+// Constants
+const COMPACTION_THRESHOLD = 200000 * 0.8;
+
+// Read JSON from stdin
+let input = '';
+process.stdin.on('data', (chunk) => (input += chunk));
+process.stdin.on('end', async () => {
+  try {
+    const data = JSON.parse(input);
+
+    // Extract values
+    const model = data.model?.display_name || 'Unknown';
+    const currentDir = path.basename(data.workspace?.current_dir || data.cwd || '.');
+    const sessionId = data.session_id;
+
+    // Calculate token usage for current session
+    let totalTokens = 0;
+
+    if (sessionId) {
+      // Find all transcript files
+      const projectsDir = path.join(process.env.HOME, '.claude', 'projects');
+
+      if (fs.existsSync(projectsDir)) {
+        // Get all project directories
+        const projectDirs = fs
+          .readdirSync(projectsDir)
+          .map((dir) => path.join(projectsDir, dir))
+          .filter((dir) => fs.statSync(dir).isDirectory());
+
+        // Search for the current session's transcript file
+        for (const projectDir of projectDirs) {
+          const transcriptFile = path.join(projectDir, `${sessionId}.jsonl`);
+
+          if (fs.existsSync(transcriptFile)) {
+            totalTokens = await calculateTokensFromTranscript(transcriptFile);
+            break;
+          }
+        }
+      }
+    }
+
+    // Calculate percentage
+    const percentage = Math.min(100, Math.round((totalTokens / COMPACTION_THRESHOLD) * 100));
+
+    // Format token display
+    const tokenDisplay = formatTokenCount(totalTokens);
+
+    // Color coding for percentage
+    let percentageColor = '\x1b[32m'; // Green
+    if (percentage >= 70) percentageColor = '\x1b[33m'; // Yellow
+    if (percentage >= 90) percentageColor = '\x1b[31m'; // Red
+
+    // Format session ID display
+    const sessionDisplay = sessionId ? sessionId : 'unknown';
+
+    // Build status line
+    const statusLine = `[${model}] 📁 ${currentDir} | 🪙 ${tokenDisplay} | ${percentageColor}${percentage}%\x1b[0m | 🆔 ${sessionDisplay}`;
+
+    console.log(statusLine);
+  } catch (error) {
+    // Fallback status line on error
+    console.log('[Error] 📁 . | 🪙 0 | 0%');
+  }
+});
+
+async function calculateTokensFromTranscript(filePath) {
+  return new Promise((resolve, reject) => {
+    let lastUsage = null;
+
+    const fileStream = fs.createReadStream(filePath);
+    const rl = readline.createInterface({
+      input: fileStream,
+      crlfDelay: Infinity,
+    });
+
+    rl.on('line', (line) => {
+      try {
+        const entry = JSON.parse(line);
+
+        // Check if this is an assistant message with usage data
+        if (entry.type === 'assistant' && entry.message?.usage) {
+          lastUsage = entry.message.usage;
+        }
+      } catch (e) {
+        // Skip invalid JSON lines
+      }
+    });
+
+    rl.on('close', () => {
+      if (lastUsage) {
+        // The last usage entry contains cumulative tokens
+        const totalTokens =
+          (lastUsage.input_tokens || 0) +
+          (lastUsage.output_tokens || 0) +
+          (lastUsage.cache_creation_input_tokens || 0) +
+          (lastUsage.cache_read_input_tokens || 0);
+        resolve(totalTokens);
+      } else {
+        resolve(0);
+      }
+    });
+
+    rl.on('error', (err) => {
+      reject(err);
+    });
+  });
+}
+
+function formatTokenCount(tokens) {
+  if (tokens >= 1000000) {
+    return `${(tokens / 1000000).toFixed(1)}M`;
+  } else if (tokens >= 1000) {
+    return `${(tokens / 1000).toFixed(1)}K`;
+  }
+  return tokens.toString();
+}

claude_nagger-1.3.9/.claude-nagger/command_conventions.yaml

@@ -0,0 +1,13 @@
+# コマンド実行規約定義
+# 危険なコマンドや確認が必要なコマンドに対して適用される規約を定義します
+
+rules:
+  # 例: Git操作規約
+  # - name: "Git操作規約"
+  #   patterns:
+  #     - "git*"
+  #   severity: "block"
+  #   token_threshold: 25000
+  #   message: |
+  #     Git操作を実行する場合は規約を確認してください
+  []

claude_nagger-1.3.9/.claude-nagger/config.yaml

@@ -0,0 +1,36 @@
+# claude-nagger 設定ファイル
+
+# セッション開始時設定
+session_startup:
+  enabled: true
+  messages:
+    first_time:
+      title: "プロジェクトセットアップ"
+      main_text: |
+        [ ] このプロジェクトはチケット駆動開発です
+            - MCPツールのルールに従いチケットに報告を行うこと
+        [ ] AIエージェントは選択肢がある場合は必ずオーナに選択肢を提示し､オーナーの指示を仰ぐこと｡その際は各選択肢のpro/conを提示すること
+
+      severity: "block"
+
+    # 2回目以降（継続セッション）
+    repeated:
+      title: "セッション継続時の協働規約再確認"
+      main_text: |
+        下記を1つ1つ丁寧に実行し､実行が完了したら続行してください:
+        tasks:
+        [ ] このプロジェクトはチケット駆動開発です
+          - MCPツールのルールに従いチケットに報告を行うこと
+        [ ] AIエージェントは選択肢がある場合は必ずオーナに選択肢を提示し､オーナーの指示を仰ぐこと｡その際は各選択肢のpro/conを提示すること
+      severity: "block"
+
+# コンテキスト管理設定
+context_management:
+  reminder_thresholds:
+    light_warning: 30000
+    medium_warning: 60000
+    critical_warning: 100000
+
+# デバッグ設定
+debug:
+  enable_logging: false

claude_nagger-1.3.9/.claude-nagger/file_conventions.yaml

@@ -0,0 +1,22 @@
+# ファイル編集規約定義
+# 特定のファイルパターンに対して適用される規約を定義します
+#
+# パターン記法:
+#   **/*.scss           - 全階層の.scssファイル
+#   apps/**/*.tsx       - ルート直下apps以下の全階層の.tsxファイル
+#   **/apps/**/*.scss   - どこにあるapps/でも全階層の.scssファイル（モノレポ向け）
+#   src/*.ts            - src直下の.tsファイルのみ（サブディレクトリ除外）
+#   **/test_*.py        - 全階層のtest_で始まるpyファイル
+#   **/*_test.go        - 全階層の_testで終わるgoファイル
+#   **/test/**          - どこにあるtest/でもその中の全ファイル（直下・サブ両方）
+
+rules:
+  # 例: View層編集規約
+  # - name: "View層編集規約"
+  #   patterns:
+  #     - "**/app/views/**/*.erb"
+  #   severity: "block"  # block: 完全ブロック, warn: 警告のみ
+  #   token_threshold: 35000
+  #   message: |
+  #     このファイルを変更する場合は規約を確認してください
+  []

claude_nagger-1.3.9/.claude-nagger/vault/.gitignore

@@ -0,0 +1,4 @@
+# vault/ディレクトリ内の全ファイルを除外
+# 機密情報の漏洩防止
+*
+!.gitignore

claude_nagger-1.3.9/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,114 @@
+name: Bug Report / 不具合報告
+description: Report a bug or unexpected behavior / バグや予期しない動作を報告
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ## 報告前チェック
+        - [ ] 最新版を使用していますか？ (`pip install --upgrade claude-nagger`)
+        - [ ] 既存のissueを検索しましたか？
+
+  - type: textarea
+    id: description
+    attributes:
+      label: 問題の説明 / Description
+      description: 何が起きているか簡潔に説明してください
+      placeholder: |
+        例: フックが実行されず、規約メッセージが表示されない
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: 再現手順 / Steps to Reproduce
+      description: 問題を再現する手順を記載してください
+      placeholder: |
+        1. `claude-nagger install-hooks` を実行
+        2. Claude Codeで `Edit` ツールを使用
+        3. 規約メッセージが表示されない
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: 期待する動作 / Expected Behavior
+      description: 本来どう動作すべきか
+      placeholder: |
+        例: file_conventions.yaml で定義した規約メッセージが表示される
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: 実際の動作 / Actual Behavior
+      description: 実際にどう動作したか
+      placeholder: |
+        例: 何も表示されずツールが実行された
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: 環境情報 / Environment
+      description: |
+        `claude-nagger diagnose` の出力を貼り付けてください。
+        コマンドがない場合は手動で記入してください。
+      placeholder: |
+        OS: macOS 14.2 / Ubuntu 22.04 / Windows 11
+        Python: 3.11.5
+        claude-nagger: 1.0.0
+        Claude Code: x.x.x
+      render: text
+    validations:
+      required: true
+
+  - type: textarea
+    id: config
+    attributes:
+      label: 設定ファイル / Configuration
+      description: |
+        問題に関連する設定ファイルの内容（機密情報は除去してください）
+      placeholder: |
+        # .claude-nagger/config.yaml
+        session_startup:
+          enabled: true
+        ...
+      render: yaml
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: ログ / Logs
+      description: |
+        `/tmp/claude/` 内のフック実行ログがあれば添付してください
+      render: text
+
+  - type: textarea
+    id: settings
+    attributes:
+      label: settings.json
+      description: |
+        `.claude/settings.json` の hooks 部分を貼り付けてください
+      placeholder: |
+        {
+          "hooks": {
+            "PreToolUse": [...]
+          }
+        }
+      render: json
+
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: 確認事項
+      options:
+        - label: この問題は最新版でも発生します
+          required: false
+        - label: 診断スクリプトを実行しました（ある場合）
+          required: false

claude_nagger-1.3.9/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Discussions
+    url: https://github.com/vibes/claude_nagger/discussions
+    about: 質問や議論はDiscussionsへ

claude_nagger-1.3.9/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,44 @@
+name: Feature Request / 機能リクエスト
+description: Suggest a new feature or enhancement / 新機能や改善を提案
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ## 機能リクエストについて
+        新しい機能や改善提案をお待ちしています。
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: 解決したい課題 / Problem Statement
+      description: どのような課題を解決したいですか？
+      placeholder: |
+        例: 複数プロジェクトで同じ規約を共有したいが、毎回コピーする必要がある
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: 提案する解決策 / Proposed Solution
+      description: どのような機能があれば解決できますか？
+      placeholder: |
+        例: グローバル設定ファイル (~/.claude-nagger/global_rules.yaml) を読み込む機能
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: 代替案 / Alternatives Considered
+      description: 他に検討した方法があれば記載してください
+      placeholder: |
+        例: シンボリックリンクで共有することも考えたが、管理が煩雑
+
+  - type: textarea
+    id: context
+    attributes:
+      label: 追加情報 / Additional Context
+      description: 参考になる情報（スクリーンショット、関連issue等）

claude_nagger-1.3.9/.gitignore

@@ -0,0 +1,18 @@
+**.pyc
+__pycache__/
+
+# 機密情報を含む設定ファイル
+secrets.json5
+.env
+
+# ログ
+*.log
+logs/
+log/
+
+# ビルド成果物
+build/
+dist/
+*.egg-info/
+.coverage
+.claude/settings.local.json

claude_nagger-1.3.9/.serena/.gitignore

@@ -0,0 +1 @@
+/cache

claude_nagger-1.3.9/.serena/project.yml

@@ -0,0 +1,84 @@
+# list of languages for which language servers are started; choose from:
+#   al               bash             clojure          cpp              csharp           csharp_omnisharp
+#   dart             elixir           elm              erlang           fortran          go
+#   haskell          java             julia            kotlin           lua              markdown
+#   nix              perl             php              python           python_jedi      r
+#   rego             ruby             ruby_solargraph  rust             scala            swift
+#   terraform        typescript       typescript_vts   yaml             zig
+# Note:
+#   - For C, use cpp
+#   - For JavaScript, use typescript
+# Special requirements:
+#   - csharp: Requires the presence of a .sln file in the project folder.
+# When using multiple languages, the first language server that supports a given file will be used for that file.
+# The first language is the default language and the respective language server will be used as a fallback.
+# Note that when using the JetBrains backend, language servers are not used and this list is correspondingly ignored.
+languages:
+- python
+
+# the encoding used by text files in the project
+# For a list of possible encodings, see https://docs.python.org/3.11/library/codecs.html#standard-encodings
+encoding: "utf-8"
+
+# whether to use the project's gitignore file to ignore files
+# Added on 2025-04-07
+ignore_all_files_in_gitignore: true
+
+# list of additional paths to ignore
+# same syntax as gitignore, so you can use * and **
+# Was previously called `ignored_dirs`, please update your config if you are using that.
+# Added (renamed) on 2025-04-07
+ignored_paths: []
+
+# whether the project is in read-only mode
+# If set to true, all editing tools will be disabled and attempts to use them will result in an error
+# Added on 2025-04-18
+read_only: false
+
+# list of tool names to exclude. We recommend not excluding any tools, see the readme for more details.
+# Below is the complete list of tools for convenience.
+# To make sure you have the latest list of tools, and to view their descriptions, 
+# execute `uv run scripts/print_tool_overview.py`.
+#
+#  * `activate_project`: Activates a project by name.
+#  * `check_onboarding_performed`: Checks whether project onboarding was already performed.
+#  * `create_text_file`: Creates/overwrites a file in the project directory.
+#  * `delete_lines`: Deletes a range of lines within a file.
+#  * `delete_memory`: Deletes a memory from Serena's project-specific memory store.
+#  * `execute_shell_command`: Executes a shell command.
+#  * `find_referencing_code_snippets`: Finds code snippets in which the symbol at the given location is referenced.
+#  * `find_referencing_symbols`: Finds symbols that reference the symbol at the given location (optionally filtered by type).
+#  * `find_symbol`: Performs a global (or local) search for symbols with/containing a given name/substring (optionally filtered by type).
+#  * `get_current_config`: Prints the current configuration of the agent, including the active and available projects, tools, contexts, and modes.
+#  * `get_symbols_overview`: Gets an overview of the top-level symbols defined in a given file.
+#  * `initial_instructions`: Gets the initial instructions for the current project.
+#     Should only be used in settings where the system prompt cannot be set,
+#     e.g. in clients you have no control over, like Claude Desktop.
+#  * `insert_after_symbol`: Inserts content after the end of the definition of a given symbol.
+#  * `insert_at_line`: Inserts content at a given line in a file.
+#  * `insert_before_symbol`: Inserts content before the beginning of the definition of a given symbol.
+#  * `list_dir`: Lists files and directories in the given directory (optionally with recursion).
+#  * `list_memories`: Lists memories in Serena's project-specific memory store.
+#  * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building).
+#  * `prepare_for_new_conversation`: Provides instructions for preparing for a new conversation (in order to continue with the necessary context).
+#  * `read_file`: Reads a file within the project directory.
+#  * `read_memory`: Reads the memory with the given name from Serena's project-specific memory store.
+#  * `remove_project`: Removes a project from the Serena configuration.
+#  * `replace_lines`: Replaces a range of lines within a file with new content.
+#  * `replace_symbol_body`: Replaces the full definition of a symbol.
+#  * `restart_language_server`: Restarts the language server, may be necessary when edits not through Serena happen.
+#  * `search_for_pattern`: Performs a search for a pattern in the project.
+#  * `summarize_changes`: Provides instructions for summarizing the changes made to the codebase.
+#  * `switch_modes`: Activates modes by providing a list of their names
+#  * `think_about_collected_information`: Thinking tool for pondering the completeness of collected information.
+#  * `think_about_task_adherence`: Thinking tool for determining whether the agent is still on track with the current task.
+#  * `think_about_whether_you_are_done`: Thinking tool for determining whether the task is truly completed.
+#  * `write_memory`: Writes a named memory (for future reference) to Serena's project-specific memory store.
+excluded_tools: []
+
+# initial prompt for the project. It will always be given to the LLM upon activating the project
+# (contrary to the memories, which are loaded on demand).
+initial_prompt: ""
+
+project_name: "claude_nagger"
+included_optional_tools: []

claude_nagger-1.3.9/CLAUDE.md

@@ -0,0 +1,47 @@
+# CLAUDE.md
+
+詳細は README.md 参照
+
+## コマンド
+
+```bash
+# テスト実行
+python3 -m pytest tests/ -v
+
+# 特定テスト
+python3 -m pytest tests/test_xxx.py -v          # ファイル指定
+python3 -m pytest tests/ -k "keyword" -v        # キーワード指定
+
+# カバレッジ
+python3 -m pytest --cov=src --cov-report=term-missing
+
+# ローカルテスト環境
+./scripts/setup_test_env.sh --help
+
+# フィクスチャキャプチャ
+python3 scripts/capture_fixture.py --sanitize -n 10
+
+# リリース（PyPI自動公開）
+./scripts/release.sh <version>           # フル: バージョン更新→push→GitHubリリース
+./scripts/release.sh <version> --release-only  # GitHubリリースのみ
+# 要: .env に GH_TOKEN 設定
+```
+
+## ディレクトリ構成
+
+```
+src/
+  application/   # CLI・エントリーポイント
+  domain/        # フック・マッチャー
+  infrastructure/ # 外部連携
+  shared/        # 共通ユーティリティ
+tests/           # pytest
+scripts/         # 開発用スクリプト
+.claude-nagger/  # 設定ファイル雛形
+```
+
+## 規約
+
+- テスト必須: 新機能は必ずテスト実装
+- Redmine追跡: 作業前にチケット起票
+- コミット: issue_{id} を含める

claude_nagger-1.3.9/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 HollySizzle
+
+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.