zihoAutoResearch v0.3.0

에이전트에서 바로 시작하기

v0.3.0은 CLI를 유지하면서 Codex·Claude Code 스킬 설치와 프로젝트 연결을 쉽게 만듭니다.

• zar skill install --agent codex|claude: 기본 프로젝트 범위로 스킬 발견 경로에 설치합니다.
• --scope user로 사용자 범위를 선택하고 --dry-run으로 경로를 먼저 확인할 수 있습니다.
• zar skill guidance --skill-dir <폴더>로 기존 AGENTS.md에 병합할 문구를 Markdown/JSON으로 출력합니다.
• 기존 스킬·프로젝트 지침·실험 기록은 덮어쓰지 않습니다. 기존 --dest 추출도 유지합니다.

설치

uv tool install 'ziho-autoresearch==0.3.0'
zar skill install --agent codex --project /path/to/ml-project
# Claude Code 사용자는 --agent claude

이전 고정 버전 또는 로컬 소스 설치에서 전환할 때는 uv tool install --force 'ziho-autoresearch==0.3.0'을 사용하세요. 이미 설치한 스킬은 자동 갱신되지 않습니다. 설치·업데이트 안내를 확인하세요. 2026-10-15 (KST) GitHub와 PyPI v0.3.0 공개를 완료했습니다. 공개 PyPI에서 캐시 없는 별도 uv 환경 설치와 스킬 추출·Codex/Claude 설치·연결 문구·기존 파일 보존 검증을 통과했습니다. GitHub와 PyPI의 wheel/sdist SHA-256이 일치합니다.

검증과 범위

• 232개 단위 테스트, 문서 계약, wheel/sdist 격리 설치 및 모의 실험·중단/재개 검증.
• Codex CLI 0.160.1 / Claude Code 2.1.285 로컬 프로젝트에서 스킬 인식·호출과 help/status 실행 확인. 실행 전후 프로젝트 파일 해시 동일.
• 실제 ML 품질·사용자 범위 인식·데스크톱 UI·클라우드 환경은 위 실사용 검증 범위에 포함하지 않습니다.

Python 3.11 이상, 런타임 외부 의존성 없음, MIT 라이선스. 첨부 배포 파일은 SHA256SUMS와 함께 확인하세요.

변경: #31, #32 · 배포 준비: #33

발행 근거: 태그 릴리스 검증, PyPI 검증·업로드. 변경 내역의 2026-10-14는 배포 준비일이며 공개일은 2026-10-15 (KST)입니다.

v0.2.1

v0.2.1

사용자 온보딩과 공개 배포 파일 정리를 위한 패치 버전입니다. CLI의 실험 기록 동작은 유지합니다.

• README를 설치 → 초기화 → 스킬 추출 → 중단·재개 순서로 정리했습니다.
• 내부 작업 기록은 로컬 전용으로 전환하고 소스 배포본에서 제외했습니다.
• 로컬 환경 파일과 macOS 메타데이터의 우발적 포함을 방지합니다.
• 설치: uv tool install 'ziho-autoresearch==0.2.1'
• 스킬 추출: zar skill install --dest ./ziho-autoresearch-skill-0.2.1 --json

검증

PR #29의 독립 리뷰, 217개 로컬 테스트, 문서 계약, wheel/sdist 설치·스킬·기록·중단·재개 검증을 수행했습니다. GitHub의 PR·머지 후 CI를 통과했습니다. 배포 파일 해시는 첨부 SHA256SUMS로 확인할 수 있습니다. PyPI 업로드 실행이 성공했습니다. 실제 PyPI 파일 해시는 GitHub 첨부와 일치하며, 새 격리 환경의 uv 설치·CLI 조회·전체 스킬 바이트 비교·덮어쓰기 거절 검증을 통과했습니다. wheel과 소스 배포본 모두 내부 작업 기록·환경 파일·macOS 메타데이터가 없습니다.

과거 이력과 파일

공개 브랜치·태그 이력을 정리했으므로 기존 clone의 오래된 브랜치를 다시 push하지 마세요. 필요한 작업을 보존한 뒤 새로 clone하는 것이 안전합니다. GitHub의 v0.1.0·v0.1.1·v0.2.0 소스 첨부 파일은 회수했고, 원본 wheel은 유지했습니다. 이전 릴리스를 재빌드·재업로드하지 않습니다. GitHub 관리 PR 참조와 캐시, 외부 다운로드 사본은 별도 정리 대상이며 완전 회수를 보장하지 않습니다.

PyPI의 v0.2.0 소스 압축파일은 소유자의 확인 후 삭제했습니다. 기존 v0.2.0 wheel은 유지합니다. v0.2.0 소스 파일을 직접 지정한 설치는 v0.2.1로 변경해야 합니다. GitHub 관리 PR 참조와 캐시 정리 요청은 지원팀에 접수했으며 처리 결과를 기다리고 있습니다. 완전 삭제가 확인된 상태는 아닙니다.

