migrate-workspace

ハーネスごとのレガシーなワークスペースを、共有の .apothem レイアウトへ移行します。

構文Copy Anchor Link

apothem migrate-workspace [--project PATH] [--dry-run]
                          [--quiet|-q] [--verbose|-v]
                          [--format plain|json] [--json] [--no-color]

migrate-workspace は、ハーネスごとのレガシーなデータホーム（.apothem/<harness>/...）とレガシーな .plans/ ツリーを、単一の共有作業ディレクトリ .apothem/{plans,memory,learning,contexts} へ統合します。 基点は、--project が指定された場合はその解決済みのルート、指定されない場合は現在の作業ディレクトリ（プロジェクトローカルのデフォルト）です。

ハーネスごとのメモリ、コンテキスト、学習のストアは、id 単位で共有ストアへ和集合マージされます。学習シグナルは連結したうえで重複が除去されます。競合するレコード（同じ id で本体が異なるもの）はスキップされ、上書きされることは決してありません。 レガシーな .plans/ ツリーは .apothem/plans/ の下へ移動します。 取り込まれる各ソースは、事前にバックアップされます。 この移行はべき等です。すでに移行済みのツリーに対して再実行しても、何も起こりません。

オプションCopy Anchor Link

JSON 出力Copy Anchor Link

--json のエンベロープは、移行の結果を含みます。 移行が完了した場合、status は success となり、ペイロードはマージされたレコード数、.plans/ ツリーが再配置されたかどうか、バックアップのルート、そしてスキップされた競合があればそれを報告します。 --dry-run で呼び出した場合は、代わりに legacy_layout_detected を報告します。

{
  "schema_version": 1,
  "command": "migrate-workspace",
  "status": "success",
  "base": "/home/example/project",
  "migrated": true,
  "backup_root": "/home/example/project/.apothem/backups/migrate-20260101T120000Z",
  "memory_merged": 12,
  "contexts_merged": 4,
  "learning_merged": 7,
  "conflicts": [],
  "plans_moved": true,
  "notes": []
}

レガシーなレイアウトが存在しない場合、migrated は false となり、何も書き込まれません。 --dry-run のエンベロープは結果のカウントを省略し、検出結果のみを報告します。

{
  "schema_version": 1,
  "command": "migrate-workspace",
  "base": "/home/example/project",
  "dry_run": true,
  "legacy_layout_detected": false
}

例Copy Anchor Link

apothem migrate-workspace
apothem migrate-workspace --project .
apothem migrate-workspace --dry-run --json

終了コードCopy Anchor Link

関連項目Copy Anchor Link

• apothem install — 共有プロファイルからハーネスをマテリアライズする
• apothem status — インストール、検証、ドリフトの状態を報告する
• 計画ディシプリン — 共有の .apothem/plans/ レイアウト