Question 1

markitdownパーサーがMarkdown、テキスト、JSONファイルの先頭にUTF-8 BOM（U+FEFF）を残してしまう問題を修正する方法

Accepted Answer

バグは `hindsight_api/engine/parsers/markitdown.py` の `MarkitdownParser._utf8_stream_info` メソッドにあります。このメソッドは markitdown に `StreamInfo(charset="utf-8")` を渡しますが、Python の `utf-8` コーデックはバイトオーダーマークを保持するため、markitdown 自身の BOM 除去検出がバイパスされてしまいます。修正方法: BOM が存在する場合は charset ヒントを `utf-8-sig` に変更します:

```python
StreamInfo(charset="utf-8-sig" if data.startswith(codecs.BOM_UTF8) else "utf-8")
```

ここで `data` は UTF-8 プローブですでに使用されている `bytes(file_data)` です。BOM のないファイルは、変更されていない `utf-8` ヒントをそのまま使用します。CSV、HTML、`.ipynb` ファイルは、それぞれのコンバーターがすでにマークを取り除いているため影響を受けません。この修正と `tests/test_markitdown_parser.py` 内の4つのテストを含む準備済みのコミットが、github.com/L4XB/hindsight/commit/49ac70ea56e0a862a2cec69d77accfb624422f78 で入手できます。

Question 2

なぜ Hindsight では MCP ツールの呼び出しごとに重複した audit_log 行が2行書き込まれるのですか？

Accepted Answer

これは FastMCP 3.x との組み合わせにおける Hindsight v1.1.0 の既知のバグです:`_apply_audit_logging`(hindsight_api/mcp_tools.py)が FastMCP インスタンスの `call_tool` を置き換えますが、FastMCP 3.2.0 のミドルウェアチェーンが内部的に `self.call_tool`(監査済みラッパー)を再呼び出しするため、2 つ目のネストされた `AuditEntry` が開かれてしまいます。このため、ツール自体は 1 回しか実行されなくても、`destructive_op` および `mcp tool=…` のログ行が 2 重に出力されます。修正方法:PR #6142 を含むビルド(`main` で修正済み、コミット 1e3a4841a7ee)にアップグレードしてください — 同時実行下も含め、1 呼び出しにつき正確に 1 行が生成されることが検証済みです。パッチ適用版を保守している場合の回避策は次のとおりです:(1) ミドルウェアを介さない内部呼び出しを監査せずにそのまま通過させる:`if kwargs.get("run_middleware") is False: return await original_call_tool(name, arguments, **kwargs)`;または (2) `call_tool` を置き換える代わりに、監査を FastMCP ミドルウェアとして実装する。修正の確認:1 回の MCP 呼び出し後に `GET /v1/default/banks/<bank>/audit-logs?transport=mcp` を実行します。

Question 3

OpenCode 2 のみがインストールされている場合に、Hindsight の survey が実行されない（surveyDocs がゼロのままになる）のはなぜですか？

Accepted Answer

根本原因: `@vectorize-io/hindsight-coding-agents` 0.8.2 では、`src/core/survey.ts` 内の survey フォールバックのバージョン検出が `Number(/(\d+)\./.exec(out)?.[1] ?? 0) >= 1` を使用しているため、安定版の OpenCode 2 (例: `opencode v2.1.2`) が survey 対応ランナーとして誤って受け入れられます。OpenCode 2 アダプターは意図的に `hindsight-survey` エージェントを登録しないため、survey は `AgentNotFoundError: hindsight-survey` で失敗し、構造的な検出結果が一切取り込まれません。修正: 述語を厳密な `major === 1` に変更します (これにより `1.18.9` / `opencode v1.18.9` は引き続き対象となり、`2.1.2` と `0.0.0-beta-*` は除外されます)。これにより、OpenCode 2 はリースが取得される前にスキップされ、フォールバックループが次にサポートされている CLI を選択できるようになります。`src/core/survey.test.ts -t 'reads `opencode --version`'` で検証済み (5 件パス)。パッチを適用しない回避策: (1) Claude Code、Codex、Antigravity CLI などのサポートされている V1 survey ランナーを PATH にインストールする。(2) 読み取り専用の survey エージェントを手動で設定し、survey をスタンドアロンで実行して 4 つの survey ドキュメントを取り込む。

Question 4

Hindsight の codebaseSurvey が、codex が codex.exe としてインストールされている Windows 環境で一切起動しないのはなぜですか？また、それを修正するにはどうすればよいですか？

Accepted Answer

`@vectorize-io/hindsight-coding-agents` v0.8.1 では、`binOnPath`/`resolveAgentBin()` が POSIX セマンティクスを前提としています。(1) 素のコマンド名は `PATHEXT` を適用せず `join(dir, bin)` でのみテストされるため、`codex.exe` のみを提供する Windows インストールは一切見つかりません。(2) フォワードスラッシュのパスのみがパスとして認識されるため (`bin.includes("/")`)、`HINDSIGHT_CODEX_BIN` に指定された `C:\...\codex.exe` のようなバックスラッシュの絶対パスは素の名前として扱われて失敗します。(3) `accessSync(..., X_OK)` はディレクトリも受け入れてしまいます。他のハーネス (`claude-code`、`antigravity-cli`、`opencode`) が利用できない場合、`startCodebaseSurvey()` はサイレントに false を返し、サーベイは一切開始されません。回避策: `HINDSIGHT_CODEX_BIN` に実際の実行ファイルをフォワードスラッシュで設定します。例: `setx HINDSIGHT_CODEX_BIN "C:/Users/<you>/AppData/Roaming/npm/codex.exe"` — バックスラッシュのパスは検出に失敗するだけでなく、そのまま codex の `-c` TOML 値に挿入され、`codex exec` が約 137ms で exit 1 する原因になります。あるいは、サポートされている別のハーネスをインストールするか、素の `codex` を PATH に置いてください。注意: アップストリームは `shell:false` で spawn するため、`.cmd`/`.bat` のシムは EINVAL で失敗します — `.exe` を直接指定してください。

Question 5

OpenCode v2.1.0 で @vectorize-io/hindsight-coding-agents v0.8.1 を読み込む際に発生する 'failed to load plugin' SchemaError (Expected object at "default") の修正方法

Accepted Answer

OpenCode v2.1.0のプラグインホストは、`Bun.resolveSync` を介してパッケージディレクトリを解決しますが、これは `package.json` の `exports`/`main` に従って `dist/index.js`（v1の関数エントリーポイント）を読み込むため、v2のオブジェクトスキーマによって拒否されます。回避策: `~/.hindsight/coding-agents/package.json` を編集し、`"main"` と `"exports"."."` の両方が `./index.js`（`{id, setup}` をエクスポートするv2のオブジェクトエントリーポイント）を指すようにします。`Bun.resolveSync(<dir>)` で確認してください。`index.js` に解決され、デフォルトエクスポートが `{id, setup}` になっているはずです。変更後、プラグインは読み込まれ、そのツール（`hindsight_recall`、`hindsight_retain`、`hindsight_reflect`）を登録します。注意: このパッチは次回の `npx` アップデートで上書きされるため、パッケージメンテナーがアップストリームでエントリーポイントのエクスポートを修正するまでの一時的な応急処置です。

hindsight

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト