에이전트 · Orca

Orca가 Mac에 남기는 것.

Orca의 작업 공간은 git 워크트리입니다. Devbroom은 git 자체로 하나하나 따로 판정하며, Orca가 이미 제거한 것과 설정이 중간에 멈춘 것은 따로 보여 줍니다.

살피는 대상

폴더마다 고유한 규칙이 있습니다.

Devbroom은 모든 위치를 Orca의 동작 방식에 맞춰 다룹니다. 에이전트가 스스로 정리하는 것은 에이전트에게 맡기고, 자체 명령이 있는 것은 그 명령에 맡깁니다.

판정 대상항목마다 따로 확인합니다. 준비됨으로 나오면 정리할 수 있습니다.

작업 공간

Git 워크트리. 하나하나 따로 판정합니다.

~/orca/workspaces
판정 대상

제거된 작업 공간

각 저장소 안에 있는, Orca가 이미 제거한 작업 공간.

<저장소>/.orca-worktree-trash
판정 대상

설정 중인 작업 공간

중간에 멈춘 설정이 여기에 파일을 남길 수 있습니다. 안을 살펴보세요.

~/orca/workspaces/.orca-preparing
판정 대상
워크트리

Orca의 워크트리를 흔적으로 알아봅니다.

다음 흔적으로 워크트리가 Orca의 것임을 알아봅니다. 흔적이 강할수록 소유자를 더 확실하게 표시합니다.

  • 확실git 메타데이터의 orca/ 폴더
  • 유력Orca의 <number>-<uuid> 형식을 따르는 git 관리 이름
  • 유력~/orca/workspaces 폴더 안
  • 저장되지 않은 작업이 있으면 차단됨. git은 --force 없이 이런 워크트리를 제거하지 않으며, Devbroom은 --force를 절대 쓰지 않습니다.
  • 그 안이나 상위 폴더에서 세션이 실행 중이면 차단됨.
  • 무시된 파일이 있으면 검토 필요: git worktree remove는 묻지 않고 그 파일들을 지웁니다.
호환성

Orca의 파일부터 확인합니다.

에이전트의 데이터를 신뢰하기 전에, Devbroom은 파일이 예상한 형식인지 확인합니다. 그렇지 않으면 그 데이터는 읽기만 하며, 어느 것도 정리 준비됨으로 간주하지 않습니다.

테스트된 버전1.4.0 - 1.4.221

이 범위를 벗어난 버전도 형식이 맞으면 동작하며, “아직 테스트되지 않음”으로 표시됩니다.

형식 확인git 자체

git 워크트리만 사용하며 git 자체로 읽습니다. Orca 고유의 파일 형식에는 의존하지 않습니다.

사용 중인 버전devbroom compat

이 Mac에 설치된 버전과 그 버전이 테스트되었는지를 보여 줍니다.

Orca는 일하게 두세요. 뒷정리는 Devbroom이 합니다.