gitifact 0.7.1 → 0.8.1

package/dist/i18n/en/docs/wiki.md

@@ -1,43 +0,0 @@
-# Project wiki format
-
-Content that does not belong to an individual feature lives in `.gitifact/wiki/`: what the product is, whom it serves, how it is built, and the rules to follow. Keep feature behavior in specifications rather than repeating it in the wiki. The first part of this output describes the format validated by the CLI. The “Wiki guidelines” section that follows contains the project's `.gitifact/wiki/README.md` body, or the built-in defaults if no README exists.
-
-## File structure
-
-Pages are Markdown files under `.gitifact/wiki/`, with any subfolder structure. Folder and file names use lowercase letters, digits, and hyphens. Only root pages may use uppercase names such as `README.md` or `ARCHITECTURE.md`. `README.md` is both the wiki entry point and its operating guidelines. `init` creates it with defaults; user edits then become the agent's guidelines. The browser and GitHub show this page when opening its folder.
-
-Each file contains frontmatter with a CLI-issued `W-<random>` ID, a top-level heading, and the body. Do not put other gitifact comments in the body. Save through `spec save` instead of creating files by hand. All wiki reasons accumulate in `.gitifact/wiki/history.jsonl`.
-
-```markdown
----
-id: W-issued-by-the-CLI
----
-
-# Architecture
-
-Layers and dependency direction.
-```
-
-Links to pages, specifications, or assets are relative to this file. Examples: `conventions/code-style.md`, `../spec/posts/requirements.md`, `../assets/diagrams/flow.png`. Editors and GitHub treat them as file links; the browser resolves them to pages, features, or assets. Links to repository files outside Gitifact documents cannot be opened in the viewer; their paths can be copied. `spec working` reports absent targets as `MISSING_LINK_TARGET`.
-
-Follow `gitifact docs writing` for page content and keep the project's language.
-
-## Assets
-
-Put images, PDFs, and other non-Markdown files under `.gitifact/assets/`. Subfolders are unrestricted and assets have no IDs. Copy files directly and reference them with relative links. Recommended extensions are png, jpg, gif, webp, svg, and pdf; recommended sizes are at most 1 MB per file and 50 MB in total. Larger or other files still save and commit, with `ASSET_SIZE`, `ASSET_EXTENSION`, or `ASSETS_TOTAL_SIZE` warnings from `spec working`. Unreferenced files produce `UNREFERENCED_ASSET`. The browser displays images inline and offers other files for download. Update references when renaming an asset.
-
-## Saving
-
-Use `spec save` operations: `create-doc` (type, path, title, body), `update-doc` (type, id, title, body), `move-doc` (type, id, path), and `delete-doc` (type, id). Paths are relative to `.gitifact/wiki/` and end in `.md`.
-
-```json
-{
-  "expected": "actual stamp from working",
-  "operations": [
-    { "type": "create-doc", "path": "README.md", "title": "Product name", "body": "A short definition, intended users, principles, scope exclusions, and links to other pages." },
-    { "type": "create-doc", "path": "conventions/code-style.md", "title": "Code style", "body": "Rules and their reasons." }
-  ]
-}
-```
-
-At commit time, pass wiki reasons as `{requirements: [], documents: [actual W-ID], reason: actual reason}` (`gitifact docs commit`).

package/dist/i18n/ko/docs/wiki.default.md

@@ -1,27 +0,0 @@
-이 위키에는 아키텍처 결정 기록(ADR)을 쌓는다.
-
-## 결정 기록
-
-여러 기능에 걸치는 구조·기술 선택을 새로 하거나 바꾸면 `adr/` 아래에 하나 남긴다. 파일 이름은 `0001-use-postgres.md`처럼 네 자리 번호와 소문자·숫자·하이픈이며, 번호는 늘리기만 한다. 한 기능 안에서만 유효한 선택은 그 기능의 design.md에 둔다.
-
-```markdown
-# 결정 NNNN. 제목
-
-상태: Accepted · YYYY-MM-DD
-
-## 맥락
-어떤 문제와 제약이 있었는가.
-
-## 결정
-무엇을 어떻게 하기로 했는가.
-
-## 결과
-얻는 것과 감수하는 것, 기각한 대안과 이유.
-```
-
-상태는 `Proposed`(제안), `Accepted`(채택), `Deprecated`(더 이상 따르지 않음), `Superseded by NNNN`(NNNN번 기록으로 대체) 중 하나다. 이미 쌓인 기록은 고치지 않는다. 결정이 바뀌면 새 기록을 추가하고, 이전 기록은 상태만 `Superseded by NNNN`으로 바꾼다.
-
-## 에이전트
-
-- 요구사항·설계·코드를 바꾸기 전에 관련된 결정 기록을 읽고 따른다.
-- 결정 기록에 남길 만한 선택을 만나면 추가를 제안하고, 사용자가 동의하면 `spec save`로 저장한다.

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

@@ -1,43 +0,0 @@
-# 프로젝트 위키 형식
-
-기능에 묶이지 않는 내용은 `.gitifact/wiki/`에 둔다. 제품이 무엇이고 누구를 위한 것인지, 어떻게 만드는지, 지킬 규칙이 여기에 들어간다. 기능별 동작은 명세에 두고 위키에 반복하지 않는다. 이 출력의 앞부분은 CLI가 검증하는 형식이고, 뒷부분 "운영 방침"은 프로젝트의 `.gitifact/wiki/README.md` 본문이다. README가 없으면 내장 기본 방침이 실린다.
-
-## 파일 구조
-
-페이지는 `.gitifact/wiki/` 아래 Markdown 파일이며 하위 폴더를 자유롭게 둔다. 폴더·파일 이름은 소문자·숫자·하이픈이다. 루트의 페이지만 `README.md`·`ARCHITECTURE.md`처럼 대문자 이름을 쓸 수 있다. `README.md`는 위키의 운영 방침이자 진입 페이지다. `init`이 기본 방침으로 만들어 두고, 사용자가 고치면 그대로 에이전트의 방침이 된다. 브라우저와 GitHub는 폴더를 열면 이 페이지를 보여 준다.
-
-각 파일은 CLI가 발급한 `W-<난수>` ID를 담은 frontmatter, 최상위 제목, 본문 순서다. 본문에는 다른 gitifact 주석을 쓰지 않는다. 손으로 파일을 만들지 말고 `spec save`로 저장한다. 변경 이유는 `.gitifact/wiki/history.jsonl` 하나에 쌓인다.
-
-```markdown
----
-id: W-CLI가발급한값
----
-
-# 아키텍처
-
-계층 구조와 의존 방향.
-```
-
-다른 페이지·명세·에셋으로 가는 링크는 이 파일 기준 상대 경로로 쓴다. 예: `conventions/code-style.md`, `../spec/posts/requirements.md`, `../assets/diagrams/flow.png`. 에디터와 GitHub에서는 파일 링크로 동작하고, 브라우저는 해당 페이지·기능·에셋으로 연결한다. gitifact 문서가 아닌 저장소 파일로 가는 링크는 브라우저에서 열리지 않고 경로만 복사할 수 있다. 대상이 없는 링크는 `spec working`이 `MISSING_LINK_TARGET`으로 알린다.
-
-페이지 본문의 문체는 `gitifact docs writing`을 따른다.
-
-## 에셋
-
-이미지·PDF 등 Markdown이 아닌 파일은 `.gitifact/assets/` 아래에 둔다. 하위 폴더는 자유롭고 ID는 없다. 파일을 직접 복사해 넣고 문서에서 상대 경로로 참조한다. 권장 확장자는 png·jpg·gif·webp·svg·pdf, 권장 크기는 파일당 1MB·전체 50MB 이하다. 넘어도 저장·커밋은 되며 `spec working`이 `ASSET_SIZE`·`ASSET_EXTENSION`·`ASSETS_TOTAL_SIZE`로 알린다. 어떤 문서도 참조하지 않는 에셋은 `UNREFERENCED_ASSET`으로 알린다. 브라우저는 이미지를 본문에 표시하고 그 밖의 파일은 다운로드로 제공한다. 에셋 파일 이름을 바꾸면 참조하는 문서도 함께 고친다.
-
-## 저장 명령
-
-`spec save`의 operations를 쓴다. 생성은 `create-doc`(type·path·title·body), 수정은 `update-doc`(type·id·title·body), 이동·이름 변경은 `move-doc`(type·id·path), 삭제는 `delete-doc`(type·id)다. path는 `.gitifact/wiki/` 안 상대 경로이며 `.md`로 끝난다.
-
-```json
-{
-  "expected": "working의 실제 stamp",
-  "operations": [
-    { "type": "create-doc", "path": "README.md", "title": "제품 이름", "body": "한 문단 정의, 대상 사용자, 원칙, 범위 밖. 나머지 페이지로 가는 링크." },
-    { "type": "create-doc", "path": "conventions/code-style.md", "title": "코드 스타일", "body": "규칙과 이유." }
-  ]
-}
-```
-
-커밋할 때 위키 변경 이유는 `{requirements: [], documents: [실제 W-ID], reason: 실제 이유}`로 전달한다(`gitifact docs commit`).