docs/INSPECTION_REPORT_20260511.md

STEM-BIO-AI 이중 검수 보고서

날짜: 2026-05-11 | 버전: v1.6.8 → v1.7.0 기록 기준 | 상태: 패치 로드맵 확정 (2026-05-12)

---

검수 결과 요약

검수 도구	판정	핵심 지표
AI-SLOP-Detector v3.7.3	clean (exit 0)	결함 파일 4개 / 97개, weighted deficit 19.38
SIDRCE SaaS 1.1.15	REVIEW (Grade A)	Omega 0.7883 (inspect) / 0.9945 (pipeline-insight)

---

AI-SLOP-Detector — 결함 파일 4개

순위	파일	Score	등급	핵심 패턴
1	stem_ai/detector_bio.py	72.12	critical_deficit	11-함수 클론 클러스터, nested_complexity x4
2	stem_ai/detector_contract.py	63.93	inflated_signal	nested_complexity x3 (신규 작성 파일)
3	stem_ai/cli.py	43.45	suspicious	main cc=14, print 함수 5개 클론
4	stem_ai/advisory_contract.py	39.52	suspicious	8-함수 클론 클러스터

CRITICAL 발견 상세

detector_bio.py (score 72.12)

• function_clone_cluster: _looks_like_smiles, _is_obviously_not_smiles, _smiles_context_permits, _is_strong_smiles_variable, _smiles_issues, _stmt_sets_mock_behavior 등 11개 함수 AST JSD < 0.05
• nested_complexity x4:
  • _collect_silent_mock_findings (L260, depth=4, cc=14)
  • _smiles_context_permits (L513, depth=4, cc=13)
  • _stmt_sets_mock_behavior (L624, depth=5, cc=12)
  • _run_trace_metadata (L648, depth=5, cc=13)

detector_contract.py (score 63.93) — 신규 작성 파일

• _readme_claimed_names (L137): depth=8 — 프로젝트 전체 최악 중첩 깊이
• _detect_clinical_zero_default (L44): depth=4, cc=16
• _extract_package_all (L115): depth=5, cc=12

advisory_contract.py (score 39.52)

• function_clone_cluster: cited_finding_ids, _prohibited_claims, _missing_citation_items, _validate_item_list, _offline_reviewer_notes, _offline_inspection_priorities 등 8개 클론

cli.py (score 43.45)

• main (L717): depth=5, cc=14
• function_clone_cluster: _print_full_summary, _print_policy_simulate 등 print 함수 5개

공통 패턴

Pattern ID	Axis	Severity	건수
nested_complexity	quality	CRITICAL	10
function_clone_cluster	structure	CRITICAL	3
god_function	style	high	22
deep_nesting	style	high	8
phantom_import	quality	medium	2 (rdkit, detector_bio.py L826/L837)
lint_escape	quality	medium	3

---

SIDRCE SaaS — 차원별 점수

차원	기호	가중치	pipeline-insight 점수
Integrity	Sigma	0.30	0.9946
Purity	Pi	0.25	1.0000
Stability	Delta	0.25	1.0000
Coherence	Gamma	0.20	0.9806
Omega	Omega	—	0.9945

• inspect 모드 Omega: 0.7883 (10파일 샘플, entropy avg 4.24bit → Delta 억제)
• pipeline-insight 97파일 기준 실질 품질: 0.9945 (A+ 수준)
• 리스크 파일 1개: tmp/backend_build/build_backend.py (DDC=0.50, tmp 경로)
• 24/30 파일 "inconsistent entropy" (모듈 성격 다양성으로 판단)
• vulture 미설치 — dead code 스캔 미완성

---

교차 확인 — 두 도구 일치 항목

이슈	SLOP 판정	SIDRCE 영향
detector_contract.py 구조 복잡도	CRITICAL (depth=8)	Gamma 감산 요인
detector_bio.py 클론 클러스터	CRITICAL	엔트로피 패턴 이상
tmp/ 디렉토리 오염	97→35 파일 부풀림	DDC 리스크 파일 원인

---

v1.7.0 이후 상태

detector_contract.py는 v1.7.0에서 신규 작성되어 CC-1/CC-2/CC-3 탐지가 동작하지만, 검수에서 지적된 구조적 복잡도 문제는 미해결 상태로 다음 패치에 이관.

---

패치 로드맵

v1.7.1 — 구조 부채 1차 해소 (P0) — DONE 2026-05-12

대상: stem_ai/detector_contract.py (commit 22af1f8)

함수	현황	조치	결과
_readme_claimed_names	depth=8	_flush_code_block() 헬퍼 추출	depth 8→3
_detect_clinical_zero_default	cc=16	_collect_candidate_pairs() 추출	cc ~4
_extract_package_all	depth=5, cc=12	_parse_all_assign() 추출	depth 5→2

대상: 설정 .slopconfig.yaml 신규 — tmp/, build/, dist/ 제외

137/137 tests pass

v1.7.2 — 클론 클러스터 해소 (P1)

대상: stem_ai/detector_bio.py

이슈	현황	조치
SMILES 함수 클론 11개	AST JSD < 0.05 (거의 동일)	_SMILES_RULES: list[tuple[str, Callable]] dispatch table로 통합, _apply_smiles_rule() 단일 실행기
nested_complexity x4	_collect_silent_mock_findings cc=14 등	조건 분기 → 전략 함수 추출

대상: pyproject.toml

[project.optional-dependencies]
bio = ["rdkit>=2023.3"]

rdkit phantom import → optional dep 선언 + try/except ImportError 가드로 교체

v1.7.3 — 코드 위생 완성 (P2)

항목	조치
cli.py main cc=14	_handle_scan_cmd(), _handle_policy_cmd() 등 서브핸들러 추출
print 함수 5개 클론	_print_section(title, rows) 공통 렌더러 통합
advisory_contract.py 8-함수 클론	공통 _validate_list_field(key, items, rules) 추출
vulture 설치	pip install vulture + scripts/dead_code_check.sh 추가

---

검수 도구 재실행 기준

버전	기대 목표
v1.7.1	detector_contract.py slop score ≤ 30 (현 63.93)
v1.7.2	detector_bio.py slop score ≤ 35 (현 72.12)
v1.7.3	SIDRCE Omega ≥ 0.85 in inspect 모드 (현 0.7883)

---

AI-SLOP-Detector v3.7.3 + SIDRCE SaaS 1.1.15 | Flamehaven Research | 2026-05-11 패치 로드맵 확정: 2026-05-12