feat: WorkGraph 선택 조회 및 실측 보고서 공개 (v0.5.5)

[HyeonsangKim]

저장된 계획에서 두 작업만 확인해도 전체 그래프를 반환하던 inspect에 선택 조회를 추가합니다. --task TASK-ID를 반복 지정하면 해당 작업과 전이적 선행 작업, 연결된 기록을 반환하며 전체 검증·소스 변경 감지·릴리스 게이트는 유지합니다.

• Work Planner에 선택 조회 예제를 직접 제시하고 수정용 참조 문서 읽기를 조건부로 변경합니다. 저장 revision도 별도 필드로 반환합니다.
• Core와 Knowledge Wiki manifest를 공동 버전 정책에 맞춰 0.5.5로 올립니다. Wiki 기능 변경은 없습니다.
• README, 릴리스 문서, 한국어 테크리포트와 재현 스크립트를 포함합니다. 대다수 추가 파일은 당시 고정한 합성 입력·스냅샷·실행 로그입니다. 리뷰 시 runtime/skill 변경과 보고서를 먼저 확인할 수 있습니다.

후속 GPT-6 Astra medium 비교는 합성 상태 조회 8개 사례 × 두 조건, 총 16회입니다. 두 조건 모두 정답 8/8이며 총입력 합계는 696,334 → 304,669(-56.2%, 캐시 포함)였습니다. 일반 코딩 성능이나 청구 비용의 개선율이 아닙니다. 후보와 사례가 다른 1차 24회는 별도로 보존하고 합산하지 않습니다.

검증: ./scripts/validate.sh 통과(조회 테스트 14개 포함), 추가 경계 사례 6개 통과, 보관된 두 실험 재채점 결과 동일, 원본 4,533개 파일 해시 일치, 공개 파일의 인증 정보 검사 통과. v0.5.5 Core는 manifest 버전 외에 실측 후보와 동일합니다. 새 버전으로 prepare를 실행해 동일 과제·순서를 생성했으며 추가 모델 호출은 하지 않았습니다.

보고서: docs/scoped-inspect-2026-09-08/report.ko.md
릴리스: docs/RELEASE-v0.5.5-KO.md

[wigtn-contact]

판정: 승인

변경된 파일

• README.md
• docs/RELEASE-v0.5.5-KO.md
• plugins/wigtn-knowledge-wiki/.codex-plugin/plugin.json
• plugins/wigtn-plugins-with-codex/.codex-plugin/plugin.json
• plugins/wigtn-plugins-with-codex/scripts/wigtn.py
• plugins/wigtn-plugins-with-codex/skills/work-planner/{SKILL.md,references/workgraph-contract.md}
• scripts/check-workgraph-inspect.py
• tests/scoped-inspect/{adversarial.py,archive.py,dependency-boundary.py,plot.py,preflight.py,study.py,trace.py}
• docs/scoped-inspect-2026-09-08/ 실측 증거 묶음 (4543개 파일)

확인한 것

• inspect --task는 요청 작업의 전이적 선행 작업과 연결된 기록을 반환하고, dependents는 포함하지 않으며, 선택 밖의 전역 검증·source drift·요약·릴리스 게이트를 유지합니다.
• 알 수 없는 작업 ID는 오류로 종료하고, 잘못된 저장 상태에서는 eligible 작업을 비우며, inspect는 파일을 변경하거나 저장된 검사 명령을 실행하지 않습니다.
• 재현 스크립트와 증거 보관 코드는 고정 입력 해시를 확인하고 인증 파일을 증거 묶음에 복사하지 않습니다. 실측 수치는 합성 상태 조회 범위로 한정되어 있고 일반 코딩 품질/비용 개선으로 과장하지 않습니다.
• 현재 구현과 추가 회귀 테스트를 직접 읽었고, 로컬 python3 scripts/check-workgraph-inspect.py는 14개 테스트 모두 통과했습니다.

남은 문제

• 차단할 동작·계약 위반을 찾지 못했습니다. GitHub diff API는 300개 파일 제한으로 전문을 제공하지 않았지만, 고정된 워크트리의 base..head 로컬 diff와 변경 파일을 확인했습니다.

검증

• 방법: CI
• 명령/체크: gh pr checks 3 --repo wigtn/wigtn-plugins-codex
• 결과: 통과
• 근거: Repository contract — pass (https://github.com/wigtn/wigtn-plugins-codex/actions/runs/34192909503/job/101954457458)

검토한 head SHA: 10f284f9e13b77916cf7768dae59357b3443d4d3

이 리뷰가 도움이 됐으면 👍, 지적이 틀렸으면 👎 를 눌러주세요. 오탐 집계에 씁니다.

[wigtn-contact]

요약 코멘트에 변경 파일, 확인 결과와 검증 근거를 기록했습니다.