gitifact 0.6.2 → 0.7.1

package/dist/i18n/ko/block.md

@@ -2,11 +2,12 @@
 
 gitifact v{version} · {language} · 저장 규약 schemaVersion 2
 
-CLI: 모든 명령은 `gitifact <cmd>`로 실행한다. 프로젝트 지침이 다른 실행 방법을 지정하면 그것을 따른다.
+CLI: 기본 실행은 `npx --yes gitifact@{version} <cmd>`다. 아래 `gitifact`는 이 실행 방법을 뜻한다. 프로젝트가 로컬 설치본이나 전역 명령 등 다른 실행 방법을 지정하면 그것을 우선한다.
 
 ### 시작할 때
 
-- `gitifact` 명령이 없으면 이 프로젝트에 참여하는 데 필요한 CLI가 설치되지 않은 것이다. 사용자에게 알리고 동의를 받아 `npm install -g gitifact@{version}`으로 설치한 뒤 진행한다. 설치하지 못하면 명세 저장·커밋을 추측으로 대신하지 않는다.
+- 전역 설치는 필수가 아니다. 지정 버전의 npx 실행은 같은 버전의 프로젝트 설치본을 사용하고, 없으면 npm 캐시에 받아 실행한다. 실행 권한이나 다운로드가 막히면 필요한 승인을 요청하고 원인을 알린다. CLI 실행 없이 명세 저장·커밋을 대신하거나 완료했다고 보고하지 않는다.
+- 새 세션에서 한 번 `gitifact update --check`로 지정 버전보다 새 버전이 있는지 확인한다. `available`이면 사용자에게 업데이트할지 묻고, 동의한 경우에만 안내된 새 버전으로 `update`를 실행한다. 거절·확인 실패·조회 비활성화 시에는 지정 버전으로 계속하며 같은 세션에서 다시 묻지 않는다. 갱신 후에는 블록을 다시 읽고 새 버전을 사용한다. 커밋·푸시는 별도 권한을 따른다.
 - `gitifact spec working`으로 위키·기능 명세·경고를 읽고 git status와 기존 staging을 확인한다.
 - 이 블록은 요약이다. 상세 형식은 `gitifact docs <topic>`으로 읽고 기억으로 채우지 않는다.
 
@@ -27,14 +28,13 @@ CLI: 모든 명령은 `gitifact <cmd>`로 실행한다. 프로젝트 지침이
 - 새 기능은 requirements.md와 design.md를 함께 정리한다(`gitifact docs design`). 요구사항만 요청받으면 따른다.
 - 요구사항·설계·코드를 바꾸기 전에 `gitifact docs wiki`를 확인하고 그 운영 방침에 따라 관련 위키 페이지를 읽는다.
 - 이 프로젝트에 맞게 위키 운영 방식을 바꾸려면 `.gitifact/wiki/README.md`를 `spec save`로 고친다. 그 내용이 `docs wiki`의 운영 방침이 된다.
-- 위키·요구사항·설계 본문을 쓰기 전에 `gitifact docs writing`의 문체를 따른다.
+- 위키·요구사항·설계 본문을 쓰기 전에 `gitifact docs writing`의 문체를 따른다. 문서는 CLI 표시 언어와 무관하게 프로젝트의 언어로 쓴다.
 - 커밋 요청을 받으면 `gitifact docs commit`을 읽고 명세·이유·코드·테스트를 함께 커밋한다.
 - 자동 기록은 커밋 권한이 아니다. 사용자 요청이나 명시적 프로젝트 정책이 있을 때만 커밋하고 푸시는 별도 요청을 따른다.
 - 불명확한 제품 동작만 질문하고 독립적인 작업은 진행한다. 기존 기능 전체 도출은 요청받았을 때 한다.
 - SELF-CHECK: save·commit 입력을 만들기 전에 해당 docs를 다시 읽고 형식을 대조한다. 확실하지 않으면 추측하지 말고 `gitifact docs <topic>`을 실행한다.
 - save·commit 입력 JSON은 `spec working`이 알려 준 inputs 경로에 쓴다. 성공하면 CLI가 지운다. 조회 결과와 docs 출력은 파일로 저장하지 않고 필요할 때 다시 실행한다.
 - 사용자가 요구사항·프로젝트 현황·변경 이력을 보여 달라고 하면 `gitifact browser`를 백그라운드로 실행하고 출력된 URL을 알려 준다. 채팅 요약으로 대신하지 않는다.
