update-nexus

Nexus を更新

目的: ユーザーデータを保護しながら、上流の Nexus リポジトリからシステムファイルを同期します

トリガー: 「nexus を更新」「nexus を同期」「更新を取得」「更新を確認」

所要時間: 1～2 分

---

この操作の内容

以下のシステムファイルを上流から更新します：

• 00-system/ - コアフレームワーク、スキル、ドキュメント
• CLAUDE.md - エントリーポイント
• README.md - プロジェクトの README

以下のユーザーフォルダーは保護されます（絶対に変更されません）：

• 01-memory/ - 目標、学習内容、設定
• 02-projects/ - プロジェクト
• 03-skills/ - カスタムスキル
• 04-workspace/ - ファイル
• .env、.claude/ - 秘密情報と設定

---

ワークフロー

ステップ 1：更新を確認する

更新確認を実行します：

python 00-system/core/nexus-loader.py --check-update

JSON レスポンスを解析します：

• checked: false でエラーがある場合 → エラーを表示して、安全に終了します
• update_available: false の場合 → 「すでに最新です！」と表示して終了します
• update_available: true の場合 → ステップ 2 に進みます

ステップ 2：変更内容を表示する

ユーザーに次の内容を表示します：

UPDATE AVAILABLE

Current version: {local_version}
New version:     {upstream_version}

Files to update ({changes_count}):
{list changed_files, max 20}

PROTECTED (will NOT be touched):
- 01-memory/    (your goals & config)
- 02-projects/  (your projects)
- 03-skills/    (your custom skills)
- 04-workspace/ (your files)

ステップ 3：ユーザーに確認する

次のように質問します：「更新を続行しますか？（yes/no）」

• no の場合 → 「更新をキャンセルしました」と表示して終了します
• yes の場合 → ステップ 4 に進みます

ステップ 4：同期を実行する

同期コマンドを実行します：

python 00-system/core/nexus-loader.py --sync --force

JSON レスポンスを解析します：

• success: false の場合 → エラーメッセージを表示し、修正方法を提案します
• success: true の場合 → ステップ 5 に進みます

ステップ 5：結果を表示する

成功した場合、次の内容を表示します：

UPDATE COMPLETE!

{local_version} → {upstream_version}

Updated paths:
{list files_updated}

Backup saved to: {backup_path}

To commit this update:
  git add . && git commit -m "Update Nexus to v{upstream_version}"

---

エラー処理

エラー	ユーザーへのメッセージ
"Not a git repository"	"このフォルダーは Git リポジトリではありません。次のコマンドで初期化してください：git init"
"Could not reach upstream"	"GitHub に接続できません。インターネット接続を確認してください。"
"Uncommitted changes detected"	"コミットされていない変更があります。先にコミットしてください：\n git add . && git commit -m 'Save changes'"
"Could not read upstream version"	"上流リポジトリが正しく設定されていない可能性があります。user-config.yaml の URL を確認してください。"

---

詳細：ドライラン

変更を適用せずにプレビューするには：

python 00-system/core/nexus-loader.py --sync --dry-run

これにより、変更される内容を確認できますが、実際には何も変更されません。

---

メモ

• バックアップ: 同期の前に、現在のシステムファイルが .sync-backup/{timestamp}/ にバックアップされます
• 安全性: ユーザーデータのフォルダーは同期対象のパスに含まれないため、変更されることはありません
• 上流リモート: 初回使用時に自動で追加されます（名前は "upstream"）
• デフォルト URL: https://github.com/beamanalytica/Nexus-v4.git（user-config.yaml で上書きできます）