zihoAutoResearch v0.2.0

Privacy cleanup (2026-10-13): the attached source distribution was withdrawn because it included internal work journals. The original wheel is unchanged; SHA256SUMS now covers only that retained wheel. Historical Git refs were rewritten to remove personal email metadata and internal journals. Do not retry publishing this historical release. Use the clean v0.2.1 source distribution. Old downloaded copies cannot be recalled.

v0.2.0

GitHub와 PyPI에 공개된 릴리스입니다. 2026-10-13 KST에 실제 PyPI 설치와 스킬 추출까지 확인했습니다.

변경 사항

• CLI wheel에 canonical 연구 스킬과 references를 포함합니다. zar skill install --dest <새 폴더>로 프로젝트 초기화 없이 추출하며 기존 경로를 덮어쓰지 않습니다.
• uv 설치·업데이트·버전 고정 안내와 PyPI Trusted Publishing 자동화를 제공합니다.
• 깊은 parent/baseline 계보 검증의 반복 작업을 줄였습니다. 합성 10,000개 기록 측정에서 status 6.578→0.994초, context 7.808→1.405초, check 6.790→0.933초, lineage 8.402→0.948초였습니다. 특정 측정 환경의 결과이며 일반적 성능 보장이 아닙니다. 전체 이력 로딩과 메모리 상한은 바꾸지 않았습니다.

설치

Python 3.11 이상, 런타임 외부 의존성 없음, MIT 라이선스입니다. 첨부된 wheel/sdist와 SHA256SUMS를 내려받아 체크섬을 검증한 뒤 설치합니다.

uv tool install ./ziho_autoresearch-0.2.0-py3-none-any.whl
zar --help
zar skill install --dest ./ziho-autoresearch-skill-0.2.0 --json

스킬 출력 경로는 기존 상위 디렉터리 아래의 새 폴더여야 합니다. 스킬 파일 추출은 에이전트 자동 등록이 아닙니다. PyPI에서도 uv tool install ziho-autoresearch로 설치할 수 있습니다.

검증과 제한

최종 dev CI 38192189206와 태그 릴리스 워크플로 38192330996가 모두 통과했습니다. 태그 커밋은 2eae0ac8469ed39129a75eff0892e9df8bf28235입니다. 다운로드한 파일 3개의 SHA256SUMS/API digest 일치, 태그 소스와 배포 바이트 일치, 메타데이터/MIT/문서, 스킬 추출·원본 보존, 설치 합성 시나리오 7개 및 격리 uv 설치가 모두 통과했습니다. 합성 검증은 실제 모델 품질·학습 비용 절감을 입증하지 않습니다. 배포 실행 38403802017에서 OIDC 업로드가 성공했습니다. PyPI 배포 파일 해시가 기존 GitHub 파일과 일치하고, 격리 uv 설치·전체 스킬 추출·덮어쓰기 거부를 검증했습니다.

GitHub 공개 후 PyPI 워크플로가 첨부 파일을 재검증하고 pypi 환경의 승인 대기에 진입합니다. 환경 승인과 PyPI 업로드 성공은 GitHub 릴리스 공개와 별도입니다.

v0.1.1

Privacy cleanup (2026-10-13): the attached source distribution was withdrawn because it included internal work journals. The original wheel is unchanged; SHA256SUMS now covers only that retained wheel. Historical Git refs were rewritten to remove personal email metadata and internal journals. Do not retry publishing this historical release. Use the clean v0.2.1 source distribution. Old downloaded copies cannot be recalled.

v0.1.1

처음 설치한 사용자가 기록·중단·재개 절차를 따라갈 수 있도록 안내와 설치 검증을 보완했습니다. 공개 v0.1.0의 문서와 배포본만 사용한 독립 검증에서 런타임 결함은 발견하지 않았으며, 기존 기록 형식과 CLI 실행 정책은 변경하지 않았습니다.

변경 사항

• 초안 폴더 생성 단계를 명시하고 memory/candidate 근거 조회 설명을 보완했습니다.
• 설치부터 unknown 상태 해소, 근거 경고 확인과 hold까지 연결한 안내를 추가했습니다.
• full/full 및 full/proxy의 별도 프로세스 prepare/resume 시나리오를 패키지 검증에 포함했습니다.

설치

Python 3.11 이상이 필요하며 런타임 외부 의존성은 없습니다. MIT 라이선스입니다.

1. 이 릴리스의 wheel, 소스 배포본, SHA256SUMS를 함께 내려받아 두 배포 파일의 SHA-256을 확인합니다.
2. 가상환경에서 python -m pip install --no-index --no-deps ./ziho_autoresearch-0.1.1-py3-none-any.whl을 실행합니다.
3. zar --help로 CLI를 확인합니다. 스킬은 소스 배포본의 skills/ziho-autoresearch/ 전체 폴더를 사용합니다. wheel은 스킬을 자동 등록하지 않습니다.
4. 소스 배포본의 docs/first-run-and-resume.md를 따라 기록·재개 절차를 확인할 수 있습니다.

