gitifact 0.6.0 → 0.6.2

package/dist/i18n/ko/changelog.md

@@ -1,134 +1,165 @@
-## 0.6.0 - 2026-09-19
-### Added
-- 브라우저가 문서의 ```mermaid 코드 펜스를 다이어그램으로, `> [!NOTE]` 같은 GitHub 알림을 종류가 드러나는 상자로 그립니다. 그리는 코드는 패키지에 함께 담아 외부 서비스를 부르지 않습니다.
-- 브라우저에 문서 검색을 추가했습니다. `Ctrl`(macOS는 `Cmd`)+`K`나 모든 화면 머리의 검색 버튼으로 열고, 기능 명세·요구사항·설계·위키 페이지를 제목과 본문으로 함께 찾아 분류별로 보여 줍니다. 고르면 그 문서가 있는 화면으로 이동합니다.
-- 기능별 요구사항 목록을 설계 여부·참여자로 좁히고 최근 변경순·요구사항 많은 순·이름순으로 정렬할 수 있습니다. 고른 조건은 주소에 남아 기능을 열고 돌아와도 유지됩니다.
-- `gitifact docs writing`을 추가했습니다. 위키 페이지·요구사항·설계에 공통으로 적용하는 문체, 인용과 Alert·다이어그램을 쓰는 기준, AI가 쓴 문장에서 흔한 상투구를 덜어내는 기준을 담습니다. `docs spec`·`docs design`·`docs wiki`가 이 문서를 가리킵니다.
-### Changed
-- 제품 개요가 최근 변경 이력을 본문으로 보여 줍니다. 요약 타일 다섯 개 대신 프로젝트 규모 한 줄과 차트 두 장을 위에 두고, 그 아래에 커밋별 변경 이유와 그 커밋이 건드린 기록을 싣습니다.
-- 브라우저가 불러온 이력을 화면을 옮겨도 유지합니다. 이전에는 다른 메뉴에 다녀올 때마다 불러온 페이지를 전부 다시 읽었습니다. 현재 명세·위키·참여자는 첫 페이지에만 실어 "더 보기"가 같은 내용을 다시 보내지 않습니다.
-- 검색창은 타자가 멈춘 뒤 500ms에 검색합니다. 활동·기능·참여자 화면의 검색창과 문서 검색이 같은 값을 씁니다.
-- 기능 목록의 표에서 모든 행이 같은 값을 갖던 설계 열을 빼고 설계가 없는 기능만 제목 옆에 표시합니다. 요구사항 수에는 가장 많은 기능 대비 막대를 함께 그리고, 모든 행의 높이를 같게 맞췄습니다.
-- GITIFACT 블록의 명령 목록에 `docs writing`이 들어가고, 문서를 쓰기 전에 그 문체를 따르라는 규칙이 늘었습니다. `update` 또는 `init`을 다시 실행하면 갱신됩니다.
-### Removed
-- deprecated였던 `spec prepare`·`spec verify`·`spec commit-plan`·`spec commit-apply`를 삭제했습니다. 0.5.0에서 예고한 일정입니다. 이유 기록과 커밋은 `spec commit` 하나로 합니다.
-
-## 0.5.1 - 2026-09-18
-### Changed
-- `init`이 새 버전이 있는지 확인해 결과의 `update`·`install`에 알립니다. 이미 설치된 이전 버전으로 도입해도 새 버전이 있다는 것을 알 수 있습니다. 확인에 실패해도 초기화는 진행되며 `GITIFACT_NO_UPDATE_CHECK`로 끌 수 있습니다. `init` 출력 계약이 version 5가 되었습니다.
-- 소개 글의 시작 프롬프트가 이미 설치돼 있어도 `npm install -g gitifact@latest`로 최신 버전을 설치하도록 안내합니다.
-- CLI보다 새로운 저장 규약을 쓰는 프로젝트에서는 CLI를 최신 버전으로 올리라고 안내합니다.
-### Fixed
-- 0.4.x로 `init`한 프로젝트에서 0.5.0이 새로 `init`하라고 안내하면서 `init`도 거부해 진행할 수 없던 문제를 고쳤습니다. `.gitifact`에 설정 파일만 있으면 `init`이 새 저장 규약으로 바꾸고 결과에 `replaced`로 표시합니다. 이전 규약의 명세나 기록이 있으면 바꾸지 않고 해야 할 일을 안내합니다.
-
-## 0.5.0 - 2026-09-18
-### Added
-- 프로젝트 위키를 추가했습니다. 기능에 묶이지 않는 제품 설명·구조·규칙을 `.gitifact/wiki/`에 하위 폴더로 자유롭게 두고, 페이지마다 CLI가 발급한 W-ID로 추적합니다. `spec save`의 `create-doc`·`update-doc`·`move-doc`·`delete-doc`으로 저장하고 커밋할 때 변경 이유를 붙입니다.
-- 위키의 `README.md`가 위키 운영 방침입니다. `init`이 처음 도입할 때 아키텍처 결정 기록(ADR)을 쌓는 기본 방침으로 만들고, 고치면 `docs wiki`가 그 내용을 이 프로젝트의 방침으로 보여 줍니다.
-- 이미지·PDF 같은 파일을 `.gitifact/assets/`에 두고 문서에서 상대 경로로 참조할 수 있습니다. `spec working`이 대상 없는 링크, 큰 파일, 권장하지 않는 확장자, 어떤 문서도 참조하지 않는 에셋을 경고합니다.
-- 설계 문서의 frontmatter `sources`에 참고 문서를 적으면 브라우저 설계 탭 위에 목록으로 보입니다.
-- 브라우저에 프로젝트 위키 메뉴를 추가했습니다. 왼쪽 트리와 오른쪽의 폴더 내용 또는 페이지로 된 탐색기입니다.
-- 브라우저가 문서 본문의 상대 링크를 해당 위키 페이지·기능·에셋으로 연결합니다. `.gitifact` 밖의 저장소 파일은 열지 않고 경로를 복사합니다.
-- `init`이 AGENTS.md에 블록을 쓸 때 CLAUDE.md가 없으면 `@AGENTS.md` 한 줄로 된 CLAUDE.md를 만들어 Claude Code도 블록을 읽게 합니다. `update`는 파일을 만들지 않고 없다는 사실만 알립니다.
-### Changed
-- 저장 규약이 schemaVersion 2가 되었습니다. 파일 ID는 frontmatter에 둡니다. 0.4.x로 만든 프로젝트(schemaVersion 1)는 이 버전에서 읽지 않으며 전환 도구도 없습니다. CLI가 이유를 알리고, 새로 `init`해야 합니다.
-- 브라우저가 제품 개요에서 시작합니다. 활동은 `/activity`로 옮겼고, 필터나 선택이 담긴 이전 활동 주소는 같은 조건의 활동 페이지로 이어집니다.
-- 브라우저의 요구사항 메뉴 이름을 기능별 요구사항으로 바꿨습니다.
-- GITIFACT 블록이 요구사항·설계·코드를 바꾸기 전에 `docs wiki`를 확인하고, 위키 운영 방식을 바꾸려면 위키 README를 고치도록 안내합니다. `update` 또는 `init`을 다시 실행하면 갱신됩니다.
-- 명세 지침의 예시에서 제목 뒤의 "요구사항"을 뺐습니다. 명세 제목은 기능 이름만 씁니다.
-- `update` 출력 계약이 version 3이 되었습니다. `agentDocs.missing`에 없는 CLAUDE.md를 알립니다.
-### Removed
-- 제품 문서와 지침 폴더, 브라우저의 지침 메뉴를 없앴습니다. 같은 내용은 프로젝트 위키에 둡니다.
-### Fixed
-- 브라우저 검색창에서 한글이 조합 도중 끊기거나 "ㄱ거검검"처럼 겹쳐 입력되던 문제를 고쳤습니다.
-
-## 0.4.4 - 2026-09-17
-### Added
-- `update --commit`이 블록 안만 바뀐 지침 파일을 `chore(gitifact): refresh GITIFACT block to v<버전>` 메시지로 그 파일만 커밋합니다. 다른 staging은 그대로 남고 훅·서명도 평소대로 실행됩니다. 블록 밖에도 수정이 있거나, 추적하지 않는 파일이거나, Git이 커밋을 거부하면 커밋하지 않고 이유를 알립니다.
-- GITIFACT 블록이 `gitifact` 명령이 없는 환경을 안내합니다. 에이전트는 사용자에게 알리고 동의를 받아 블록에 적힌 버전으로 설치합니다.
-### Changed
-- GITIFACT 블록을 `## Gitifact Guide` 제목, 절 제목, 목록으로 정리하고 끝에 구분선을 넣었습니다. Markdown으로 볼 때 명령 목록이 한 줄로 합쳐지지 않습니다. `update` 또는 `init`을 다시 실행하면 갱신됩니다.
-- 브라우저의 업데이트 안내 문장이 설치 후 `gitifact update --commit`을 실행하도록 안내합니다.
-- `update` 출력 계약이 version 2가 되었습니다. 커밋 결과를 담는 `commit` 필드가 추가됐습니다.
-
-## 0.4.3 - 2026-09-17
-### Fixed
-- 브라우저의 새 버전 안내 창에서 제목과 닫기 버튼이 창 가장자리에 붙어 잘려 보이던 문제를 고쳤습니다.
-- 같은 창에서 복사 버튼이 요청 문장과 겹치던 문제를 고쳤습니다. 복사 버튼은 각 코드 블록의 제목 줄에 표시됩니다.
-
-## 0.4.2 - 2026-09-17
-### Added
-- `spec working`과 `spec changes`가 저장·커밋 입력 파일을 둘 경로(`inputs.save`·`inputs.commit`)를 알려 줍니다. 기본은 운영체제 임시 폴더이고, 그곳에 쓸 수 없는 환경에서는 Git이 무시하는 `.gitifact/tmp/`를 씁니다.
-- 알려 준 경로의 입력으로 `spec save`·`spec commit`이 성공하면 CLI가 입력 파일을 지우고 결과에 `inputRemoved`를 표시합니다. 실패·`--dry-run`·결과가 불확실한 커밋에서는 남깁니다. 이 폴더의 7일 넘은 파일은 조회 때 정리됩니다.
-- `spec save`·`spec commit`이 `--file -`로 표준 입력을 받습니다.
-- `spec working`에 `--stamp`(stamp와 입력 경로만), `--feature <폴더>`(한 기능만), `--ids`(ID·제목·경로만) 옵션을 추가했습니다.
-### Changed
-- GITIFACT 블록과 작업 흐름 문서가 입력 파일을 알려 준 경로에 쓰고 조회 결과를 파일로 남기지 않도록 안내합니다. `update` 또는 `init`을 다시 실행하면 갱신됩니다.
-- 사용자가 요구사항·프로젝트 현황·변경 이력을 보여 달라고 하면 에이전트가 `browser`를 백그라운드로 실행해 URL을 알려 주도록 안내합니다.
-
-## 0.4.1 - 2026-09-17
-### Added
-- 브라우저에 설정 페이지를 추가했습니다. 화면 모드(시스템·라이트·다크)와 색 조합 다섯 가지(스톤, 세이지 & 크림, 올리브 & 웜그레이, 슬레이트 & 블루, 샌드 & 클레이)를 고를 수 있고, 선택은 그 브라우저에만 저장됩니다.
-- 제품 개요에서 제품 문서를 별도의 읽기 페이지로 엽니다.
-### Changed
-- 제품 문서·지침·요구사항·설계·소개 문서를 더 읽기 좋게 다듬었습니다. 본문을 16px로 키우고 문단·코드·표를 같은 폭에 맞췄으며 제목 크기와 간격, 표·인용·링크 모양을 정리했습니다.
-- 코드 블록에 구문 색을 입혔습니다. 기존에는 색이 모두 회색이라 구분되지 않았습니다.
-- 지침 열 보기에서 폴더 행에 문서 수를 표시해 문서 행과 높이를 맞췄습니다.
-- 활동 상세의 변경 내용 박스를 위아래 선만 남겨 단순화했습니다.
-- 사이드 메뉴 하단에는 버전만 표시합니다.
-### Fixed
-- 활동 상세를 스크롤할 때 고정된 제목 위로 본문이 겹쳐 보이던 문제를 고쳤습니다.
-
-## 0.4.0 - 2026-09-17
-### Added
-- 브라우저가 새 버전을 알려 줍니다. 에이전트에게 전달할 업데이트 요청 문장과 npm 전역 설치용 명령을 복사할 수 있습니다. 설치는 자동으로 실행하지 않습니다.
-- 브라우저 사이드 메뉴 하단에 실행 중인 CLI 버전을 표시합니다.
-- 브라우저에 패치노트 페이지를 추가했습니다. 버전별 추가·변경·제거·수정 내역을 최신순으로 보여 줍니다.
-- `update` 명령이 새 버전 여부와 설치 방법을 알려 주고, 프로젝트 지침 파일의 GITIFACT 블록을 현재 버전으로 갱신합니다.
-- `browser --no-update-check` 옵션과 `GITIFACT_NO_UPDATE_CHECK` 환경변수로 새 버전 확인을 끌 수 있습니다.
-### Changed
-- `browser`를 시작할 때 CLI가 npm 레지스트리(registry.npmjs.org)에 최신 버전을 한 번 조회합니다. 프로젝트 정보는 보내지 않으며, 실패해도 브라우저는 그대로 동작합니다.
-- `browser-session` 계약이 version 2가 되어 `cliVersion`과 `update` 필드를 포함합니다.
-- GITIFACT 블록의 명령 목록에 `update`를 추가했습니다. `update` 또는 `init`을 다시 실행하면 갱신됩니다.
-
-## 0.3.2 - 2026-09-17
-### Added
-- 버전별 변경 내역을 패치노트로 함께 배포합니다.
-- `spec changes`·`spec working`·`spec save`·`spec read`·`spec diff` 도움말에 명령 설명을 추가했습니다.
-- 브라우저 소개 페이지에 로고를 보여 주고 소개 글을 새로 정리했습니다.
-### Changed
-- GITIFACT 블록 첫 줄에 언어(`ko`)를 표시합니다. `init`을 다시 실행하면 갱신되며, 이전 형식의 블록도 그대로 읽습니다.
-### Fixed
-- CLI 안내가 구형 JSON 프로젝트용으로 존재하지 않는 `gitifact@0.4.0`을 안내하던 것을 `@tryce/cli@0.4.0`으로 바로잡았습니다.
-
-## 0.3.1 - 2026-09-17
-### Added
-- 브라우저에 제품 개요 대시보드와 Gitifact 소개 페이지를 추가했습니다.
-- 지침 문서를 열 보기로 훑고 미리보기로 읽을 수 있습니다.
-- 헤더에 마지막 조회 시각을, Git 상태 메뉴에 미커밋 변경 표시를 보여 줍니다.
-### Changed
-- 요구사항 메뉴의 이름과 순서를 정리했습니다.
-
-## 0.3.0 - 2026-09-16
-### Added
-- `init`이 AGENTS.md·CLAUDE.md·`.cursorrules` 등 에이전트 지침 파일에 `GITIFACT:START`/`GITIFACT:END` 블록을 쓰고, 다시 실행하면 그 사이만 갱신합니다.
-- `init`에 `--agent`·`--remove-agents`·`--skip-agents` 옵션을 추가했습니다.
-- `docs <topic>` 명령이 번들된 지침 문서 다섯 편(workflow·spec·design·product·commit)을 출력합니다.
-### Changed
-- `project-init` 계약이 version 4가 됐습니다.
-### Removed
-- `skills install`·`skills sync`·`skills remove` 명령과 배포 스킬 파일을 제거했습니다. 0.2.0 스킬 설치본은 자동으로 정리하지 않으므로, 설치한 스킬 파일을 직접 삭제하고 `init`을 다시 실행하세요.
-
-## 0.2.0 - 2026-09-15
-### Added
-- 1920px 이상 화면에서 브라우저의 기본 글자 크기를 키웁니다.
-### Changed
-- 브라우저의 기여자 화면을 참여자 화면으로 바꿨습니다.
-- 기능·참여자 상세를 `/features/<S-ID>`·`/contributors/<이메일>` 경로로 옮겼습니다. 이전 `?feature=`·`?author=` 링크는 리다이렉트하지 않습니다.
-- Git 상태 페이지를 다른 페이지와 같은 구조로 정리했습니다.
-
-## 0.1.0 - 2026-09-15
-### Added
-- `migrate` 명령으로 이전 `@tryce/cli` 저장소를 Gitifact 형식으로 전환합니다. 과거 커밋 기록은 그대로 읽힙니다.
-### Changed
-- Tryce에서 Gitifact로 이름을 바꿨습니다. 패키지는 `gitifact`, 실행 명령은 `gitifact`, 저장 경로는 `.gitifact`, 스킬은 `gitifact-workflow`입니다.
+## 0.6.2 - 2026-09-20
+### Added
+- 기능별 요구사항 목록이 기능 아래에 그 기능의 요구사항을 한 줄씩 보여 줍니다. 누르면 상세의 그 요구사항으로 바로 이동하고 주소가 그 위치를 가리켜, 링크를 공유하거나 북마크해 두면 다시 그 자리에서 열립니다. 목록은 기능 단위로 페이지를 나누어 한 기능의 요구사항이 페이지에 걸쳐 끊기지 않습니다.
+- 요구사항에서 그 요구사항을 설명하는 설계 절로 이동할 수 있습니다. 설계가 절마다 관련 요구사항을 보여 주던 것의 반대 방향입니다.
+### Changed
+- 활동 화면의 한 항목이 커밋 하나가 됐습니다. 변경 이유는 그 이유로 바뀐 기록들 위에 한 번만 적습니다. 한 커밋이 여러 기록을 건드리면 같은 이유가 기록마다 되풀이되던 것을 없앴고, 이유를 한 줄로 자르지 않습니다. 날짜가 바뀌는 자리에는 날짜를 표시합니다.
+- 제품 개요의 "최근 변경 이력"이 "최신 활동"이 되고 활동 화면과 같은 타임라인으로 보입니다. 커밋마다 기록 10개까지 보인 뒤 나머지는 활동으로 잇습니다.
+- 다른 화면에서 특정 요구사항이나 설계 절로 들어오면 그 절의 제목에 형광펜 표시가 남아 어느 것을 보러 왔는지 알 수 있습니다. 절 옆의 세로 줄을 대신합니다.
+- 기능별 요구사항 목록의 정렬이 별도 선택 상자에서 표의 열 머리로 옮겨졌습니다. 기능 이름·요구사항 수·최근 변경 열을 눌러 정렬하고 한 번 더 누르면 방향이 바뀝니다.
+- 왼쪽 메뉴의 로고와 바닥의 버전이 메뉴 항목과 같은 선에서 시작합니다.
+### Fixed
+- 요구사항이나 설계 절을 가리키는 주소를 직접 열었을 때 그 위치로 이동하지 않던 문제를 고쳤습니다.
+- 제품 개요가 이력을 세는 동안 "전체 활동 0건"과 "커밋된 명세 활동이 아직 없습니다"를 보이던 문제를 고쳤습니다. 답이 오기 전에는 불러오는 중임을 보입니다.
+
+## 0.6.1 - 2026-09-19
+### Added
+- 브라우저가 이력을 로컬 색인(`.git/gitifact/index.sqlite`)에 둡니다. 한 번 읽은 커밋은 브라우저를 다시 띄워도 다시 읽지 않고 새 커밋만 더합니다. 작업 폴더와 `git status`에는 나타나지 않으며, 지우거나 손상돼도 다시 만들어집니다.
+- 검색창(`Ctrl`/`Cmd`+`K`)이 지난 변경도 찾습니다. 변경의 제목과 이유로 찾고, 고르면 활동 화면의 그 변경을 엽니다.
+### Changed
+- 활동의 필터와 검색어가 불러온 범위가 아니라 전체 이력에 적용됩니다. 아직 불러오지 않은 오래된 변경도 찾고, 목록 아래에 "전체 N건 중 M건"을 알립니다. 한 번에 변경 50건씩 불러옵니다.
+- 제품 개요의 변경 종류 차트와 21일 막대가 전체 이력을 셉니다. 최근 변경 이력은 커밋마다 기록을 12개까지 보이고 나머지는 "외 N건"으로 활동에 잇습니다.
+- 참여자 상세의 최근 활동이 불러온 범위와 무관하게 그 사람의 최근 변경 10건을 보입니다.
+- 활동의 변경 내용은 항목을 열 때 받아 옵니다. 목록에 없는 변경을 가리키는 링크도 그 변경을 엽니다.
+- 활동 목록을 여러 번 더 불러온 뒤 다른 화면에 다녀와도 빠르게 다시 그립니다. 334건 기준 약 2.9초에서 0.4초로 줄었고, 더보기는 불러온 양과 관계없이 일정합니다.
+- 라이트 모드의 글자와 로고를 한 단계 밝게 하고 로고를 줄였습니다. 제품 개요의 두 차트 카드는 높이가 같습니다.
+- 참여자 아바타를 손으로 그린 얼굴 그림으로 바꿨습니다.
+### Fixed
+- 스톤 외의 색 조합에서 문서의 mermaid 다이어그램이 그려지지 않던 문제를 고쳤습니다.
+- 위키 화면의 로딩 골격이 모양 없이 그려지던 문제를 고쳤습니다. 트리·경로·본문 배치대로 보입니다.
+- 검색창에 입력하는 동안 "검색할 문서가 없습니다" 안내가 깜빡이던 문제를 고쳤습니다. 결과를 기다리는 동안에는 결과 줄 모양의 골격이 보입니다.
+
+## 0.6.0 - 2026-09-19
+### Added
+- 브라우저가 문서의 ```mermaid 코드 펜스를 다이어그램으로, `> [!NOTE]` 같은 GitHub 알림을 종류가 드러나는 상자로 그립니다. 그리는 코드는 패키지에 함께 담아 외부 서비스를 부르지 않습니다.
+- 브라우저에 문서 검색을 추가했습니다. `Ctrl`(macOS는 `Cmd`)+`K`나 모든 화면 머리의 검색 버튼으로 열고, 기능 명세·요구사항·설계·위키 페이지를 제목과 본문으로 함께 찾아 분류별로 보여 줍니다. 고르면 그 문서가 있는 화면으로 이동합니다.
+- 기능별 요구사항 목록을 설계 여부·참여자로 좁히고 최근 변경순·요구사항 많은 순·이름순으로 정렬할 수 있습니다. 고른 조건은 주소에 남아 기능을 열고 돌아와도 유지됩니다.
+- `gitifact docs writing`을 추가했습니다. 위키 페이지·요구사항·설계에 공통으로 적용하는 문체, 인용과 Alert·다이어그램을 쓰는 기준, AI가 쓴 문장에서 흔한 상투구를 덜어내는 기준을 담습니다. `docs spec`·`docs design`·`docs wiki`가 이 문서를 가리킵니다.
+### Changed
+- 제품 개요가 최근 변경 이력을 본문으로 보여 줍니다. 요약 타일 다섯 개 대신 프로젝트 규모 한 줄과 차트 두 장을 위에 두고, 그 아래에 커밋별 변경 이유와 그 커밋이 건드린 기록을 싣습니다.
+- 브라우저가 불러온 이력을 화면을 옮겨도 유지합니다. 이전에는 다른 메뉴에 다녀올 때마다 불러온 페이지를 전부 다시 읽었습니다. 현재 명세·위키·참여자는 첫 페이지에만 실어 "더 보기"가 같은 내용을 다시 보내지 않습니다.
+- 검색창은 타자가 멈춘 뒤 500ms에 검색합니다. 활동·기능·참여자 화면의 검색창과 문서 검색이 같은 값을 씁니다.
+- 기능 목록의 표에서 모든 행이 같은 값을 갖던 설계 열을 빼고 설계가 없는 기능만 제목 옆에 표시합니다. 요구사항 수에는 가장 많은 기능 대비 막대를 함께 그리고, 모든 행의 높이를 같게 맞췄습니다.
+- GITIFACT 블록의 명령 목록에 `docs writing`이 들어가고, 문서를 쓰기 전에 그 문체를 따르라는 규칙이 늘었습니다. `update` 또는 `init`을 다시 실행하면 갱신됩니다.
+### Removed
+- deprecated였던 `spec prepare`·`spec verify`·`spec commit-plan`·`spec commit-apply`를 삭제했습니다. 0.5.0에서 예고한 일정입니다. 이유 기록과 커밋은 `spec commit` 하나로 합니다.
+
+## 0.5.1 - 2026-09-18
+### Changed
+- `init`이 새 버전이 있는지 확인해 결과의 `update`·`install`에 알립니다. 이미 설치된 이전 버전으로 도입해도 새 버전이 있다는 것을 알 수 있습니다. 확인에 실패해도 초기화는 진행되며 `GITIFACT_NO_UPDATE_CHECK`로 끌 수 있습니다. `init` 출력 계약이 version 5가 되었습니다.
+- 소개 글의 시작 프롬프트가 이미 설치돼 있어도 `npm install -g gitifact@latest`로 최신 버전을 설치하도록 안내합니다.
+- CLI보다 새로운 저장 규약을 쓰는 프로젝트에서는 CLI를 최신 버전으로 올리라고 안내합니다.
+### Fixed
+- 0.4.x로 `init`한 프로젝트에서 0.5.0이 새로 `init`하라고 안내하면서 `init`도 거부해 진행할 수 없던 문제를 고쳤습니다. `.gitifact`에 설정 파일만 있으면 `init`이 새 저장 규약으로 바꾸고 결과에 `replaced`로 표시합니다. 이전 규약의 명세나 기록이 있으면 바꾸지 않고 해야 할 일을 안내합니다.
+
+## 0.5.0 - 2026-09-18
+### Added
+- 프로젝트 위키를 추가했습니다. 기능에 묶이지 않는 제품 설명·구조·규칙을 `.gitifact/wiki/`에 하위 폴더로 자유롭게 두고, 페이지마다 CLI가 발급한 W-ID로 추적합니다. `spec save`의 `create-doc`·`update-doc`·`move-doc`·`delete-doc`으로 저장하고 커밋할 때 변경 이유를 붙입니다.
+- 위키의 `README.md`가 위키 운영 방침입니다. `init`이 처음 도입할 때 아키텍처 결정 기록(ADR)을 쌓는 기본 방침으로 만들고, 고치면 `docs wiki`가 그 내용을 이 프로젝트의 방침으로 보여 줍니다.
+- 이미지·PDF 같은 파일을 `.gitifact/assets/`에 두고 문서에서 상대 경로로 참조할 수 있습니다. `spec working`이 대상 없는 링크, 큰 파일, 권장하지 않는 확장자, 어떤 문서도 참조하지 않는 에셋을 경고합니다.
+- 설계 문서의 frontmatter `sources`에 참고 문서를 적으면 브라우저 설계 탭 위에 목록으로 보입니다.
+- 브라우저에 프로젝트 위키 메뉴를 추가했습니다. 왼쪽 트리와 오른쪽의 폴더 내용 또는 페이지로 된 탐색기입니다.
+- 브라우저가 문서 본문의 상대 링크를 해당 위키 페이지·기능·에셋으로 연결합니다. `.gitifact` 밖의 저장소 파일은 열지 않고 경로를 복사합니다.
+- `init`이 AGENTS.md에 블록을 쓸 때 CLAUDE.md가 없으면 `@AGENTS.md` 한 줄로 된 CLAUDE.md를 만들어 Claude Code도 블록을 읽게 합니다. `update`는 파일을 만들지 않고 없다는 사실만 알립니다.
+### Changed
+- 저장 규약이 schemaVersion 2가 되었습니다. 파일 ID는 frontmatter에 둡니다. 0.4.x로 만든 프로젝트(schemaVersion 1)는 이 버전에서 읽지 않으며 전환 도구도 없습니다. CLI가 이유를 알리고, 새로 `init`해야 합니다.
+- 브라우저가 제품 개요에서 시작합니다. 활동은 `/activity`로 옮겼고, 필터나 선택이 담긴 이전 활동 주소는 같은 조건의 활동 페이지로 이어집니다.
+- 브라우저의 요구사항 메뉴 이름을 기능별 요구사항으로 바꿨습니다.
+- GITIFACT 블록이 요구사항·설계·코드를 바꾸기 전에 `docs wiki`를 확인하고, 위키 운영 방식을 바꾸려면 위키 README를 고치도록 안내합니다. `update` 또는 `init`을 다시 실행하면 갱신됩니다.
+- 명세 지침의 예시에서 제목 뒤의 "요구사항"을 뺐습니다. 명세 제목은 기능 이름만 씁니다.
+- `update` 출력 계약이 version 3이 되었습니다. `agentDocs.missing`에 없는 CLAUDE.md를 알립니다.
+### Removed
+- 제품 문서와 지침 폴더, 브라우저의 지침 메뉴를 없앴습니다. 같은 내용은 프로젝트 위키에 둡니다.
+### Fixed
+- 브라우저 검색창에서 한글이 조합 도중 끊기거나 "ㄱ거검검"처럼 겹쳐 입력되던 문제를 고쳤습니다.
+
+## 0.4.4 - 2026-09-17
+### Added
+- `update --commit`이 블록 안만 바뀐 지침 파일을 `chore(gitifact): refresh GITIFACT block to v<버전>` 메시지로 그 파일만 커밋합니다. 다른 staging은 그대로 남고 훅·서명도 평소대로 실행됩니다. 블록 밖에도 수정이 있거나, 추적하지 않는 파일이거나, Git이 커밋을 거부하면 커밋하지 않고 이유를 알립니다.
+- GITIFACT 블록이 `gitifact` 명령이 없는 환경을 안내합니다. 에이전트는 사용자에게 알리고 동의를 받아 블록에 적힌 버전으로 설치합니다.
+### Changed
+- GITIFACT 블록을 `## Gitifact Guide` 제목, 절 제목, 목록으로 정리하고 끝에 구분선을 넣었습니다. Markdown으로 볼 때 명령 목록이 한 줄로 합쳐지지 않습니다. `update` 또는 `init`을 다시 실행하면 갱신됩니다.
+- 브라우저의 업데이트 안내 문장이 설치 후 `gitifact update --commit`을 실행하도록 안내합니다.
+- `update` 출력 계약이 version 2가 되었습니다. 커밋 결과를 담는 `commit` 필드가 추가됐습니다.
+
+## 0.4.3 - 2026-09-17
+### Fixed
+- 브라우저의 새 버전 안내 창에서 제목과 닫기 버튼이 창 가장자리에 붙어 잘려 보이던 문제를 고쳤습니다.
+- 같은 창에서 복사 버튼이 요청 문장과 겹치던 문제를 고쳤습니다. 복사 버튼은 각 코드 블록의 제목 줄에 표시됩니다.
+
+## 0.4.2 - 2026-09-17
+### Added
+- `spec working`과 `spec changes`가 저장·커밋 입력 파일을 둘 경로(`inputs.save`·`inputs.commit`)를 알려 줍니다. 기본은 운영체제 임시 폴더이고, 그곳에 쓸 수 없는 환경에서는 Git이 무시하는 `.gitifact/tmp/`를 씁니다.
+- 알려 준 경로의 입력으로 `spec save`·`spec commit`이 성공하면 CLI가 입력 파일을 지우고 결과에 `inputRemoved`를 표시합니다. 실패·`--dry-run`·결과가 불확실한 커밋에서는 남깁니다. 이 폴더의 7일 넘은 파일은 조회 때 정리됩니다.
+- `spec save`·`spec commit`이 `--file -`로 표준 입력을 받습니다.
+- `spec working`에 `--stamp`(stamp와 입력 경로만), `--feature <폴더>`(한 기능만), `--ids`(ID·제목·경로만) 옵션을 추가했습니다.
+### Changed
+- GITIFACT 블록과 작업 흐름 문서가 입력 파일을 알려 준 경로에 쓰고 조회 결과를 파일로 남기지 않도록 안내합니다. `update` 또는 `init`을 다시 실행하면 갱신됩니다.
+- 사용자가 요구사항·프로젝트 현황·변경 이력을 보여 달라고 하면 에이전트가 `browser`를 백그라운드로 실행해 URL을 알려 주도록 안내합니다.
+
+## 0.4.1 - 2026-09-17
+### Added
+- 브라우저에 설정 페이지를 추가했습니다. 화면 모드(시스템·라이트·다크)와 색 조합 다섯 가지(스톤, 세이지 & 크림, 올리브 & 웜그레이, 슬레이트 & 블루, 샌드 & 클레이)를 고를 수 있고, 선택은 그 브라우저에만 저장됩니다.
+- 제품 개요에서 제품 문서를 별도의 읽기 페이지로 엽니다.
+### Changed
+- 제품 문서·지침·요구사항·설계·소개 문서를 더 읽기 좋게 다듬었습니다. 본문을 16px로 키우고 문단·코드·표를 같은 폭에 맞췄으며 제목 크기와 간격, 표·인용·링크 모양을 정리했습니다.
+- 코드 블록에 구문 색을 입혔습니다. 기존에는 색이 모두 회색이라 구분되지 않았습니다.
+- 지침 열 보기에서 폴더 행에 문서 수를 표시해 문서 행과 높이를 맞췄습니다.
+- 활동 상세의 변경 내용 박스를 위아래 선만 남겨 단순화했습니다.
+- 사이드 메뉴 하단에는 버전만 표시합니다.
+### Fixed
+- 활동 상세를 스크롤할 때 고정된 제목 위로 본문이 겹쳐 보이던 문제를 고쳤습니다.
+
+## 0.4.0 - 2026-09-17
+### Added
+- 브라우저가 새 버전을 알려 줍니다. 에이전트에게 전달할 업데이트 요청 문장과 npm 전역 설치용 명령을 복사할 수 있습니다. 설치는 자동으로 실행하지 않습니다.
+- 브라우저 사이드 메뉴 하단에 실행 중인 CLI 버전을 표시합니다.
+- 브라우저에 패치노트 페이지를 추가했습니다. 버전별 추가·변경·제거·수정 내역을 최신순으로 보여 줍니다.
+- `update` 명령이 새 버전 여부와 설치 방법을 알려 주고, 프로젝트 지침 파일의 GITIFACT 블록을 현재 버전으로 갱신합니다.
+- `browser --no-update-check` 옵션과 `GITIFACT_NO_UPDATE_CHECK` 환경변수로 새 버전 확인을 끌 수 있습니다.
+### Changed
+- `browser`를 시작할 때 CLI가 npm 레지스트리(registry.npmjs.org)에 최신 버전을 한 번 조회합니다. 프로젝트 정보는 보내지 않으며, 실패해도 브라우저는 그대로 동작합니다.
+- `browser-session` 계약이 version 2가 되어 `cliVersion`과 `update` 필드를 포함합니다.
+- GITIFACT 블록의 명령 목록에 `update`를 추가했습니다. `update` 또는 `init`을 다시 실행하면 갱신됩니다.
+
+## 0.3.2 - 2026-09-17
+### Added
+- 버전별 변경 내역을 패치노트로 함께 배포합니다.
+- `spec changes`·`spec working`·`spec save`·`spec read`·`spec diff` 도움말에 명령 설명을 추가했습니다.
+- 브라우저 소개 페이지에 로고를 보여 주고 소개 글을 새로 정리했습니다.
+### Changed
+- GITIFACT 블록 첫 줄에 언어(`ko`)를 표시합니다. `init`을 다시 실행하면 갱신되며, 이전 형식의 블록도 그대로 읽습니다.
+### Fixed
+- CLI 안내가 구형 JSON 프로젝트용으로 존재하지 않는 `gitifact@0.4.0`을 안내하던 것을 `@tryce/cli@0.4.0`으로 바로잡았습니다.
+
+## 0.3.1 - 2026-09-17
+### Added
+- 브라우저에 제품 개요 대시보드와 Gitifact 소개 페이지를 추가했습니다.
+- 지침 문서를 열 보기로 훑고 미리보기로 읽을 수 있습니다.
+- 헤더에 마지막 조회 시각을, Git 상태 메뉴에 미커밋 변경 표시를 보여 줍니다.
+### Changed
+- 요구사항 메뉴의 이름과 순서를 정리했습니다.
+
+## 0.3.0 - 2026-09-16
+### Added
+- `init`이 AGENTS.md·CLAUDE.md·`.cursorrules` 등 에이전트 지침 파일에 `GITIFACT:START`/`GITIFACT:END` 블록을 쓰고, 다시 실행하면 그 사이만 갱신합니다.
+- `init`에 `--agent`·`--remove-agents`·`--skip-agents` 옵션을 추가했습니다.
+- `docs <topic>` 명령이 번들된 지침 문서 다섯 편(workflow·spec·design·product·commit)을 출력합니다.
+### Changed
+- `project-init` 계약이 version 4가 됐습니다.
+### Removed
+- `skills install`·`skills sync`·`skills remove` 명령과 배포 스킬 파일을 제거했습니다. 0.2.0 스킬 설치본은 자동으로 정리하지 않으므로, 설치한 스킬 파일을 직접 삭제하고 `init`을 다시 실행하세요.
+
+## 0.2.0 - 2026-09-15
+### Added
+- 1920px 이상 화면에서 브라우저의 기본 글자 크기를 키웁니다.
+### Changed
+- 브라우저의 기여자 화면을 참여자 화면으로 바꿨습니다.
+- 기능·참여자 상세를 `/features/<S-ID>`·`/contributors/<이메일>` 경로로 옮겼습니다. 이전 `?feature=`·`?author=` 링크는 리다이렉트하지 않습니다.
+- Git 상태 페이지를 다른 페이지와 같은 구조로 정리했습니다.
+
+## 0.1.0 - 2026-09-15
+### Added
+- `migrate` 명령으로 이전 `@tryce/cli` 저장소를 Gitifact 형식으로 전환합니다. 과거 커밋 기록은 그대로 읽힙니다.
+### Changed
+- Tryce에서 Gitifact로 이름을 바꿨습니다. 패키지는 `gitifact`, 실행 명령은 `gitifact`, 저장 경로는 `.gitifact`, 스킬은 `gitifact-workflow`입니다.