truthmark 2.2.7 → 2.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +119 -166
- package/dist/main.js +2156 -1914
- package/dist/main.js.map +1 -1
- package/docs/README.md +49 -37
- package/docs/assets/truthmark-workflow-mobile.svg +118 -0
- package/docs/assets/truthmark-workflow.svg +182 -0
- package/docs/readmes/README.ar.md +125 -160
- package/docs/readmes/README.de.md +127 -162
- package/docs/readmes/README.el.md +127 -162
- package/docs/readmes/README.es.md +125 -160
- package/docs/readmes/README.fr.md +125 -160
- package/docs/readmes/README.id.md +126 -161
- package/docs/readmes/README.it.md +125 -160
- package/docs/readmes/README.ja.md +126 -161
- package/docs/readmes/README.ko.md +127 -162
- package/docs/readmes/README.pl.md +125 -160
- package/docs/readmes/README.pt.md +126 -161
- package/docs/readmes/README.ru.md +124 -159
- package/docs/readmes/README.tr.md +125 -160
- package/docs/readmes/README.vi.md +126 -161
- package/docs/readmes/README.zh.md +128 -163
- package/package.json +3 -1
|
@@ -1,229 +1,194 @@
|
|
|
1
1
|
# Truthmark
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**에이전트는 코드를 작성합니다. Truthmark는 사람이 읽고 Git에서 검토할 수 있는 문서를 유지합니다.**
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
## 🚀 빠른 시작: 5분 안에 로컬에서 실행하기
|
|
10
|
-
|
|
11
|
-
Truthmark가 관리하길 원하는 Git 저장소 안에서 실행하세요:
|
|
12
|
-
|
|
13
|
-
```bash
|
|
14
|
-
cd /path/to/your-repo
|
|
15
|
-
npm install -g truthmark
|
|
16
|
-
truthmark config
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
실제로 사용하는 AI 호스트를 활성화하세요. 새 설정은 기본적으로 호스트 중립적이므로, 초기화 전에 `.truthmark/config.yml`에 최상위 `platforms` 목록을 추가하세요:
|
|
20
|
-
|
|
21
|
-
```yaml
|
|
22
|
-
version: 2
|
|
23
|
-
platforms:
|
|
24
|
-
- codex # or: claude-code, github-copilot, opencode, antigravity, cursor
|
|
25
|
-
truthmark:
|
|
26
|
-
workspace: docs/truthmark
|
|
27
|
-
generated:
|
|
28
|
-
portal:
|
|
29
|
-
enabled: false
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
그런 다음 저장소 로컬 truth 문서, 라우팅, 에이전트 워크플로 표면을 설치하세요:
|
|
33
|
-
|
|
34
|
-
```bash
|
|
35
|
-
truthmark init
|
|
36
|
-
truthmark check
|
|
37
|
-
git diff
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
이제 가장 흔한 도입 경로를 시도해 보세요. 코드와 테스트에서 기존 동작 하나를 문서화합니다. AI 코딩 호스트에서 설치된 워크플로에 요청하세요:
|
|
41
|
-
|
|
42
|
-
```text
|
|
43
|
-
/truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
그 이후에는 사용자가 일반적으로 Truth Sync를 직접 호출할 필요가 없습니다. AI 호스트를 통해 계속 코딩하세요. 설치된 저장소 지침이 기능 코드가 변경될 때 에이전트에게 관련 테스트를 실행하고 인계 전에 Truth Sync 검토를 수행하라고 알려줍니다. 사용자는 결과 코드 diff와 truth-doc diff를 함께 검토합니다.
|
|
5
|
+
Truthmark는 Git 네이티브 워크플로를 설치하여 AI 코딩 에이전트가 기존 코드와 테스트에서 새로운 제품 및 엔지니어링 문서를 만들고, 코드가 변경될 때마다 최신 상태로 유지하며, 일반적인 Markdown diff로 검토할 수 있게 합니다.
|
|
47
6
|
|
|
48
|
-
|
|
7
|
+
[](https://www.npmjs.com/package/truthmark)
|
|
8
|
+
[](https://github.com/merlinhu1/truthmark/actions/workflows/ci.yml)
|
|
9
|
+
[](../../LICENSE)
|
|
10
|
+
[](../../package.json)
|
|
49
11
|
|
|
50
|
-
|
|
12
|
+
[시작하기](#빠른-시작-첫-truth-문서-만들기) · [웹사이트](https://merlinhu1.github.io/truthmark/) · [사용자 가이드](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md) · [GitHub](https://github.com/merlinhu1/truthmark)
|
|
51
13
|
|
|
52
|
-
|
|
14
|
+
<details>
|
|
15
|
+
<summary>16개 언어로 이 README 읽기</summary>
|
|
53
16
|
|
|
54
|
-
|
|
55
|
-
* 아키텍처 문서는 빠르게 뒤처집니다.
|
|
56
|
-
* 제품 결정은 인계 후 사라집니다.
|
|
57
|
-
* 코드 리뷰어는 “왜”를 이해하지 못한 채 원시 코드 diff만 보게 됩니다.
|
|
58
|
-
* 모든 새 AI 세션은 저장소의 truth를 처음부터 다시 발견해야 합니다.
|
|
17
|
+
[🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇪🇸 Español](README.es.md) | [🇧🇷 Português](README.pt.md) | [🇷🇺 Русский](README.ru.md) | [🇸🇦 العربية](README.ar.md) | [🇮🇹 Italiano](README.it.md) | [🇵🇱 Polski](README.pl.md) | [🇹🇷 Türkçe](README.tr.md) | [🇻🇳 Tiếng Việt](README.vi.md) | [🇮🇩 Bahasa Indonesia](README.id.md) | [🇬🇷 Ελληνικά](README.el.md)
|
|
59
18
|
|
|
60
|
-
|
|
19
|
+
</details>
|
|
61
20
|
|
|
62
|
-
|
|
21
|
+
## 첫 문서를 만들고, 언제나 진실하게 유지하세요
|
|
63
22
|
|
|
64
|
-
|
|
23
|
+
대부분의 문서화 도구는 생성에서 멈춥니다. Truthmark는 저장소 안에서 에이전트에게 완전한 문서 수명 주기를 제공합니다.
|
|
65
24
|
|
|
66
|
-
|
|
25
|
+
- **작동하는 소프트웨어에서 새 문서를 만듭니다.** Truth Document는 코드와 테스트를 읽고 범위가 명확한 제품 또는 엔지니어링 문서를 만듭니다.
|
|
26
|
+
- **문서를 자동으로 일치시킵니다.** 기능 코드가 변경되면 Truth Sync가 에이전트 인계 시 실행되어 작업이 끝나기 전에 저장소의 진실을 업데이트합니다.
|
|
27
|
+
- **문서를 다시 코드로 만듭니다.** Truth Realize는 승인된 truth 문서를 구현하면서 깔끔한 문서 우선 워크플로를 유지합니다.
|
|
28
|
+
- **코드베이스가 성장함에 따라 소유권을 정비합니다.** Truth Structure는 새 영역이나 과도하게 넓어진 영역을 위해 범위가 명확한 경로와 시작 문서를 만듭니다.
|
|
29
|
+
- **모든 것을 Git에서 검토합니다.** 코드, 결정, 계약, 아키텍처, 운영, 동작이 브랜치와 함께 이동합니다.
|
|
67
30
|
|
|
68
|
-
|
|
31
|
+
호스팅 지식 베이스가 필요 없습니다. 비공개 에이전트 메모리도 없습니다. 채팅 기록에 갇힌 문서도 없습니다.
|
|
69
32
|
|
|
70
|
-
|
|
71
|
-
* **🌳 100% Git 네이티브:** 모든 것이 저장소 안에 있습니다. truth는 브랜치와 함께 이동합니다.
|
|
72
|
-
* **🤝 사람이 소유하고 에이전트가 따르는 계약:** 유지관리자가 저장소 계약을 소유하고, 에이전트는 코딩 중 설치된 지침을 따릅니다.
|
|
73
|
-
* **✅ 검증을 통한 신뢰:** 동작을 바꾸는 작업에는 사람이 검토할 수 있는 truth-doc 결정 또는 diff가 포함되므로 AI 작업을 더 쉽게 신뢰할 수 있습니다.
|
|
33
|
+
## 빠른 시작: 첫 Truth 문서 만들기
|
|
74
34
|
|
|
75
|
-
|
|
35
|
+
**요구 사항:** Node.js 24 이상, Git 저장소, 에이전트 워크플로를 지원하는 AI 코딩 호스트.
|
|
76
36
|
|
|
77
|
-
|
|
37
|
+
Truthmark가 관리할 저장소 안에서 실행하세요.
|
|
78
38
|
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
39
|
+
```bash
|
|
40
|
+
cd /path/to/your-repo
|
|
41
|
+
npm install -g truthmark
|
|
42
|
+
truthmark init
|
|
43
|
+
```
|
|
84
44
|
|
|
85
|
-
|
|
45
|
+
`truthmark init`에서 Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, Cursor 또는 호스트 중립적인 명령줄 인터페이스 설정을 선택할 수 있습니다.
|
|
86
46
|
|
|
87
|
-
|
|
47
|
+
이제 설정된 에이전트에게 실제 동작 하나를 문서화하도록 요청하세요.
|
|
88
48
|
|
|
89
|
-
|
|
49
|
+
```text
|
|
50
|
+
/truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
|
|
51
|
+
```
|
|
90
52
|
|
|
91
|
-
|
|
53
|
+
해당 문서가 없으면 Truth Document가 범위가 명확한 새 truth 문서를 만들고, 기존 소유 문서가 있으면 업데이트하며, 필요할 때 라우팅도 업데이트합니다. 기능 코드는 변경하지 않습니다.
|
|
92
54
|
|
|
93
|
-
|
|
94
|
-
* `truthmark init` - 라우팅, truth-doc 스캐폴드, AI 호스트 지침을 설치하거나 새로 고칩니다.
|
|
95
|
-
* `truthmark check` - 터미널에서 저장소 truth를 검증합니다.
|
|
55
|
+
결과를 검토하세요.
|
|
96
56
|
|
|
97
|
-
|
|
57
|
+
```bash
|
|
58
|
+
truthmark check
|
|
59
|
+
git status --short --untracked-files=all
|
|
60
|
+
git diff
|
|
61
|
+
```
|
|
98
62
|
|
|
99
|
-
|
|
63
|
+
이제 다음 파일이 있어야 합니다.
|
|
100
64
|
|
|
101
|
-
|
|
65
|
+
```text
|
|
66
|
+
docs/truthmark/engineering/behaviors/session-timeout.md
|
|
67
|
+
docs/truthmark/routes/areas/authentication.md
|
|
68
|
+
```
|
|
102
69
|
|
|
103
|
-
|
|
104
|
-
2. 설치된 지침은 에이전트에게 언제 테스트하고, 언제 truth docs를 업데이트하고, 언제 사람 검토를 위해 멈출지 알려 줍니다.
|
|
105
|
-
3. 당신은 일반 Git diff를 검토합니다. 코드와 필요한 truth-doc 변경입니다.
|
|
70
|
+
정확한 경로는 저장소의 소유권 구조를 따릅니다. 새 파일은 `git status`에 표시되고, 추적 중인 파일의 변경 사항은 `git diff`에 표시됩니다.
|
|
106
71
|
|
|
107
|
-
|
|
72
|
+
호출 방식은 호스트마다 다릅니다. OpenCode는 `/skill truthmark-document`, Antigravity는 `@truthmark-document`를 사용하며, 그 밖의 지원 호스트는 각자의 네이티브 스킬 또는 슬래시 명령 표면을 사용합니다. 정확한 명령은 [플랫폼 표](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md#supported-agent-platforms)를 참조하세요.
|
|
108
73
|
|
|
109
|
-
|
|
110
|
-
* `/truthmark-realize` - 기존 truth docs에서 코드를 구현합니다.
|
|
111
|
-
* `/truthmark-check` - 저장소 truth를 감사합니다.
|
|
74
|
+
스크립트와 지속적 통합에서는 선택한 플랫폼을 명시적으로 전달하세요.
|
|
112
75
|
|
|
113
|
-
|
|
114
|
-
|
|
76
|
+
```bash
|
|
77
|
+
truthmark init --platform codex --platform cursor
|
|
78
|
+
truthmark init --json
|
|
79
|
+
```
|
|
115
80
|
|
|
116
|
-
|
|
81
|
+
대화형으로 `none`을 선택하거나 `truthmark init --clear-platforms`를 실행하면 호스트 중립적인 저장소가 됩니다. 나중에 `truthmark init`을 다시 실행해 에이전트 플랫폼을 추가할 수 있습니다.
|
|
117
82
|
|
|
118
|
-
|
|
119
|
-
| --- | --- |
|
|
120
|
-
| Git 네이티브 truth | 저장소 truth를 커밋된 Markdown과 설정에 보관합니다. |
|
|
121
|
-
| 브랜치 범위 문서화 | truth는 비공개 세션에 머무르지 않고 브랜치와 함께 이동합니다. |
|
|
122
|
-
| 사람용 CLI | 유지관리자에게 설정, 새로고침, 검증, 검사 명령을 제공합니다. |
|
|
123
|
-
| 설치된 에이전트 지침 | 코딩 에이전트에게 언제 문서화, 테스트, truth 동기화, 감사, 검토 중지를 할지 알려 줍니다. |
|
|
124
|
-
| 명시적 라우팅 | 코드 영역을 정식 truth 문서에 매핑합니다. |
|
|
125
|
-
| 검토 가능한 인계 | 코드와 truth 문서 모두에 대해 일반 Git diff를 생성합니다. |
|
|
126
|
-
| 로컬 우선 운영 | 호스팅 서비스, 데몬, 데이터베이스, MCP 서버가 필요 없습니다. |
|
|
127
|
-
| 더 안전한 쓰기 경계 | 코드 우선, 문서 우선, 읽기 전용, 문서 전용 워크플로를 분리합니다. |
|
|
128
|
-
| 검증 | 라우팅, 권한, frontmatter, 링크, 생성 표면, 브랜치 범위, 신선도, 커버리지 문제를 보고합니다. |
|
|
129
|
-
| 선택적 Portal | 명시적으로 활성화하고 요청한 경우 Markdown truth 문서에서 커밋된 정적 HTML 프레젠테이션 사이트를 생성합니다. |
|
|
83
|
+
브랜치 기준 최신성 진단에는 Git 기준점을 전달하세요.
|
|
130
84
|
|
|
131
|
-
|
|
85
|
+
```bash
|
|
86
|
+
truthmark check --base <base-ref>
|
|
87
|
+
```
|
|
132
88
|
|
|
133
|
-
|
|
89
|
+
## Truthmark 작동 방식
|
|
134
90
|
|
|
135
|
-
|
|
91
|
+
<picture>
|
|
92
|
+
<source media="(max-width: 700px)" srcset="../assets/truthmark-workflow-mobile.svg">
|
|
93
|
+
<img src="../assets/truthmark-workflow.svg" alt="Truthmark 작동 방식" width="1440">
|
|
94
|
+
</picture>
|
|
136
95
|
|
|
137
|
-
|
|
96
|
+
Truthmark 명령줄 인터페이스는 저장소 계약을 설치하고 검증합니다. 코딩 에이전트는 설치된 호스트 네이티브 워크플로를 통해 근거를 검토하고 문서화 작업을 수행합니다.
|
|
138
97
|
|
|
139
|
-
|
|
98
|
+
일반적인 코드 변경은 하나의 단순한 순환을 따릅니다.
|
|
140
99
|
|
|
141
|
-
|
|
100
|
+
1. 에이전트가 기능 코드를 변경합니다.
|
|
101
|
+
2. 관련 테스트가 실행됩니다.
|
|
102
|
+
3. Truth Sync가 매핑된 문서를 확인합니다.
|
|
103
|
+
4. 저장소의 진실이 변경되면 에이전트가 문서와 라우팅을 만들거나 업데이트합니다.
|
|
104
|
+
5. 코드 diff와 truth diff를 함께 검토합니다.
|
|
142
105
|
|
|
143
|
-
|
|
106
|
+
## 워크플로
|
|
144
107
|
|
|
145
|
-
|
|
108
|
+
| 워크플로 | 사용 시점 | 결과 |
|
|
109
|
+
| -------------------- | ------------------------------------------------------------- | -------------------------------------------------------------- |
|
|
110
|
+
| **Truth Document** | 기존 코드에 문서가 필요할 때 | 근거 기반 제품 및 엔지니어링 문서를 만들거나 업데이트 |
|
|
111
|
+
| **Truth Sync** | 기능 코드가 변경되었을 때 | 인계 전에 매핑된 문서와 라우팅을 일치시킴 |
|
|
112
|
+
| **Truth Structure** | 새 영역에 소유권이 필요하거나 기존 문서의 범위가 너무 넓을 때 | 범위가 명확한 경로와 골격형 시작 문서를 만듦 |
|
|
113
|
+
| **Truth Realize** | 승인된 truth 문서를 작동하는 소프트웨어로 구현해야 할 때 | 문서를 기반으로 기능 코드를 업데이트 |
|
|
114
|
+
| **Truth Check** | 저장소의 진실을 감사해야 할 때 | 라우팅, 소유권, 근거, 문서 문제를 보고 |
|
|
115
|
+
| **Truthmark Portal** | 팀에 탐색 가능한 문서 사이트가 필요할 때 | Markdown truth 문서에서 커밋되는 정적 HTML 프레젠테이션을 생성 |
|
|
146
116
|
|
|
147
|
-
Truthmark는
|
|
117
|
+
Truthmark는 Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, Cursor의 네이티브 저장소 표면으로 이러한 워크플로를 설치합니다.
|
|
148
118
|
|
|
149
|
-
|
|
119
|
+
## 제공되는 가치
|
|
150
120
|
|
|
151
|
-
|
|
121
|
+
### 현실에서 시작하는 문서
|
|
152
122
|
|
|
153
|
-
|
|
123
|
+
Truthmark는 제품 기능, 구현 동작, 애플리케이션 프로그래밍 인터페이스, 아키텍처, 워크플로, 운영, 테스트를 위한 문서를 만들 수 있습니다. 코드와 테스트가 근거를 제공하고, 범위가 명확한 Markdown 문서가 결과를 보존합니다.
|
|
154
124
|
|
|
155
|
-
|
|
125
|
+
### 다음 변경에도 살아남는 문서
|
|
156
126
|
|
|
157
|
-
|
|
127
|
+
경로는 코드 영역을 표준 문서에 연결합니다. 에이전트가 동작을 변경하면 Truth Sync는 해당 진실이 속할 위치를 알고 인계를 계속 검토 가능한 상태로 유지합니다.
|
|
158
128
|
|
|
159
|
-
|
|
160
|
-
- 더 나은 인계
|
|
161
|
-
- 브랜치별 제품 truth
|
|
162
|
-
- 지속 가능한 아키텍처 및 API 문서
|
|
163
|
-
- 문서와 코드 사이의 명시적 소유권
|
|
164
|
-
- 더 안전한 에이전트 쓰기 경계
|
|
165
|
-
- 숨겨진 메모리가 아닌 검토 가능한 문서
|
|
166
|
-
- 커밋된 저장소 파일에서 계속 작동하는 에이전트 지침
|
|
129
|
+
### 제품의 진실과 엔지니어링의 진실을 분리된 흐름으로 관리
|
|
167
130
|
|
|
168
|
-
|
|
131
|
+
제품의 진실은 사용자 대상 약속, 경계, 결정, 인수 기준을 담습니다. 엔지니어링의 진실은 현재 동작, 계약, 아키텍처, 워크플로, 운영, 테스트 동작을 담습니다.
|
|
169
132
|
|
|
170
|
-
|
|
133
|
+
### Git 네이티브 협업
|
|
171
134
|
|
|
172
|
-
|
|
135
|
+
중요한 모든 것은 커밋된 저장소 파일에 있습니다. 진실은 브랜치를 따르고, 일반적인 풀 리퀘스트와 함께 작동하며, 모든 유지관리자와 코딩 에이전트에게 보입니다.
|
|
173
136
|
|
|
174
|
-
|
|
175
|
-
| --- | --- |
|
|
176
|
-
| 한 번의 에이전트 세션에서 더 나은 출력 | 더 나은 프롬프트 |
|
|
177
|
-
| 개인 또는 세션 수준의 연속성 | 메모리 도구 |
|
|
178
|
-
| 계획 우선 기능 작업 | 사양 워크플로 |
|
|
179
|
-
| 코드와 함께 이동하는 브랜치 범위 truth | Truthmark |
|
|
180
|
-
| 동작 정확성 검증 | 테스트와 리뷰 |
|
|
181
|
-
| AI 지원 문서 변경 검토 | Truthmark와 Git 리뷰 |
|
|
137
|
+
### 로컬 우선 운영
|
|
182
138
|
|
|
183
|
-
Truthmark
|
|
139
|
+
Truthmark에는 호스팅 서비스, 데몬, 데이터베이스, 벡터 저장소, Model Context Protocol 서버가 필요 없습니다. 저장소 자체가 문서 워크플로를 가지고 있습니다.
|
|
184
140
|
|
|
185
|
-
|
|
186
|
-
make repository truth explicit
|
|
187
|
-
route it to code
|
|
188
|
-
그 주위에 에이전트 지침을 설치하기
|
|
189
|
-
keep the result reviewable in Git
|
|
190
|
-
```
|
|
141
|
+
## Truthmark가 적합한 영역
|
|
191
142
|
|
|
192
|
-
|
|
143
|
+
| 필요 | 최적의 선택 |
|
|
144
|
+
| -------------------------------------- | ------------------------ |
|
|
145
|
+
| 한 번의 에이전트 세션에서 더 나은 결과 | 더 나은 프롬프트 |
|
|
146
|
+
| 개인 또는 세션 수준의 연속성 | 메모리 도구 |
|
|
147
|
+
| 계획 우선 기능 개발 | 사양 워크플로 |
|
|
148
|
+
| 코드와 함께 이동하는 브랜치 범위 문서 | **Truthmark** |
|
|
149
|
+
| 동작 정확성 | 테스트와 코드 리뷰 |
|
|
150
|
+
| 검토 가능한 AI 지원 문서 | **Truthmark + Git 리뷰** |
|
|
193
151
|
|
|
194
|
-
|
|
152
|
+
Truthmark는 이미 AI 코딩 에이전트를 사용하며, 코드가 변하는 속도만큼 빠르게 저장소가 계속 진실을 말하기를 원하는 유지관리자와 엔지니어링 팀을 위해 만들어졌습니다.
|
|
195
153
|
|
|
196
|
-
|
|
154
|
+
## 지원 호스트와 명령줄
|
|
197
155
|
|
|
198
|
-
|
|
156
|
+
지원되는 에이전트 호스트:
|
|
199
157
|
|
|
200
|
-
|
|
158
|
+
- Codex
|
|
159
|
+
- Claude Code
|
|
160
|
+
- GitHub Copilot
|
|
161
|
+
- OpenCode
|
|
162
|
+
- Antigravity
|
|
163
|
+
- Cursor
|
|
201
164
|
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
- 라우팅, 권한, frontmatter, 링크, 신선도, 생성 표면, 브랜치 범위, 커버리지 진단
|
|
205
|
-
- 브랜치 범위 truth 문서와 파생된 저장소 인텔리전스 산출물
|
|
165
|
+
<details>
|
|
166
|
+
<summary>명령줄 참조</summary>
|
|
206
167
|
|
|
207
|
-
|
|
168
|
+
| 명령 | 목적 |
|
|
169
|
+
| ----------------------------------------------------------------- | ----------------------------------------------------------------- |
|
|
170
|
+
| `truthmark init` | 구성, 라우팅, 템플릿, 선택한 호스트 워크플로를 만들거나 새로 고침 |
|
|
171
|
+
| `truthmark check [--base <ref>]` | 저장소의 진실을 검증하고 선택적으로 브랜치 최신성 진단을 실행 |
|
|
172
|
+
| `truthmark index --json` | 파생된 저장소 및 라우팅 메타데이터를 검사 |
|
|
173
|
+
| `truthmark impact --base <ref> --json` | 변경된 파일을 문서, 소유자, 인접 테스트에 매핑 |
|
|
174
|
+
| `truthmark workflow status --workflow <id> [--base <ref>] --json` | 워크플로 적용 가능성과 대상을 검사 |
|
|
175
|
+
| `truthmark validate ...` | 워크플로 보고서와 쓰기 임대를 검증 |
|
|
176
|
+
| `truthmark uninstall --dry-run` / `truthmark uninstall --apply` | 작성된 진실을 보존하면서 생성된 호스트 표면을 미리 보거나 제거 |
|
|
208
177
|
|
|
209
|
-
|
|
210
|
-
- [문서 색인](../README.md)
|
|
211
|
-
- [아키텍처 개요](../truthmark/engineering/architecture/overview.md)
|
|
212
|
-
- [API 및 CLI 계약](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
|
|
213
|
-
- [저장소 truth 유지관리 가이드](../standards/maintaining-repository-truth.md)
|
|
178
|
+
스크립트와 지속적 통합을 위해 명령줄 인터페이스 전반에서 구조화된 JSON 출력을 사용할 수 있습니다.
|
|
214
179
|
|
|
215
|
-
|
|
180
|
+
</details>
|
|
216
181
|
|
|
217
|
-
##
|
|
182
|
+
## 더 알아보기
|
|
218
183
|
|
|
219
|
-
Truthmark
|
|
184
|
+
- [Truthmark 사용자 가이드](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md)
|
|
185
|
+
- [문서 색인](https://github.com/merlinhu1/truthmark/blob/main/docs/README.md)
|
|
186
|
+
- [아키텍처 개요](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/architecture/overview.md)
|
|
187
|
+
- [구성, 라우팅, 명령 계약](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
|
|
188
|
+
- [기여하기](https://github.com/merlinhu1/truthmark/blob/main/CONTRIBUTING.md)
|
|
220
189
|
|
|
221
|
-
Truthmark
|
|
190
|
+
**Truthmark를 설치하고 코딩 호스트를 선택해 오늘 바로 실제 동작 하나를 문서로 바꾸세요.**
|
|
222
191
|
|
|
223
192
|
## 라이선스
|
|
224
193
|
|
|
225
194
|
MIT. [LICENSE](../../LICENSE)를 참조하세요.
|
|
226
|
-
|
|
227
|
-
## 안전한 제거
|
|
228
|
-
|
|
229
|
-
`truthmark uninstall --dry-run`을(를) 사용하여 정확히 생성된 호스트 표면을 검토한 후 `truthmark uninstall --apply`를 사용해 제거하세요. 작성된 truth, 구성, 템플릿, Portal 출력, Gemini 파일 및 관련 없는 사용자 파일은 보존되며, npm 전역 설치는 패키지 관리자에서 별도로 제거하십시오.
|