リリースおよびアップグレードプロセス
npm パッケージの更新後
次に通常の Engram コマンドを実行した際、新しいバージョン用に初期化済みのワークスペース/グローバルのルートがバックグラウンドで自動的に一度調整されます。これにより、古いメタデータが検出された場合に、生成されたヘルプ、メモリインデックス、グラフファイル、および対象となるベクトルサイドカーを更新することで、v0.0.8 以降のリリース間のメモリスキーマの変更がカバーされます。
起動時のチェックは、初回の実行後は意図的に低コストに抑えられています。現在のバージョンがすでに記録されている場合は、小さな構成マーカーのみを読み取ります。npm postinstall から実行されたり、新しいメモリのルートを作成したり、人間が作成したファイルを置き換えたりすることはありません。コマンドでこれをスキップするには、--no-auto-upgrade または ENGRAM_NO_AUTO_UPGRADE=1 を使用します。
明示的なアップグレード
engram upgrade
engram upgrade --plan
engram upgrade --latest
engram upgrade は、人間が作成したファイルを保持したまま、生成されたワークスペースのヘルプ、メモリインデックス、グラフファイル、対象となるベクトルサイドカー、既存の Engram 生成ワークスペーススキルセットファイル、および登録されたグローバルスキルセットを更新します。
engram upgrade --latest はより強力です。すでにリンクされているワークスペースエージェントおよび登録されたグローバルインストールに対して、現在 Engram が管理するリンク済みエージェントの成果物（指示ファイル、ルール、MCP/プラグイン構成、および管理対象フックを含む）を上書きし、リンクされたホストが新しいパッケージの出力をすぐに受け取れるようにします。
生成された Engram アダプターファイルを意図的に置き換える場合にのみ --force を使用してください。
スキルセットレンダリングプロファイル
ランタイム対応ホストの場合、Engram は完全なプロトコルの代わりに小さなブートストラップ手順をインストールします。フックはルーティングされたタスクコンテキストを提供し、MCP ツールはロード/検索/提案の動作を提供し、スラッシュアダプターまたは Agent Skills は詳細なコマンドワークフローを伝達します。信頼性の高いランタイムコンテキストの注入がないフォールバックターゲットは、引き続きコンパクトな手動指示を受け取ります。
SQLite 設定 DB へのフォールバック
Engram の SQLite 設定 DB は、ワークスペース/プロファイル管理のための最適化です。DB をオープンまたは初期化できない場合、通常の読み取り/書き込みコマンドは JSON 設定のスナップショットにフォールバックします。DB 固有のコマンドは、通常のメモリ使用をブロックする代わりに SQLite が利用不可であることを報告します。