Files
tutor-service/.opencode/commands/weave-repair.md

2.2 KiB

description
description
깨진 YAML 플랜 파일을 스캔하고 자동 수복

/weave-repair - YAML 자동 수복

개요

Weave 플랜 YAML 파일의 손상을 감지하고 자동으로 수복합니다.

사용법:

  • /weave-repair — 전체 플랜 파일 스캔 및 수복
  • /weave-repair $ARGUMENTS — 특정 파일만 수복 (예: holon-x-openclaw-evolution-v3)

실행 절차

1단계: 플랜 파일 스캔

1. .opencode/weave/state.yaml 확인
2. .opencode/weave/plans/ 디렉토리의 모든 .yaml 파일 목록 확인
3. .opencode/weave/PLAN.yaml (레거시) 확인

2단계: weave tool로 수복 실행

weave command=repair를 호출하여 자동 수복을 실행합니다.

3단계: 결과 보고

수복 결과를 유저에게 보여줍니다:

  • OK: 정상 파일
  • FIXED: 자동 수복 성공 (무엇을 고쳤는지 표시)
  • FAIL: 자동 수복 불가 (유저에게 복구 옵션 안내)

자동 수복 가능한 문제

문제 예시 수복 방법
닫히지 않은 따옴표 done_when: "1. fs.edit가 SecurityHook에 내부 따옴표 이스케이프 후 닫기
탭 문자 들여쓰기에 탭 사용 스페이스 2칸으로 변환
줄바꿈 문제 CR+LF 혼합 LF로 통일
백업 복원 파싱 완전 실패 .bak 파일에서 복원

자동 수복 불가한 경우

수복이 불가능한 파일이 있으면 유저에게 다음 옵션을 안내합니다:

  1. 원본 요구사항이 있다면: /weave-design으로 플랜 재생성
  2. .corrupted 백업 확인: plans 디렉토리에 백업 파일 존재 여부
  3. 수동 복구: 유저가 플랜 내용을 기억하면 그 정보로 YAML 재구성

유저에게 물어볼 것:

  • 해당 플랜의 프로젝트 이름이 무엇이었는지
  • 어떤 Phase들이 있었는지
  • 각 Phase의 진행 상태 (완료/진행중/대기)

참고

  • 수복 시 원본 파일은 .corrupted 확장자로 백업됩니다
  • 매 저장마다 .bak 백업이 자동 생성됩니다
  • weave statusweave craft 실행 시에도 YAML 로드 실패하면 자동 수복을 시도합니다