설치를 더 쉽게 안내하고 실제 프로젝트에서 확인한 기록 검색·경로 처리 문제를 수정한 패치 릴리스입니다. 기존 기록과 프로젝트 지침을 보존하며, 인자형 설치와 자동화도 계속 지원합니다.
한국어
설치 안내
- 처음 설치할 때 프로젝트·상위 폴더의 배치와 기록이 생성될 위치를 먼저 보여줍니다.
- 여러 저장소는 체크박스, 방향키·번호로 선택합니다. 검색, 다시 탐색, 뒤로 가기와 최종 설정 수정도 지원합니다.
- 권장 항목과 현재 설정을 구분합니다. 단일 선택에서 Enter만 눌러 기본값이 확정되지 않습니다.
q취소 안내와 조작 방법을 목록 위에 표시하고 한국어·영어 문구를 다듬었습니다.info/exclude는 Git 저장소 밖에서도 항목을 표시하고 사용할 수 없는 이유를 설명합니다. 실제 Git 저장소와 worktree를 기준으로 사용 가능 여부를 판단합니다.- 대화형 설치 결과는 선택한 언어로 읽기 쉽게 표시합니다.
--json, 명시적 인자와--yes의 기존 동작은 유지합니다.
오류 수정
- 작업 기록 검색에 README·index·요약문이 섞이는 문제를 수정했습니다. 사용자 지정 작업 기록 폴더에도 적용됩니다.
- Windows에서 경로의 대소문자 때문에 기록 검색이 누락되는 문제를 수정했습니다.
- AST의 보호 폴더 제외를 대소문자 변경으로 우회할 수 없게 했습니다.
- 작업 기록 목록과 월 검색의 날짜 판정을 일치시켰습니다. 날짜가 없는 파일명도 유효한
createdAt메타데이터로 월을 찾으며, 다른 월을 미리 제외하는 동작과 검색 한도는 유지합니다.
검증과 사용
Windows 로컬 테스트 295개와 필수 검사, 실제 터미널의 12개 저장소 선택, 두 기존 저장소의 CLI·SDK MCP 재검증을 완료했습니다. 격리 npm 1.2.1 → 1.2.2 → 1.2.1 설치·복구, 선택 의존성 누락, 배포 문서 링크와 파일 구성을 확인했습니다. 기존 프로젝트 파일과 Git 상태를 보존했습니다. GitHub의 Windows·Ubuntu CI도 모두 통과한 뒤 병합했습니다.
ai-agent-playbook bootstrap
ai-agent-playbook bootstrap --interactive --dry-runGitHub 첨부 압축 파일은 검증한 npm 배포물이며 SHA256SUMS.txt로 확인할 수 있습니다. MCP의 자동 도구 선택, 제품 UI 전체 동작과 전역 설치 갱신은 이 검증과 별개입니다.
English
This patch improves guided setup and fixes record-search and path-handling issues found in existing projects, while preserving records, project instructions and automation interfaces.
- Show folder preparation and the intended record location before creating files. Select repository checkboxes with arrows or numbers; search, rescan, go back and edit settings during final review.
- Separate recommendations from saved settings. Single-choice menus require an explicit selection, and cancellation help appears above the list.
- Keep local
info/excludevisible with an availability reason outside Git. Resolve the actual containing Git worktree, including linked worktrees. - Improve English/Korean menu wording and readable interactive results. Preserve explicit arguments, JSON output and
--yesbehavior. - Exclude guides and summaries consistently from worklog search, including custom folders; fix Windows record-path casing and AST protected-directory case aliases.
- Align monthly search with worklog listing on filename, folder and metadata dates while retaining scan limits and pruning other months.
Validation includes 295 local Windows tests, required checks, a live twelve-repository terminal flow, CLI/SDK MCP checks in two existing repositories, isolated npm upgrade and recovery, optional-dependency failure handling, package contents and documentation links. GitHub Windows and Ubuntu CI also passed before merge. SDK invocation does not establish automatic tool selection in a fresh host or every application UI behavior.
The attached npm archive and checksum file are the verified release artifacts. Updating a global installation and publishing to npm are separate operations.