kiri-mcp-server 0.14.0 → 0.16.1

package/README.md

@@ -2,7 +2,7 @@
 
 > Intelligent code context extraction for LLMs via Model Context Protocol
 
-[![Version](https://img.shields.io/badge/version-0.14.0-blue.svg)](package.json)
+[![Version](https://img.shields.io/badge/version-0.16.1-blue.svg)](package.json)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.6-blue.svg)](https://www.typescriptlang.org/)
 [![MCP](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io/)
@@ -20,18 +20,18 @@
 - **📝 Phrase-Aware**: Recognizes compound terms (kebab-case, snake_case) for precise matching
 - **🔒 Concurrency-Safe** _(v0.9.7+)_: Per-database queues, canonicalized DuckDB paths, and bootstrap-safe locking prevent FTS rebuild conflicts and keep locks consistent across symlinks—even on first run
 
-## 🆕 What's New in v0.14.0
+## 🆕 What's New in v0.16.1
 
-### ✨ New Features
+### 🐛 Bug Fixes
 
-- **AdaptiveK Enabled by Default**: `context_bundle` now uses adaptive K sizing automatically without requiring explicit configuration
-- **Category Aliases for AdaptiveK**: Added convenience aliases for common query categories
+- **Graceful degradation for graph layer tables**: Fixed crash when `graph_metrics`/`cochange` tables are missing
+  - Added table existence check at startup
+  - Scoring functions skip gracefully with warning logs when tables are unavailable
 
-### 🐛 Bug Fixes
+### Previous Releases
 
-- **Lint and Type Errors**: Resolved import ordering and type compatibility issues in adaptive-k module
-- **WarningManager Test**: Fixed test compatibility with adaptive-k changes
-- **Port Retry on Benchmark**: Evaluation scripts now retry on `EADDRINUSE` errors
+- **v0.16.0**: DuckDB client migration to `@duckdb/node-api`
+- **v0.15.0**: `snippets_get` view parameter, co-change scoring, stop words & IDF weighting
 
 ## ⚙️ Prerequisites
 
@@ -713,6 +713,46 @@ KIRI automatically filters sensitive files and masks sensitive values:
    pnpm unlink --global kiri-mcp-server
    ```
 
+#### Stale Lock File
+
+**Problem**: Daemon fails to start with error `Lock file already exists. Another process is indexing.`
+
+**Root Cause**: A previous daemon process crashed or was killed without proper cleanup, leaving a stale lock file.
+
+**Solution**:
+
+```bash
+# Remove the stale lock file
+rm -f .kiri/index.duckdb.sock.lock
+
+# Optionally, also remove the socket file
+rm -f .kiri/index.duckdb.sock
+
+# Restart the MCP server
+```
+
+#### Version Mismatch After Upgrade
+
+**Problem**: After upgrading KIRI, connection fails with `Version mismatch: client X.Y.Z is incompatible with daemon A.B.C`
+
+**Root Cause**: An old daemon process is still running after upgrading to a new version.
+
+**Solutions**:
+
+1. **Kill old daemon processes**:
+
+   ```bash
+   pkill -f "kiri.*daemon"
+   ```
+
+2. **Clear npx cache** (if using npx):
+
+   ```bash
+   npx clear-npx-cache
+   ```
+
+3. **Restart the MCP connection**
+
 ### Getting Help
 
 If you encounter issues not covered here:
@@ -912,8 +952,8 @@ Built with:
 
 ---
 
-**Status**: v0.14.0 (Beta) - Production-ready for MCP clients
+**Status**: v0.15.0 (Beta) - Production-ready for MCP clients
 
-**New in v0.14.0**: AdaptiveK is now enabled by default, providing intelligent result sizing out of the box. Category aliases simplify query categorization. See [CHANGELOG.md](CHANGELOG.md) for details.
+**New in v0.15.0**: Co-change scoring, stop words/IDF weighting, and `snippets_get` view parameter for explicit retrieval control. See [CHANGELOG.md](CHANGELOG.md) for details.
 
 For questions or support, please open a [GitHub issue](https://github.com/CAPHTECH/kiri/issues).

package/config/scoring-profiles.yml

@@ -11,6 +11,12 @@ default:
   blacklistPenaltyMultiplier: 0.01
   testPenaltyMultiplier: 0.02
   lockPenaltyMultiplier: 0.01
+  # Graph Layer parameters (Phase 3.2)
+  graphInbound: 0.5 # Inbound dependency boost
+  graphImportance: 0.3 # PageRank-like importance score
+  graphDecay: 0.5 # Depth decay factor (score / (depth + 1)^decay)
+  graphMaxDepth: 3 # Maximum BFS depth
+  cochange: 3.0 # Co-change boost (enabled by default)
 feature:
   textMatch: 1.0
   pathMatch: 1.4
@@ -24,6 +30,11 @@ feature:
   blacklistPenaltyMultiplier: 0.01
   testPenaltyMultiplier: 0.02
   lockPenaltyMultiplier: 0.01
+  graphInbound: 0.5
+  graphImportance: 0.35
+  graphDecay: 0.5
+  graphMaxDepth: 3
+  cochange: 0.0
 bugfix:
   textMatch: 1.0
   pathMatch: 1.3
@@ -37,6 +48,11 @@ bugfix:
   blacklistPenaltyMultiplier: 0.01
   testPenaltyMultiplier: 0.02
   lockPenaltyMultiplier: 0.01
+  graphInbound: 0.6
+  graphImportance: 0.4
+  graphDecay: 0.5
+  graphMaxDepth: 3
+  cochange: 0.0
 debug:
   textMatch: 1.0
   pathMatch: 1.3
@@ -50,6 +66,11 @@ debug:
   blacklistPenaltyMultiplier: 0.01
   testPenaltyMultiplier: 0.02
   lockPenaltyMultiplier: 0.01
+  graphInbound: 0.55
+  graphImportance: 0.35
+  graphDecay: 0.5
+  graphMaxDepth: 3
+  cochange: 0.0
 api:
   textMatch: 1.0
   pathMatch: 1.5
@@ -63,6 +84,11 @@ api:
   blacklistPenaltyMultiplier: 0.01
   testPenaltyMultiplier: 0.02
   lockPenaltyMultiplier: 0.01
+  graphInbound: 0.5
+  graphImportance: 0.3
+  graphDecay: 0.5
+  graphMaxDepth: 3
+  cochange: 0.0
 editor:
   textMatch: 1.0
   pathMatch: 1.4
@@ -76,6 +102,11 @@ editor:
   blacklistPenaltyMultiplier: 0.01
   testPenaltyMultiplier: 0.02
   lockPenaltyMultiplier: 0.01
+  graphInbound: 0.45
+  graphImportance: 0.25
+  graphDecay: 0.5
+  graphMaxDepth: 3
+  cochange: 0.0
 testfail:
   textMatch: 1.0
   pathMatch: 1.5
@@ -89,6 +120,11 @@ testfail:
   blacklistPenaltyMultiplier: 0.01
   testPenaltyMultiplier: 0.2 # testfailではテストファイルへのペナルティを緩和（80%削減、他は98%削減）
   lockPenaltyMultiplier: 0.01
+  graphInbound: 0.4
+  graphImportance: 0.3
+  graphDecay: 0.5
+  graphMaxDepth: 3
+  cochange: 0.0
 typeerror:
   textMatch: 1.0
   pathMatch: 1.5
@@ -102,3 +138,45 @@ typeerror:
   blacklistPenaltyMultiplier: 0.01
   testPenaltyMultiplier: 0.02
   lockPenaltyMultiplier: 0.01
+  graphInbound: 0.35
+  graphImportance: 0.25
+  graphDecay: 0.5
+  graphMaxDepth: 3
+  cochange: 0.0
+# Graph Layer A/B comparison profiles
+graph-off:
+  textMatch: 1.0
+  pathMatch: 1.2
+  editingPath: 1.8
+  dependency: 1.0
+  proximity: 0.3
+  structural: 0.9
+  docPenaltyMultiplier: 0.6
+  configPenaltyMultiplier: 0.05
+  implBoostMultiplier: 1.5
+  blacklistPenaltyMultiplier: 0.01
+  testPenaltyMultiplier: 0.02
+  lockPenaltyMultiplier: 0.01
+  graphInbound: 0.0
+  graphImportance: 0.0
+  graphDecay: 0.5
+  graphMaxDepth: 3
+  cochange: 0.0
+graph-on:
+  textMatch: 1.0
+  pathMatch: 1.2
+  editingPath: 1.8
+  dependency: 1.0
+  proximity: 0.3
+  structural: 0.9
+  docPenaltyMultiplier: 0.6
+  configPenaltyMultiplier: 0.05
+  implBoostMultiplier: 1.5
+  blacklistPenaltyMultiplier: 0.01
+  testPenaltyMultiplier: 0.02
+  lockPenaltyMultiplier: 0.01
+  graphInbound: 0.5
+  graphImportance: 0.3
+  graphDecay: 0.5
+  graphMaxDepth: 3
+  cochange: 3.0 # 2.0 → 3.0: further increase to strengthen co-change signal

package/config/stop-words.yml

@@ -0,0 +1,307 @@
+# Stop Words Configuration
+# ストップワード（除外語）の設定ファイル
+#
+# context_bundle のキーワード抽出でフィルタリングされる語を定義。
+# 一般的すぎる語を除外することで、検索精度を向上させる。
+#
+# @see Issue #48: Improve context_bundle stop word coverage and configurability
+# @see docs/search-ranking.md
+
+version: "1.0"
+
+# デフォルト言語
+# goalテキストの主要言語に合わせて選択
+# "en" または "ja"
+default_language: "en"
+
+languages:
+  # 英語ストップワード（Lucene/Snowball由来 + コード検索向け拡張）
+  en:
+    words:
+      # 冠詞・代名詞
+      - the
+      - a
+      - an
+      - this
+      - that
+      - these
+      - those
+      - it
+      - its
+      - they
+      - them
+      - their
+      - we
+      - our
+      - you
+      - your
+      - he
+      - she
+      - his
+      - her
+
+      # 前置詞
+      - in
+      - on
+      - at
+      - to
+      - for
+      - with
+      - from
+      - by
+      - of
+      - into
+      - about
+      - over
+      - under
+      - between
+      - through
+      - during
+      - before
+      - after
+
+      # 接続詞
+      - and
+      - or
+      - but
+      - if
+      - then
+      - else
+      - when
+      - where
+      - while
+      - because
+      - although
+      - unless
+      - until
+      - since
+
+      # 助動詞・be動詞
+      - is
+      - are
+      - was
+      - were
+      - be
+      - been
+      - being
+      - have
+      - has
+      - had
+      - do
+      - does
+      - did
+      - will
+      - would
+      - could
+      - should
+      - may
+      - might
+      - must
+      - can
+      - shall
+
+      # 副詞・形容詞（一般的）
+      - not
+      - no
+      - yes
+      - all
+      - any
+      - some
+      - each
+      - every
+      - both
+      - most
+      - other
+      - such
+      - only
+      - just
+      - also
+      - very
+      - too
+      - more
+      - less
+      - much
+      - many
+      - few
+      - now
+      - here
+      - there
+      - how
+      - what
+      - which
+      - who
+      - why
+
+      # コード検索で頻出する一般語
+      - fix
+      - test
+      - tests
+      - issue
+      - error
+      - bug
+      - fail
+      - failing
+      - make
+      - need
+      - goal
+      - want
+      - like
+      - use
+      - using
+      - used
+      - get
+      - set
+      - add
+      - new
+      - see
+      - look
+      - find
+      - work
+      - way
+      - thing
+      - something
+      - anything
+      - everything
+      - nothing
+
+  # 日本語ストップワード（助詞・助動詞・接続詞・代名詞）
+  # 正規化後のひらがな形式で記載
+  ja:
+    words:
+      # 格助詞
+      - は
+      - が
+      - を
+      - に
+      - へ
+      - で
+      - と
+      - から
+      - まで
+      - より
+      - の
+
+      # 副助詞
+      - も
+      - など
+      - ほど
+      - ばかり
+      - だけ
+      - しか
+      - さえ
+      - でも
+      - くらい
+      - ぐらい
+
+      # 接続助詞
+      - て
+      - で
+      - ば
+      - たら
+      - なら
+      - ので
+      - から
+      - けど
+      - けれど
+      - けれども
+      - が
+      - のに
+      - ても
+      - でも
+
+      # 終助詞
+      - か
+      - ね
+      - よ
+      - な
+      - わ
+      - ぞ
+      - さ
+
+      # 助動詞
+      - です
+      - ます
+      - だ
+      - である
+      - ない
+      - ぬ
+      - れる
+      - られる
+      - せる
+      - させる
+      - たい
+      - らしい
+      - ようだ
+      - そうだ
+
+      # 代名詞・指示詞
+      - これ
+      - それ
+      - あれ
+      - どれ
+      - この
+      - その
+      - あの
+      - どの
+      - ここ
+      - そこ
+      - あそこ
+      - どこ
+      - こう
+      - そう
+      - ああ
+      - どう
+      - わたし
+      - あなた
+      - かれ
+      - かのじょ
+
+      # 形式名詞
+      - こと
+      - もの
+      - ところ
+      - とき
+      - ため
+      - よう
+      - わけ
+      - はず
+      - つもり
+
+      # 一般動詞（汎用的）
+      - ある
+      - いる
+      - する
+      - なる
+      - できる
+      - いう
+      - おもう
+      - みる
+      - くる
+      - いく
+
+      # 接続詞
+      - そして
+      - しかし
+      - また
+      - および
+      - または
+      - つまり
+      - すなわち
+      - ただし
+      - なお
+      - ゆえに
+
+# プログラミング言語キーワード（全言語共通で除外）
+# 自然言語依存語は含めない
+# コード内で頻出するがセマンティックな意味が薄いキーワード
+code_generic:
+  - "null"
+  - undefined
+  - "true"
+  - "false"
+  - void
+  - nil
+
+# リポジトリ固有の追加（ユーザー定義）
+# 将来的に repos.<slug>.custom で細分化可能
+custom: []

package/dist/config/scoring-profiles.yml

@@ -11,6 +11,12 @@ default:
   blacklistPenaltyMultiplier: 0.01
   testPenaltyMultiplier: 0.02
   lockPenaltyMultiplier: 0.01
+  # Graph Layer parameters (Phase 3.2)
+  graphInbound: 0.5 # Inbound dependency boost
+  graphImportance: 0.3 # PageRank-like importance score
+  graphDecay: 0.5 # Depth decay factor (score / (depth + 1)^decay)
+  graphMaxDepth: 3 # Maximum BFS depth
+  cochange: 3.0 # Co-change boost (enabled by default)
 feature:
   textMatch: 1.0
   pathMatch: 1.4
@@ -24,6 +30,11 @@ feature:
   blacklistPenaltyMultiplier: 0.01
   testPenaltyMultiplier: 0.02
   lockPenaltyMultiplier: 0.01
+  graphInbound: 0.5
+  graphImportance: 0.35
+  graphDecay: 0.5
+  graphMaxDepth: 3
+  cochange: 0.0
 bugfix:
   textMatch: 1.0
   pathMatch: 1.3
@@ -37,6 +48,11 @@ bugfix:
   blacklistPenaltyMultiplier: 0.01
   testPenaltyMultiplier: 0.02
   lockPenaltyMultiplier: 0.01
+  graphInbound: 0.6
+  graphImportance: 0.4
+  graphDecay: 0.5
+  graphMaxDepth: 3
+  cochange: 0.0
 debug:
   textMatch: 1.0
   pathMatch: 1.3
@@ -50,6 +66,11 @@ debug:
   blacklistPenaltyMultiplier: 0.01
   testPenaltyMultiplier: 0.02
   lockPenaltyMultiplier: 0.01
+  graphInbound: 0.55
+  graphImportance: 0.35
+  graphDecay: 0.5
+  graphMaxDepth: 3
+  cochange: 0.0
 api:
   textMatch: 1.0
   pathMatch: 1.5
@@ -63,6 +84,11 @@ api:
   blacklistPenaltyMultiplier: 0.01
   testPenaltyMultiplier: 0.02
   lockPenaltyMultiplier: 0.01
+  graphInbound: 0.5
+  graphImportance: 0.3
+  graphDecay: 0.5
+  graphMaxDepth: 3
+  cochange: 0.0
 editor:
   textMatch: 1.0
   pathMatch: 1.4
@@ -76,6 +102,11 @@ editor:
   blacklistPenaltyMultiplier: 0.01
   testPenaltyMultiplier: 0.02
   lockPenaltyMultiplier: 0.01
+  graphInbound: 0.45
+  graphImportance: 0.25
+  graphDecay: 0.5
+  graphMaxDepth: 3
+  cochange: 0.0
 testfail:
   textMatch: 1.0
   pathMatch: 1.5
@@ -89,6 +120,11 @@ testfail:
   blacklistPenaltyMultiplier: 0.01
   testPenaltyMultiplier: 0.2 # testfailではテストファイルへのペナルティを緩和（80%削減、他は98%削減）
   lockPenaltyMultiplier: 0.01
+  graphInbound: 0.4
+  graphImportance: 0.3
+  graphDecay: 0.5
+  graphMaxDepth: 3
+  cochange: 0.0
 typeerror:
   textMatch: 1.0
   pathMatch: 1.5
@@ -102,3 +138,45 @@ typeerror:
   blacklistPenaltyMultiplier: 0.01
   testPenaltyMultiplier: 0.02
   lockPenaltyMultiplier: 0.01
+  graphInbound: 0.35
+  graphImportance: 0.25
+  graphDecay: 0.5
+  graphMaxDepth: 3
+  cochange: 0.0
+# Graph Layer A/B comparison profiles
+graph-off:
+  textMatch: 1.0
+  pathMatch: 1.2
+  editingPath: 1.8
+  dependency: 1.0
+  proximity: 0.3
+  structural: 0.9
+  docPenaltyMultiplier: 0.6
+  configPenaltyMultiplier: 0.05
+  implBoostMultiplier: 1.5
+  blacklistPenaltyMultiplier: 0.01
+  testPenaltyMultiplier: 0.02
+  lockPenaltyMultiplier: 0.01
+  graphInbound: 0.0
+  graphImportance: 0.0
+  graphDecay: 0.5
+  graphMaxDepth: 3
+  cochange: 0.0
+graph-on:
+  textMatch: 1.0
+  pathMatch: 1.2
+  editingPath: 1.8
+  dependency: 1.0
+  proximity: 0.3
+  structural: 0.9
+  docPenaltyMultiplier: 0.6
+  configPenaltyMultiplier: 0.05
+  implBoostMultiplier: 1.5
+  blacklistPenaltyMultiplier: 0.01
+  testPenaltyMultiplier: 0.02
+  lockPenaltyMultiplier: 0.01
+  graphInbound: 0.5
+  graphImportance: 0.3
+  graphDecay: 0.5
+  graphMaxDepth: 3
+  cochange: 3.0 # 2.0 → 3.0: further increase to strengthen co-change signal