migrate-workspace

하니스별 레거시 워크스페이스를 공유 .apothem 레이아웃으로 마이그레이션합니다.

개요

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/ 아래로 이동됩니다. 소비되는 각 소스는 먼저 백업됩니다. 이 마이그레이션은 멱등적입니다——이미 마이그레이션된 트리에서 다시 실행해도 아무 일도 일어나지 않습니다.

옵션

JSON 출력

--json 봉투는 마이그레이션 결과를 담습니다. 마이그레이션이 완료되면 status는 success이며, 페이로드는 병합된 레코드 수, .plans/ 트리가 재배치되었는지 여부, 백업 루트, 건너뛴 충돌을 보고합니다. --dry-run 호출은 대신 legacy_layout_detected를 보고합니다.

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

레거시 레이아웃이 없으면 migrated는 false이며 아무것도 작성되지 않습니다. --dry-run 봉투는 결과 수를 생략하고 감지만 보고합니다.

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

예제

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

종료 코드

함께 보기

• apothem install — 공유 프로필에서 하니스를 구체화
• apothem status — 설치, 검증, 드리프트 상태를 보고
• 플랜 규율 — 공유 .apothem/plans/ 레이아웃