n8n-doctor

/oh-my-n8n:n8n-doctor

체크리스트 (각 항목 PASS/FAIL + FAIL 시 1줄 복구 명령):

1. 워크스페이스 준비

• OMN_WORKSPACE 또는 ~/.claude/oh-my-n8n.local.md 의 workspace: 또는 ~/.oh-my-n8n 존재?
• → FAIL: /oh-my-n8n:omn-setup 실행

2. 의존성

• <workspace>/node_modules 존재?
• → FAIL: cd <workspace> && npm install

3. 커스텀 노드 미러

• <workspace>/custom-nodes/dist-prebuilt/*.node.js 존재 (>= 1개)?
• → FAIL: cp $OMN_PREBUILT_SOURCE/*.js <workspace>/custom-nodes/dist-prebuilt/

4. 카탈로그 신선도

• <workspace>/schemas/internal-nodes.json 의 generatedAt 이 미러 mtime 보다 새로움?
• → FAIL: cd <workspace> && npm run extract-catalog

5. docker 인스턴스

• docker ps --filter name=oh-my-n8n --format '{{.Status}}' 가 "Up..." ?
• → FAIL: /oh-my-n8n:n8n-up

6. 헬스체크

• curl -sf http://localhost:15679/healthz 200?
• → FAIL: /oh-my-n8n:n8n-logs --tail 50 으로 원인 확인

7. 컨테이너 내 커스텀 노드 마운트

• docker exec oh-my-n8n ls /home/node/.n8n/custom | grep -c .node.js >= 1 ?
• → FAIL: 미러 갱신(cp ... dist-prebuilt/) 후 /oh-my-n8n:n8n-restart

8. 코어 노드 캐시

• <workspace>/schemas/n8n-core-latest.schema.json 존재?
• → FAIL: node <workspace>/scripts/extract-core-catalog.mjs

9. plugins.yaml 의 n8nVersion 과 컨테이너 실제 버전 일치

• docker exec oh-my-n8n n8n --version == plugins.yaml 의 n8nVersion 범위?
• → FAIL: Dockerfile.n8n 의 N8N_VERSION 또는 plugins.yaml 정렬 후 /oh-my-n8n:n8n-up --rebuild

출력 형식

oh-my-n8n doctor

[1/9] 워크스페이스          PASS  (~/.oh-my-n8n)
[2/9] 의존성                PASS
[3/9] 커스텀 노드 미러      PASS  (N nodes)
[4/9] 카탈로그 신선도       FAIL  → cd ~/.oh-my-n8n && npm run extract-catalog
[5/9] docker 인스턴스       PASS  (Up 3 hours)
[6/9] 헬스체크              PASS  (200)
[7/9] 컨테이너 마운트       PASS  (12 .node.js)
[8/9] 코어 노드 캐시        PASS  (502 nodes, n8n 2.15.0)
[9/9] 버전 정렬             PASS  (2.15.0)

요약: 1 FAIL — 위 명령 1개 실행 후 재진단.

실행 도구

내부적으로 n8n-ops 에이전트 호출 또는 직접 Bash 실행. 모든 경로는 scripts/lib/workspace.mjs 의 resolveWorkspace() 결과 기준.