검증과 한계

• 최종 dev 커밋 a00e9411e25e36aac4f6539ab89fc5219164e77c과 태그 v0.1.1 일치.
• 태그 기준 CI·릴리스 워크플로 통과: 플랫폼별 계약 테스트 196개(지원하지 않는 POSIX 전용 사례는 Windows에서 명시적 skip), 문서·패키지 검사.
• 초안 첨부 파일을 다시 내려받아 SHA256SUMS와 일치 확인. 소스 62개 경로와 wheel 런타임 19개 파일이 태그와 일치.
• 내려받은 wheel의 격리 설치에서 메타데이터·MIT·문서 검사 및 합성 시나리오 7개 통과. 실제 학습은 실행하지 않음.

합성 시나리오는 실제 ML 품질·비용 절감·프로세스 강제 종료 복구를 입증하지 않습니다. CLI는 학습, LLM 호출, 코드 복구 또는 외부 제출을 실행하지 않습니다.

zihoAutoResearch v0.1.0

Privacy cleanup (2026-10-13): the attached source distribution was withdrawn because it included internal work journals. The original wheel is unchanged; SHA256SUMS now covers only that retained wheel. Historical Git refs were rewritten to remove personal email metadata and internal journals. Do not retry publishing this historical release. Use the clean v0.2.1 source distribution. Old downloaded copies cannot be recalled.

zihoAutoResearch v0.1.0

기존 코딩 에이전트가 ML 프로젝트를 점검하고 실험 근거를 기록·비교·재개하도록 돕는 첫 배포입니다. 공개 전 검증을 완료한 첫 정식 릴리스입니다.

포함 기능

• 프로젝트 초기화, 설정, 상태 및 기록/참조/근거 검사
• 실험 계획·결과·비교·판정과 원본 보존 정정, Git 코드 식별자 연결
• 점검·관측된 외부 제출 결과·산출물 연결
• 실패 기억, 후보 선택 근거·예측·관측·보류 이력
• 제한된 context, 근거 원문 조회, JSON/Mermaid 실험 계보, Markdown 보고서
• 에이전트용 연구 스킬·템플릿과 합성 예제

첨부 파일과 설치

• ziho_autoresearch-0.1.0-py3-none-any.whl: CLI와 program 템플릿, 메타데이터, MIT LICENSE
• ziho_autoresearch-0.1.0.tar.gz: 소스·스킬/references·문서·예제·CHANGELOG·LICENSE
• SHA256SUMS: 위 두 파일의 SHA-256

Python 3.11 이상이 필요하며 런타임 외부 의존성은 없습니다. Git 연결 명령과 계보 모의 예제에는 Git이 필요합니다. 가상환경을 활성화한 뒤 내려받은 wheel을 설치하세요.

python -m pip install --no-index --no-deps ./ziho_autoresearch-0.1.0-py3-none-any.whl
zar --help

wheel은 스킬을 에이전트에 자동 설치하지 않습니다. 첨부된 소스 배포본을 압축 해제하고 skills/ziho-autoresearch/ 전체를 보관한 뒤 에이전트에 SKILL.md 경로를 지정하세요. GitHub 자동 Source code 압축파일과 빌드된 소스 배포본을 구분하세요.

설치·체크섬 확인 안내 · 변경 내역 · MIT License

범위

CLI는 학습·LLM 호출·코드 복구·외부 제출을 실행하지 않습니다. 합성 검증은 실제 ML 유효성·비용 절감이나 과거 실행의 진실성을 입증하지 않습니다. 기록 로딩과 전체 report/lineage 출력은 전체 이력을 사용합니다. 첫 배포 채널은 GitHub이며 PyPI 업로드는 수행하지 않았습니다.

공개 전 검증 결과

• 태그 대상: 5942ed657d2f9d74ecc9c8c87f5be254d2485e62
• 최종 dev CI 및 태그 릴리스 워크플로 성공
• 초안에 첨부된 실제 파일 다운로드 후 SHA256SUMS 일치 확인
• wheel/sdist 메타데이터·MIT LICENSE·README 및 문서 포함 확인
• 태그의 소스 54개 경로와 소스 배포본 바이트 일치, wheel 런타임 코드 일치 확인
• 내려받은 wheel 격리 설치 후 합성 시나리오 5개 통과

파일	SHA-256
ziho_autoresearch-0.1.0-py3-none-any.whl	f7a961f86a3342ec04451056b76fe4edb9a2f100b3872dd6fe64b3caf2a056ad
ziho_autoresearch-0.1.0.tar.gz	1777f1fd6bff116e54e1c775b7376ab4a61fae0fdecc27d0cd6e7babad4c5515

유지관리자의 승인으로 GitHub Release에 공개했습니다. PyPI 업로드는 수행하지 않았습니다.