-
 ### 명령
 
 - `docs <topic>`: {topics}
@@ -42,7 +42,7 @@ CLI: 모든 명령은 `gitifact <cmd>`로 실행한다. 프로젝트 지침이
 - `spec save --file <json|->`: 요구사항·설계·위키 저장
 - `spec commit --file <json|->`: 변경 이유 기록과 커밋을 한 번에
 - `browser`: 읽기 전용 브라우저 서버 실행, URL 출력 후 계속 실행
-- `update [--commit]`: 새 버전 확인과 설치 안내, 이 블록을 현재 버전으로 갱신. `--commit`은 블록만 바뀐 파일을 고정 메시지로 커밋한다
+- `update [--check | --commit]`: `--check`는 읽기 전용 버전 확인. 옵션 없이는 이 블록을 실행 버전으로 갱신하며 `--commit`은 블록만 바뀐 파일을 고정 메시지로 커밋한다
 - `init`: 처음 도입할 때 설정과 이 블록을 만든다
 
 ---

package/dist/i18n/ko/changelog.md

@@ -1,3 +1,23 @@
+## 0.7.1 - 2026-09-21
+### Added
+- 에이전트가 새 세션에서 업데이트를 확인하고 사용자 동의 후 지침을 갱신하도록 안내합니다. 직접 확인할 때는 파일을 바꾸지 않는 `update --check`를 사용할 수 있습니다.
+### Changed
+- 전역 설치 없이 npx로 시작하도록 안내합니다. 에이전트 지침은 실행 버전을 고정하고, README와 시작하기의 일상 명령은 `npx gitifact`로 간단히 표시합니다.
+### Removed
+- 브라우저의 업데이트 알림과 서버의 새 버전 조회를 제거했습니다. 현재 버전과 패치노트는 계속 확인할 수 있습니다. `browser --no-update-check` 옵션도 제거했습니다.
+### Fixed
+- 병합된 작업이 머지 담당자의 활동으로 표시되던 문제를 고쳤습니다. 원본 작성자와 변경 이유를 유지하고 단순 병합의 중복 집계를 제외합니다. 병합 중 추가로 수정한 기록은 병합 커밋에 남깁니다. 기존 이력 색인은 자동으로 다시 생성됩니다.
+- 페이지 이동 버튼이 있는 긴 기능별 요구사항 목록에서 스크롤하면 프로젝트명·검색·새로고침 헤더가 사라지던 문제를 고쳤습니다.
+
+## 0.7.0 - 2026-09-20
+### Added
+- 사이드바 하단의 GitHub 링크로 제품 저장소를 새 탭에서 열 수 있습니다.
+- 브라우저와 CLI에 한국어·영어를 지원합니다. 브라우저 설정에서 언어를 고르거나 CLI의 `--lang ko`·`--lang en` 옵션으로 지정할 수 있습니다. 지원하지 않는 환경 언어는 영어로 표시합니다.
+- 소개 아래에 시작하기 페이지를 추가했습니다. 설치, 개발, 위키 구성, 기록 확인과 CLI 명령을 안내합니다.
+### Changed
+- 저장소와 npm README의 기본 언어를 영어로 바꾸고 한국어 문서 링크를 제공합니다.
+- 기존 에이전트 지침 블록은 `--lang`을 지정하지 않으면 업데이트 후에도 원래 언어를 유지합니다. 프로젝트 문서·ID·이력과 schemaVersion 2 저장 규약은 그대로입니다.
+
 ## 0.6.2 - 2026-09-20
 ### Added
 - 기능별 요구사항 목록이 기능 아래에 그 기능의 요구사항을 한 줄씩 보여 줍니다. 누르면 상세의 그 요구사항으로 바로 이동하고 주소가 그 위치를 가리켜, 링크를 공유하거나 북마크해 두면 다시 그 자리에서 열립니다. 목록은 기능 단위로 페이지를 나누어 한 기능의 요구사항이 페이지에 걸쳐 끊기지 않습니다.

