P7-7.5 재현 가능한 프로젝트 패키지 만들기¶

# Part 7 대표 프로젝트 패키지의 질문, 입력, 코드, 환경, 실행 명령, 결과 기록을 점검해 재현 가능성을 분류하는 예제입니다.
import csv
from collections import Counter, defaultdict
from pathlib import Path

data_path = Path("docs/assets/part-07/chapter-07/p7-7-reproducibility-items.csv")
rows = list(csv.DictReader(data_path.open(encoding="utf-8")))

not_ready_statuses = {"missing", "partial", "stale"}
critical_categories = {
    "question",
    "input",
    "code",
    "environment",
    "command",
    "result",
    "release_note",
}

packages = defaultdict(list)
for row in rows:
    packages[row["package_id"]].append(row)

def package_state(items):
    required_items = [item for item in items if item["required"] == "yes"]
    not_ready_required = [
        item for item in required_items if item["status"] in not_ready_statuses
    ]
    critical_not_ready = [
        item for item in not_ready_required if item["category"] in critical_categories
    ]
    if critical_not_ready:
        return "재현 불가"
    if not_ready_required:
        return "검토 필요"

    optional_stale = [
        item
        for item in items
        if item["required"] == "no" and item["status"] in not_ready_statuses
    ]
    if optional_stale:
        return "재현 가능, 보강 권장"
    return "재현 가능"

package_records = []
for package_id, items in sorted(packages.items()):
    required_items = [item for item in items if item["required"] == "yes"]
    not_ready_required = [
        item for item in required_items if item["status"] in not_ready_statuses
    ]
    status_counts = Counter(item["status"] for item in items)
    package_records.append({
        "패키지": package_id,
        "전체 항목 수": len(items),
        "필수 항목 수": len(required_items),
        "준비 완료 필수 항목 수": len(required_items) - len(not_ready_required),
        "준비율": round(
            (len(required_items) - len(not_ready_required)) / len(required_items),
            2,
        ),
        "상태": package_state(items),
        "상태 분포": dict(status_counts),
        "먼저 보강할 항목": [
            f"{item['item_id']}:{item['category']}:{item['status']}"
            for item in not_ready_required[:3]
        ],
    })

next_actions = []
for row in rows:
    if row["required"] == "yes" and row["status"] in not_ready_statuses:
        next_actions.append({
            "패키지": row["package_id"],
            "항목": row["item_id"],
            "범주": row["category"],
            "상태": row["status"],
            "다음 조치": row["next_action"],
        })

summary = {
    "패키지 수": len(package_records),
    "재현 가능 패키지 수": sum(
        record["상태"].startswith("재현 가능") for record in package_records
    ),
    "재현 불가 패키지 수": sum(
        record["상태"] == "재현 불가" for record in package_records
    ),
    "필수 보강 항목 수": len(next_actions),
}

print("재현성 점검 요약 =", summary)
print("패키지별 기록 =")
for record in package_records:
    print(record)
print("필수 보강 항목 =")
for action in next_actions:
    print(action)

재현성 점검 요약 = {'패키지 수': 3, '재현 가능 패키지 수': 1, '재현 불가 패키지 수': 2, '필수 보강 항목 수': 5}
패키지별 기록 =
{'패키지': 'agent-ops', '전체 항목 수': 12, '필수 항목 수': 11, '준비 완료 필수 항목 수': 7, '준비율': 0.64, '상태': '재현 불가', '상태 분포': {'ready': 7, 'missing': 3, 'partial': 2}, '먼저 보강할 항목': ['item-04:environment:missing', 'item-05:command:missing', 'item-07:evaluation:partial']}
{'패키지': 'baseline-churn', '전체 항목 수': 12, '필수 항목 수': 11, '준비 완료 필수 항목 수': 11, '준비율': 1.0, '상태': '재현 가능', '상태 분포': {'ready': 12}, '먼저 보강할 항목': []}
{'패키지': 'rag-vector-db', '전체 항목 수': 12, '필수 항목 수': 11, '준비 완료 필수 항목 수': 10, '준비율': 0.91, '상태': '재현 불가', '상태 분포': {'ready': 10, 'partial': 1, 'stale': 1}, '먼저 보강할 항목': ['item-04:environment:partial']}
필수 보강 항목 =
{'패키지': 'rag-vector-db', '항목': 'item-04', '범주': 'environment', '상태': 'partial', '다음 조치': 'requirements와 설치 버전 차이를 점검한다'}
{'패키지': 'agent-ops', '항목': 'item-04', '범주': 'environment', '상태': 'missing', '다음 조치': '표준 라이브러리만 쓰는지 명시한다'}
{'패키지': 'agent-ops', '항목': 'item-05', '범주': 'command', '상태': 'missing', '다음 조치': '본문 코드 블록 재실행 명령을 남긴다'}
{'패키지': 'agent-ops', '항목': 'item-07', '범주': 'evaluation', '상태': 'partial', '다음 조치': '자동 실행 가능과 즉시 보류 기준을 연결한다'}
{'패키지': 'agent-ops', '항목': 'item-12', '범주': 'release_note', '상태': 'missing', '다음 조치': 'P7-6.2 또는 P7-6.3 릴리즈노트 상태를 확인한다'}

프로젝트 패키지:
질문:
입력 파일:
실행 코드 또는 스크립트:
실행 환경:
실행 명령:
결과 요약:
오류 사례:
한계:
다음 조치:
재현 상태:
먼저 보강할 항목: