update

목적

설정을 재검증하고, 캐시를 지우고, 모든 명세 파일을 다시 다운로드합니다. 이는 워크스페이스의 전체 새로고침입니다 — 모든 캐시된 명세가 최신 상태이고 인덱스가 재구축됩니다.

사용 시기

• 원격 명세 파일이 변경되어 최신 버전을 원할 때
• swag2mcp.yaml을 편집하여 명세 위치를 추가하거나 변경한 후
• 오래되었거나 손상된 캐시를 해결할 때
• mcp를 실행하기 전에 모든 것이 최신 상태인지 확인하려고 할 때

구문

swag2mcp update [path]

인수

인수	위치	필수	설명
path	1	아니요	워크스페이스 디렉토리. 생략 시 경로 해결 규칙에 따라 결정됩니다.

플래그

없음.

작동 방식

update 명령어는 일련의 작업을 실행합니다:

1. 설정 로드 — 워크스페이스에서 swag2mcp.yaml 읽기
2. 검증 — validate와 동일한 검사 실행 (YAML 구문, 구조, 명세 파일 접근성, 형식, 인증, HTTP 클라이언트)
3. 정리 — cache/와 responses/의 모든 내용 제거
4. 재캐싱 — 모든 원격 명세 파일 다운로드 및 로컬 명세 파일을 캐시로 복사
5. 재인덱싱 — 모든 엔드포인트의 전문 검색 인덱스 재구축
6. 인증 스크립트 — ScriptAuth를 사용하는 spec용 스텁 인증 스크립트 생성
7. 고아 정리 — 더 이상 존재하지 않는 spec의 인증 스크립트 제거

swag2mcp update
swag2mcp update ./my-workspace

비활성화된 collection의 처리

disable: true가 있는 collection은 완전히 건너뜁니다 — 캐시되거나 인덱싱되지 않습니다.

명령 후 검증

swag2mcp ls [path]
# 모든 spec이 여전히 나열되고 접근 가능해야 함

세부 사항

• 자동 초기화 없음: 설정 파일이 없으면 update가 오류를 반환합니다: "configuration not found at <path>". 먼저 init을 실행하세요.
• 네트워크 의존성: 모든 원격 명세 URL에 접근할 수 있어야 합니다. 다운로드가 실패하면 전체 업데이트가 명확한 오류 메시지와 함께 실패합니다.
• 인증 스크립트 생성: spec이 ScriptAuth를 사용하고 스텁 스크립트가 없으면 update가 생성합니다. 생성에 실패하면 업데이트가 실패합니다.
• update vs clean: clean은 캐시만 제거합니다. update는 캐시를 제거하고 모든 것을 다시 다운로드합니다. 공간 확보만 필요하면 clean을 사용하고, 새로고침이 필요하면 update를 사용하세요.