package/dist/i18n/ko/docs/workflow.md

@@ -4,7 +4,13 @@
 
 ## 시작과 형식 확인
 
-현재 경로·브랜치·Git 상태와 기존 staging을 확인하고 적용되는 AGENTS.md·CLAUDE.md를 원문으로 읽는다. 지침에서 지정한 CLI를 사용한다. 아래 `gitifact`는 그 실행 방법을 뜻한다. CLI가 없다면 이 프로젝트에 참여하는 데 필요한 도구가 빠진 것이다. 설치·전역 설정 변경을 임의로 하지 않고, 사용자에게 알린 뒤 동의를 받아 블록 첫머리에 적힌 버전으로 설치한다(`npm install -g gitifact@<버전>`). 설치 전에는 가능한 조사부터 진행하고 명세 저장·커밋을 추측으로 대신하지 않는다.
+현재 경로·브랜치·Git 상태와 기존 staging을 확인하고 적용되는 AGENTS.md·CLAUDE.md를 원문으로 읽는다. 프로젝트가 정한 CLI 실행 방법을 우선하고, 별도 지정이 없으면 블록 첫머리의 버전으로 `npx --yes gitifact@<버전> <명령>`을 실행한다. 아래 `gitifact`는 선택한 실행 방법을 뜻한다. 같은 버전의 프로젝트 의존성이 있으면 사용하고, 없으면 npm 캐시에 받아 실행하므로 전역 설치는 필요하지 않다.
+
+전역 명령이 없거나 전역 설치 권한이 없다는 이유만으로 Gitifact 작업을 건너뛰지 않는다. 프로젝트 의존성 추가와 전역 설치는 사용자가 그 방식을 선택했을 때 한다. 실행·네트워크 권한이 막히면 필요한 승인을 요청하고 원인을 알린다. `--yes`는 npm의 설치 확인만 생략하며 실행 환경의 권한을 바꾸지 않는다. 가능한 조사는 계속하되 CLI 실행 없이 명세 저장·커밋을 대신하거나 완료했다고 보고하지 않는다.
+
+새 세션에서는 지정 버전으로 `gitifact update --check`를 한 번 실행한다. 이 명령은 파일·index·커밋을 바꾸지 않는다. `available`이면 현재·새 버전을 알려 주고 업데이트할지 묻는다. 동의 전에는 지침을 갱신하거나 새 버전으로 작업하지 않는다. 거절하면 지정 버전으로 계속하며 같은 세션에서 다시 묻지 않는다. `unavailable`은 확인 실패이며 최신이라는 뜻이 아니다. 실패하거나 `GITIFACT_NO_UPDATE_CHECK`로 조회를 껐으면 지정 버전으로 작업을 이어간다.
+
+업데이트는 프로젝트의 실행 방식을 따른다. npx를 쓰면 새 버전으로 `npx --yes gitifact@<새 버전> update`를 실행해 블록의 버전을 갱신한다. 프로젝트 의존성으로 관리하면 해당 패키지 관리자로 버전을 올리고 업데이트한 설치본을 실행한다. 전역 설치 안내는 전역 명령을 선택한 경우에만 적용한다.
 
 설정과 실제 파일, CLI 도움말을 함께 확인해 다음 중 하나의 흐름을 선택한다. 명령이 존재한다는 사실만으로 프로젝트 사용이나 전환이 허용되지는 않는다.
 
@@ -12,7 +18,7 @@
 - **이전 형식:** `schemaVersion: 1`(0.4.x)과 workflow-1·prototype-1·init-1 설정은 현재 CLI가 조회·기록하지 않는다. 기존 기록을 삭제하거나 새 형식으로 가장하지 않고, 정식 버전 전 규약이라 전환 도구가 없다고 알린다. 사용자가 원하면 기록을 보존한 채 새로 도입한다.
 - **미도입:** 도입이 허용됐으면 Git 상태와 지침을 확인하고 `init --dry-run`, `init`으로 연결한다. Git 저장소가 없으면 Git 생성 권한을 확인한다. 기존 변경과 staging을 보존한다.
 
