forge-status

/forge-status

code-forge의 현재 런타임 상태를 회고/진단용 단일 뷰로 보여줍니다. 외부 도구 연동용 JSON surface도 제공 — forge status --json.

[즉시 실행] 아래 절차대로 상태를 출력하세요.

---

사용법

/forge-status              → 사람 읽는 리포트 (상세)
/forge-status --json       → JSON 출력 (forge-glow, CI 연동용)
/forge-status --week       → 최근 7일 quality 추이
/forge-status --reflect    → REFLECT flag 상세

---

Step 1: CLI 호출

플러그인이 제공하는 단일 surface를 호출:

${CLAUDE_PLUGIN_ROOT}/bin/forge status

--json 인자 있으면:

${CLAUDE_PLUGIN_ROOT}/bin/forge status --json

→ JSON 그대로 출력하고 종료. 사람이 호출했어도 --json이면 파이프라인 용도로 가정.

---

Step 2: 상세 섹션 추가

--json이 아닌 경우, bin/forge status 출력 다음에 아래 섹션 보강:

2-1. 최근 quality 이벤트 (있으면)

tail -10 .claude/state/quality.jsonl 2>/dev/null

각 이벤트를 사람 읽는 포맷으로 변환:

[2026-04-14 10:00] eslint   PASS
[2026-04-14 10:00] tsc      FAIL  2 errors
[2026-04-14 10:00] test-trigger  WARN  TC 없음: src/hooks/useFoo.ts

2-2. REFLECT flag 상세 (활성 시)

[ -f .claude/state/reflect.flag ] && cat .claude/state/reflect.flag

→ timestamp, failed_blocks, failed_files 파싱하여 테이블화.

2-3. Notepad 미리보기 (있으면)

if [ -f .claude/state/notepad.md ]; then
  echo "=== Notepad 미리보기 ==="
  head -20 .claude/state/notepad.md
fi

2-4. 최근 decisions (있으면)

if [ -f .claude/state/decisions.md ]; then
  echo "=== 최근 결정 3건 ==="
  grep -A 3 "^## " .claude/state/decisions.md | tail -15
fi

2-5. 사용량 (usage.jsonl)

if [ -f "$HOME/.code-forge/usage.jsonl" ]; then
  echo "=== 이번 주 사용 Top 3 ==="
  # 7일 이내 에이전트/스킬 집계 — POSIX awk (gawk 3-인자 match 금지: macOS에서 무동작이었음)
  # ISO ts는 문자열 비교가 곧 시간 비교
  CUTOFF=$(date -u -v-7d +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u -d '7 days ago' +"%Y-%m-%dT%H:%M:%SZ")
  awk -v c="$CUTOFF" -F'"' '{
    ts=""; name=""
    for (i = 1; i < NF; i++) {
      if ($i == "ts") ts = $(i+2)
      if ($i == "name") name = $(i+2)
    }
    if (ts >= c && name != "") print name
  }' "$HOME/.code-forge/usage.jsonl" | sort | uniq -c | sort -rn | head -3
fi