Question 1

ruflo または Claude Flow CLI の --version が初回実行時に 60 秒以上ハングし、終了コード 143 で終了する問題を修正するにはどうすればよいですか？

Accepted Answer

v3.10.33 以降にアップグレードしてください。このバージョンでは、`--version`/`-V` は ONNX 埋め込みモデルをロードする前に終了します:

```bash
npx -y ruflo@3.10.33 --version
npx -y @claude-flow/cli@3.10.33 --version
```

このハングは、コールドキャッシュの状態で、CLI の初期化処理がバージョンを表示する前に HuggingFace から 23 MB の `all-MiniLM-L6-v2` ONNX モデルをダウンロードしたために発生していました。v3.10.33 では、`ruflo` と `@claude-flow/cli` の両方が `package.json` からバージョンを読み取って即座に終了するため、起動時間が 60 秒以上から約 33 ミリ秒に短縮されます。

古いリリースを使用する必要がある場合は、より長いタイムアウトを指定して、モデルキャッシュを一度だけ事前にウォームアップしてください:

```bash
timeout 180 npx -y ruflo@alpha --version
```

ダウンロードが完了すると、それ以降の呼び出しではディスクキャッシュが使用され、すばやく起動します。より広範な lazy-loading/cli-core の分離については、引き続き ADR-100/#1760 で追跡されています。

Question 2

verify.mjsが「Cannot find module '@noble/ed25519'」で失敗し、ウィットネス検証がスキップされる問題を修正するにはどうすればよいですか？

Accepted Answer

検証を実行する前に、宣言されている npm の依存関係をインストールしてください。リポジトリのルートから次を実行します：

```bash
npm ci && npm run build
```

その後、検証ツールを再度呼び出します。例えば：

```bash
node plugins/ruflo-core/scripts/witness/verify.mjs --manifest verification/linux/manifest.md.json
```

ローカルのクリーンでないチェックアウトの場合は、リポジトリルートから `npm install` を実行しても、不足している `@noble/ed25519` 依存関係をインストールできます。ソースのみの検証ランナーの pre-flight ステップに `npm ci && npm run build` を追加してください。出力に Ed25519 チェックがスキップされたと記載されている場合は、終了コード 0 を成功として扱わないでください。検証が成功した場合は、署名検証結果と pass/drift/regressed/missing のカウントを出力する必要があります。

Question 3

memory_search_unified が6つのデフォルト名前空間のみを検索し、メモリエントリを見逃してしまう問題を修正するにはどうすればよいですか？

Accepted Answer

ruflo **3.10.33以降**にアップグレードしてください(`npm install -g ruflo@3.10.33`)。ruflo 3.10.13 / @claude-flow/cli 3.10.22などの影響を受けるバージョンでは、名前空間フィルターを指定しない`memory_search_unified`がハードコードされた6つの名前空間のリストを使用していたため、`knowledge-graph`、`causal-edges`、`brain-system`などの名前空間やカスタム名前空間内のエントリが警告なく除外されていました。この修正では、デフォルトで動的な名前空間の列挙を使用し、以下が追加されました: `namespaces: string[]`、CSV形式の環境変数`CLAUDE_FLOW_MEMORY_SEARCH_NAMESPACES`、およびレスポンス内の`namespaceSource`。解決の優先順位は次のとおりです: 明示的な`namespace` → 明示的な`namespaces` → 環境変数による上書き → 動的列挙 → レガシーフォールバック。古いバージョンでは、例えば`memory_search_unified({ query: "needle", namespace: "brain-system" })`のように対象の名前空間を明示的に渡すか、アップグレードしてください。`dist/`以下の編集に依存しないでください。npmによるアップグレードで上書きされます。

Question 4

JSON以外のstdoutログやinitializeタイムアウトが原因でCodexでRuflo MCPサーバーが読み込まれない問題は、どうすれば修正できますか？

Accepted Answer

Ruflo を **v3.10.33 以降** にアップグレードしてください。このバージョンでは、サードパーティの埋め込み／モデル読み込みの進行状況ログが `stdout` から `stderr` にリダイレクトされ、`stdout` が MCP JSON-RPC フレーム専用に保たれます。

Codex MCP の設定を更新して、修正済みバージョンを固定してください:

```toml
[mcp_servers.ruflo]
command = "npx"
args = ["-y", "ruflo@3.10.33", "mcp", "start"]
enabled = true
```

その後、Codex または MCP サーバーを再起動してください。v3.10.30 で問題となっていたログには以下のようなものがありました:

```text
Disk cache hit: all-MiniLM-L6-v2
🚀 Initializing 19 worker threads...
Loading model: all-MiniLM-L6-v2 (23MB)
  Downloading: ...
```

これらのログにより、Codex のような厳格な MCP クライアントが `initialize` レスポンスのパースに失敗し、`mcp__ruflo...` ツールが表示されなくなっていました。起動タイムアウトを延長するだけでは古いバージョンは解決しません。stdout ストリームがすでに JSON 以外のテキストで破損しているためです。アップグレード後は、初回のモデルダウンロード／初期化の実行がまだ遅い場合にのみ、クライアントのタイムアウトを延長してください。

Question 5

なぜ ruflo-console は成功したセキュリティ脅威の検出を失敗として報告し、実際のエラーの代わりに '[WARN] Skipped helper auto-refresh' を表示するのですか？

Accepted Answer

`ruflo-console` を **0.40.5 以降**にアップグレードしてください。修正は PR #3934（マージ `767f7a689`）に含まれています。バージョン 0.40.3 では、ゼロ以外の CLI 終了コードをすべて失敗として誤って扱っていました。verdict コマンドは、検出結果を示すためにゼロ以外の終了コードを使用します。たとえば、`security defend`/`security scan` は脅威検出時に exit 1、`channel-scan`/`scan-plan` はゲート作動時に exit 2 を返し、metaharness のアラートスクリプトはアラート時に exit 1、実際の失敗時に exit 2 を返します。修正されたランナーは、完全な JSON レスポンスを解析し、JSON で検出結果が確認でき、かつ別の失敗が報告されていない場合に、宣言されたゼロ以外の終了コードを有効な verdict として受け入れます。また、最初の stderr 行（`[WARN]` 通知である場合があります）ではなく、実際の `[ERROR]` 行を選択する共有の `failureReason` ヘルパーを使用します。アップグレード後にコンソール/MCP サービスを再起動してください。アップグレードが遅れる場合は、コンソールの `ok:false` ステータスや最初の stderr 行に依存せず、コマンドの stdout JSON を直接確認・解析し、stderr から `[ERROR]` を検索してください。

ruflo

概要

README プレビュー

FAQ (5)

同类型项目

tensorflow

superpowers

everything-claude-code

flutter