-init은 `.gitifact/config.json`과 도입 기준선, 위키 운영 방침을 담은 `.gitifact/wiki/README.md`를 만들고, AGENTS.md 등 에이전트 지침 파일에 `<!-- GITIFACT:START -->`와 `<!-- GITIFACT:END -->` 사이의 블록을 쓴다. 블록이 AGENTS.md에 들어가고 CLAUDE.md가 없으면 `@AGENTS.md` 한 줄짜리 CLAUDE.md를 함께 만든다. 마커 바깥의 내용은 건드리지 않는다. 요구사항·커밋은 만들지 않는다. 블록은 규칙의 요약이며, 상세 형식은 `gitifact docs <topic>`으로 읽는다. CLI를 업데이트한 뒤 `update`(또는 `init`)를 실행하면 블록이 갱신된다. `update`는 새 버전 여부와 설치 방법도 알려 주며 설치를 직접 실행하지는 않는다. 사용자가 업데이트를 요청하면 `update --commit`을 쓴다. 블록 안만 바뀐 지침 파일을 `chore(gitifact): refresh GITIFACT block to v<버전>` 메시지로 그 파일만 커밋하고, 다른 staging은 그대로 둔다. 블록 밖에도 수정이 있거나 추적하지 않는 파일이거나 Git이 커밋을 거부하면 커밋하지 않고 `commit.reason`으로 알린다. 이때 에이전트가 메시지를 바꿔 대신 커밋하지 않고 사용자에게 알린다.
+init은 `.gitifact/config.json`과 도입 기준선, 위키 운영 방침을 담은 `.gitifact/wiki/README.md`를 만들고, AGENTS.md 등 에이전트 지침 파일에 `<!-- GITIFACT:START -->`와 `<!-- GITIFACT:END -->` 사이의 블록을 쓴다. 블록이 AGENTS.md에 들어가고 CLAUDE.md가 없으면 `@AGENTS.md` 한 줄짜리 CLAUDE.md를 함께 만든다. 마커 바깥의 내용은 건드리지 않는다. 요구사항·커밋은 만들지 않는다. 블록은 규칙의 요약이며, 상세 형식은 `gitifact docs <topic>`으로 읽는다. CLI를 업데이트한 뒤 `update`(또는 `init`)를 실행하면 블록이 갱신된다. 기존 블록의 언어는 유지하며, `--lang ko` 또는 `--lang en`을 지정한 경우에만 바꾼다. 새 블록은 CLI 언어를 따르고 프로젝트 문서는 기존 언어를 유지한다. `update`는 새 버전 여부와 설치 방법도 알려 주며 설치를 직접 실행하지는 않는다. 갱신 후에는 블록을 다시 읽고 새 버전으로 작업한다. 갱신된 지침이 커밋·공유되면 다른 팀원도 pull한 뒤 새 세션에서 그 버전을 사용한다. 업데이트 동의만으로 커밋·푸시하지 않는다. 커밋까지 요청받았을 때만 `update --commit`을 쓴다. 블록 안만 바뀐 지침 파일을 `chore(gitifact): refresh GITIFACT block to v<버전>` 메시지로 그 파일만 커밋하고, 다른 staging은 그대로 둔다. 블록 밖에도 수정이 있거나 추적하지 않는 파일이거나 Git이 커밋을 거부하면 커밋하지 않고 `commit.reason`으로 알린다. 이때 에이전트가 메시지를 바꿔 대신 커밋하지 않고 사용자에게 알린다.
 
 ## 맥락 읽기
 

package/dist/i18n/ko/docs/writing.md

@@ -1,6 +1,6 @@
 # 문서 문체
 
-위키 페이지·요구사항·설계에 모두 적용한다. 본문은 '~한다', '~이다'로 통일하고 제목은 내용을 나타내는 명사형으로 쓴다. 화면 문구·인용·코드의 표현은 유지한다.
+위키 페이지·요구사항·설계에 모두 적용한다. 문서는 CLI 표시 언어와 무관하게 프로젝트의 언어로 쓴다. 본문은 '~한다', '~이다'로 통일하고 제목은 내용을 나타내는 명사형으로 쓴다. 화면 문구·인용·코드의 표현은 유지한다.
 
 ## 서술과 구성