vector-setup

Vector のセットアップ

[email protected] とオプションのアドオンをセットアップし、初回実行時からすべての /vector サブコマンドが正常に動作するようにします。

この手順の目的

初期状態では、いくつかの /vector サブコマンドが、わかりにくい依存関係エラーで失敗します。

エラー	不足しているパッケージ
ONNX WASM files not bundled. The onnx/ directory is missing.	ruvector-onnx-embeddings-wasm
Brain commands require @ruvector/pi-brain	@ruvector/pi-brain
SONA not available. Native error: Cannot find module '/.../@ruvector/sona/index.js'	@ruvector/ruvllm（JS フォールバック）
LLM commands require @ruvector/ruvllm	@ruvector/ruvllm

このスキルでは、これらをまとめてインストールします。

手順

1. ruvector のバージョンを固定します：

   npm install [email protected]
   

2. アドオンをインストールします（冪等です。不足しているものだけがインストールされます）：

   npm install ruvector-onnx-embeddings-wasm \
               @ruvector/pi-brain \
               @ruvector/ruvllm
   

   より軽量なインストールにするには、--full を指定して @ruvector/graph-node と @ruvector/router もインストールします：

   npm install ruvector-onnx-embeddings-wasm \
               @ruvector/pi-brain \
               @ruvector/ruvllm \
               @ruvector/graph-node \
               @ruvector/router
   

3. バイナリを確認します：

   npx -y [email protected] doctor
   npx -y [email protected] info
   

4. MCP サーバーを登録します：

   claude mcp add ruvector -- npx -y [email protected] mcp start
   claude mcp list | grep ruvector
   

5. よく使うサブコマンドを簡易チェックします：

   npx -y [email protected] hooks route "test"
   npx -y [email protected] attention list
   npx -y [email protected] rvf examples
   

6. （任意）brain と edge 用の pi ID を生成します：

   npx -y [email protected] identity generate
   npx -y [email protected] identity show
   

スモークテスト

インストールを確実に検証するには、プラグインに同梱されているスモークテストスクリプトを実行します：

bash plugins/ruflo-ruvector/scripts/smoke.sh

バージョン固定、トップレベルのサブコマンドの表示、hooks ast-analyze、hooks route、attention list、rvf examples、info をチェックします。契約されたインターフェースに逸脱が検出されると、ゼロ以外の終了コードを返します。

この手順ではインストールされないもの

• Rust のネイティブツールチェーン（任意。ソースからビルドする場合にのみ必要です）
• プラットフォーム固有のネイティブバインディング（@ruvector/core によって自動検出されます）
• @ruvector/sona のネイティブバインディング（macOS arm64 では @ruvector/ruvllm 経由の JS フォールバックで十分です。Linux x64 には独自のネイティブバインディングがあります）

このスキルの実行後も doctor が問題を報告する場合は、出力をそのまま貼り付けて質問してください。