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
|
-
**Agen Anda menulis kode. Truthmark
|
|
3
|
+
**Agen Anda menulis kode. Truthmark menjaga dokumentasi yang ditujukan untuk manusia dan siap ditinjau di Git.**
|
|
4
|
+
|
|
5
|
+
Truthmark memasang alur kerja native Git yang memungkinkan agen pengodean AI membuat dokumentasi produk dan rekayasa baru dari kode serta pengujian yang sudah ada, menjaganya tetap mutakhir setelah setiap perubahan kode, dan memberikan diff Markdown biasa untuk Anda tinjau.
|
|
6
|
+
|
|
7
|
+
[](https://www.npmjs.com/package/truthmark)
|
|
8
|
+
[](https://github.com/merlinhu1/truthmark/actions/workflows/ci.yml)
|
|
9
|
+
[](../../LICENSE)
|
|
10
|
+
[](../../package.json)
|
|
11
|
+
|
|
12
|
+
[Mulai](#mulai-cepat-buat-dokumen-truth-pertama-anda) · [Situs web](https://merlinhu1.github.io/truthmark/) · [Panduan pengguna](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md) · [GitHub](https://github.com/merlinhu1/truthmark)
|
|
13
|
+
|
|
14
|
+
<details>
|
|
15
|
+
<summary>Baca README ini dalam salah satu dari 16 bahasa</summary>
|
|
4
16
|
|
|
5
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)
|
|
6
18
|
|
|
7
|
-
|
|
19
|
+
</details>
|
|
8
20
|
|
|
9
|
-
##
|
|
21
|
+
## Buat dokumentasi pertama. Jaga agar tetap benar.
|
|
10
22
|
|
|
11
|
-
|
|
23
|
+
Sebagian besar alat dokumentasi berhenti setelah pembuatan. Truthmark memberi agen siklus hidup dokumentasi lengkap di dalam repositori Anda:
|
|
12
24
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
25
|
+
- **Buat dokumentasi baru dari perangkat lunak yang berfungsi.** Truth Document membaca kode dan pengujian, lalu membuat dokumentasi produk atau rekayasa dengan cakupan yang jelas.
|
|
26
|
+
- **Jaga dokumentasi tetap selaras secara otomatis.** Truth Sync berjalan saat serah terima agen setelah perubahan kode fungsional dan memperbarui kebenaran repositori sebelum pekerjaan dinyatakan selesai.
|
|
27
|
+
- **Ubah dokumentasi kembali menjadi kode.** Truth Realize mengimplementasikan dokumen truth yang disetujui sambil mempertahankan alur kerja doc-first yang rapi.
|
|
28
|
+
- **Perbaiki kepemilikan seiring pertumbuhan basis kode.** Truth Structure membuat rute dengan cakupan jelas dan dokumen awal untuk area baru atau yang terlalu luas.
|
|
29
|
+
- **Tinjau semuanya di Git.** Kode, keputusan, kontrak, arsitektur, operasi, dan perilaku bergerak bersama branch.
|
|
18
30
|
|
|
19
|
-
|
|
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
|
+
Tanpa basis pengetahuan ter-host. Tanpa memori agen privat. Tanpa dokumentasi yang terjebak dalam riwayat chat.
|
|
31
32
|
|
|
32
|
-
|
|
33
|
+
## Mulai cepat: buat dokumen truth pertama Anda
|
|
34
|
+
|
|
35
|
+
**Persyaratan:** Node.js 24 atau yang lebih baru, repositori Git, dan host pengodean AI yang didukung untuk alur kerja agen.
|
|
36
|
+
|
|
37
|
+
Jalankan perintah berikut di dalam repositori yang ingin Anda kelola dengan Truthmark:
|
|
33
38
|
|
|
34
39
|
```bash
|
|
40
|
+
cd /path/to/your-repo
|
|
41
|
+
npm install -g truthmark
|
|
35
42
|
truthmark init
|
|
36
|
-
truthmark check
|
|
37
|
-
git diff
|
|
38
43
|
```
|
|
39
44
|
|
|
40
|
-
|
|
45
|
+
`truthmark init` memungkinkan Anda memilih Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, Cursor, atau penyiapan antarmuka baris perintah yang netral terhadap host.
|
|
46
|
+
|
|
47
|
+
Sekarang minta agen yang telah dikonfigurasi untuk mendokumentasikan satu perilaku nyata:
|
|
41
48
|
|
|
42
49
|
```text
|
|
43
50
|
/truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
|
|
44
51
|
```
|
|
45
52
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
Jika Anda hanya menginginkan validasi CLI dan belum menginginkan alur kerja AI khusus host, biarkan `platforms` tidak dicantumkan dan jalankan `truthmark init && truthmark check`; Anda dapat menambahkan platform nanti dan menjalankan ulang `truthmark init`.
|
|
49
|
-
|
|
50
|
-
## 💡 Masalah: kesenjangan dokumentasi AI
|
|
53
|
+
Truth Document membuat dokumen truth baru dengan cakupan jelas jika belum ada, memperbarui pemilik yang sudah ada jika tersedia, dan memperbarui perutean bila diperlukan. Alur ini tidak mengubah kode fungsional.
|
|
51
54
|
|
|
52
|
-
|
|
55
|
+
Tinjau hasilnya:
|
|
53
56
|
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
## 🎯 Solusi: Truthmark
|
|
61
|
-
|
|
62
|
-
**Truthmark** memasang lapisan alur kerja native Git ke dalam repositori Anda. Ini memperbaiki bagian pengembangan AI yang biasanya rusak: membantu dokumentasi tetap selaras dengan kode.
|
|
63
|
-
|
|
64
|
-
Alih-alih berharap manusia dan agen AI ingat memperbarui dokumen, Truthmark menjadikan dokumentasi sebagai kebiasaan sistematis dan dapat ditinjau langsung di dalam repositori Anda.
|
|
65
|
-
|
|
66
|
-
### ✨ Mengapa Truthmark unik
|
|
57
|
+
```bash
|
|
58
|
+
truthmark check
|
|
59
|
+
git status --short --untracked-files=all
|
|
60
|
+
git diff
|
|
61
|
+
```
|
|
67
62
|
|
|
68
|
-
|
|
63
|
+
Sekarang Anda akan memiliki:
|
|
69
64
|
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
65
|
+
```text
|
|
66
|
+
docs/truthmark/engineering/behaviors/session-timeout.md
|
|
67
|
+
docs/truthmark/routes/areas/authentication.md
|
|
68
|
+
```
|
|
74
69
|
|
|
75
|
-
|
|
70
|
+
Path yang tepat mengikuti struktur kepemilikan repositori Anda. File baru muncul di `git status`; perubahan pada file yang dilacak muncul di `git diff`.
|
|
76
71
|
|
|
77
|
-
|
|
72
|
+
Cara pemanggilan berbeda menurut host. OpenCode menggunakan `/skill truthmark-document`, Antigravity menggunakan `@truthmark-document`, dan host lain yang didukung menggunakan permukaan skill atau perintah garis miring native masing-masing. Lihat [tabel platform](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md#supported-agent-platforms) untuk perintah yang tepat.
|
|
78
73
|
|
|
79
|
-
|
|
80
|
-
2. 🧪 **Uji:** Pengujian yang relevan dijalankan.
|
|
81
|
-
3. 🔍 **Periksa:** Truthmark memeriksa dokumentasi yang dipetakan sebagai bagian dari tinjauan akhir yang terpasang.
|
|
82
|
-
4. 📝 **Dokumentasikan:** Dokumen diperbarui oleh agen ketika kebenaran repositori berubah.
|
|
83
|
-
5. 👀 **Tinjau:** Manusia meninjau *diff kode* + *diff kebenaran*.
|
|
74
|
+
Untuk skrip dan integrasi berkelanjutan, berikan platform yang dipilih secara eksplisit:
|
|
84
75
|
|
|
85
|
-
|
|
76
|
+
```bash
|
|
77
|
+
truthmark init --platform codex --platform cursor
|
|
78
|
+
truthmark init --json
|
|
79
|
+
```
|
|
86
80
|
|
|
87
|
-
|
|
81
|
+
Pilih `none` secara interaktif atau jalankan `truthmark init --clear-platforms` untuk repositori yang netral terhadap host. Anda dapat menambahkan platform agen nanti dengan menjalankan ulang `truthmark init`.
|
|
88
82
|
|
|
89
|
-
|
|
83
|
+
Untuk diagnostik kesegaran relatif terhadap branch, berikan basis Git:
|
|
90
84
|
|
|
91
|
-
|
|
85
|
+
```bash
|
|
86
|
+
truthmark check --base <base-ref>
|
|
87
|
+
```
|
|
92
88
|
|
|
93
|
-
|
|
94
|
-
* `truthmark init` - memasang atau menyegarkan perutean, scaffold dokumen kebenaran, dan instruksi host AI.
|
|
95
|
-
* `truthmark check` - memvalidasi kebenaran repositori dari terminal.
|
|
89
|
+
## Cara kerja Truthmark
|
|
96
90
|
|
|
97
|
-
|
|
91
|
+
<picture>
|
|
92
|
+
<source media="(max-width: 700px)" srcset="../assets/truthmark-workflow-mobile.svg">
|
|
93
|
+
<img src="../assets/truthmark-workflow.svg" alt="Cara kerja Truthmark" width="1440">
|
|
94
|
+
</picture>
|
|
98
95
|
|
|
99
|
-
Truthmark memasang
|
|
96
|
+
Antarmuka baris perintah Truthmark memasang dan memvalidasi kontrak repositori. Agen pengodean Anda melakukan peninjauan bukti dan pekerjaan dokumentasi melalui alur kerja native host yang telah terpasang.
|
|
100
97
|
|
|
101
|
-
|
|
98
|
+
Perubahan kode normal mengikuti satu putaran sederhana:
|
|
102
99
|
|
|
103
|
-
1.
|
|
104
|
-
2.
|
|
105
|
-
3.
|
|
100
|
+
1. Agen mengubah kode fungsional.
|
|
101
|
+
2. Pengujian yang relevan dijalankan.
|
|
102
|
+
3. Truth Sync memeriksa dokumentasi yang dipetakan.
|
|
103
|
+
4. Agen membuat atau memperbarui dokumentasi dan perutean saat kebenaran repositori berubah.
|
|
104
|
+
5. Anda meninjau diff kode dan diff truth secara bersamaan.
|
|
106
105
|
|
|
107
|
-
|
|
106
|
+
## Alur kerja
|
|
108
107
|
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
108
|
+
| Alur kerja | Gunakan saat | Hasil |
|
|
109
|
+
| -------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
|
|
110
|
+
| **Truth Document** | Kode yang sudah ada memerlukan dokumentasi | Membuat atau memperbarui dokumentasi produk dan rekayasa berbasis bukti |
|
|
111
|
+
| **Truth Sync** | Kode fungsional berubah | Menjaga dokumentasi yang dipetakan dan perutean tetap selaras sebelum serah terima |
|
|
112
|
+
| **Truth Structure** | Area baru memerlukan kepemilikan atau dokumentasi yang ada terlalu luas | Membuat rute dengan cakupan jelas dan kerangka dokumen awal |
|
|
113
|
+
| **Truth Realize** | Dokumen truth yang disetujui harus menjadi perangkat lunak yang berfungsi | Memperbarui kode fungsional dari dokumentasi |
|
|
114
|
+
| **Truth Check** | Kebenaran repositori perlu diaudit | Melaporkan masalah perutean, kepemilikan, bukti, dan dokumentasi |
|
|
115
|
+
| **Truthmark Portal** | Tim menginginkan situs dokumentasi yang mudah dijelajahi | Menghasilkan presentasi HTML statis yang di-commit dari dokumen truth Markdown |
|
|
112
116
|
|
|
113
|
-
|
|
114
|
-
Truth Structure bukan perintah harian; ia memperbaiki perutean atau kepemilikan hanya ketika hal itu memblokir pekerjaan.
|
|
117
|
+
Truthmark memasang alur kerja ini sebagai permukaan repositori native untuk Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, dan Cursor.
|
|
115
118
|
|
|
116
119
|
## Yang Anda dapatkan
|
|
117
120
|
|
|
118
|
-
|
|
119
|
-
| --- | --- |
|
|
120
|
-
| Kebenaran native Git | Menyimpan kebenaran repositori dalam Markdown dan konfigurasi yang di-commit. |
|
|
121
|
-
| Dokumentasi berlingkup branch | Kebenaran bergerak bersama branch alih-alih hidup dalam sesi privat. |
|
|
122
|
-
| CLI manusia | Memberi pemelihara perintah penyiapan, penyegaran, validasi, dan inspeksi. |
|
|
123
|
-
| Kontrak agen terpasang | Memberi agen panduan native host untuk dokumentasi, realisasi, audit, sinkronisasi akhir, dan perbaikan perutean terbatas. |
|
|
124
|
-
| Perutean eksplisit | Memetakan area kode ke dokumen kebenaran kanonis. |
|
|
125
|
-
| Serah terima yang dapat ditinjau | Menghasilkan diff Git biasa untuk kode maupun dokumen kebenaran. |
|
|
126
|
-
| Operasi lokal terlebih dahulu | Tidak membutuhkan layanan ter-host, daemon, basis data, atau server MCP. |
|
|
127
|
-
| Batas tulis yang lebih aman | Memisahkan alur kerja code-first, doc-first, read-only, dan doc-only. |
|
|
128
|
-
| Validasi | Melaporkan masalah perutean, otoritas, frontmatter, tautan, permukaan yang dihasilkan, cakupan branch, kesegaran, dan coverage. |
|
|
129
|
-
| Portal opsional | Menghasilkan situs presentasi HTML statis yang di-commit dari dokumen kebenaran Markdown ketika diaktifkan dan diminta secara eksplisit. |
|
|
130
|
-
|
|
131
|
-
## Gambaran visual
|
|
121
|
+
### Dokumentasi yang berawal dari kenyataan
|
|
132
122
|
|
|
133
|
-
|
|
123
|
+
Truthmark dapat membuat dokumentasi untuk kapabilitas produk, perilaku implementasi, antarmuka pemrograman aplikasi, arsitektur, alur kerja, operasi, dan pengujian. Kode dan pengujian menyediakan bukti; dokumen Markdown dengan cakupan jelas mempertahankan hasilnya.
|
|
134
124
|
|
|
135
|
-
|
|
125
|
+
### Dokumentasi yang bertahan melewati perubahan berikutnya
|
|
136
126
|
|
|
137
|
-
|
|
127
|
+
Rute menghubungkan area kode ke dokumen kanonis. Saat agen mengubah perilaku, Truth Sync mengetahui tempat kebenaran terkait harus berada dan menjaga serah terima tetap dapat ditinjau.
|
|
138
128
|
|
|
139
|
-
|
|
129
|
+
### Kebenaran produk dan rekayasa di jalur terpisah
|
|
140
130
|
|
|
141
|
-
|
|
131
|
+
Kebenaran produk merekam janji kepada pengguna, batasan, keputusan, dan kriteria penerimaan. Kebenaran rekayasa merekam perilaku saat ini, kontrak, arsitektur, alur kerja, operasi, dan perilaku pengujian.
|
|
142
132
|
|
|
143
|
-
|
|
133
|
+
### Kolaborasi native Git
|
|
144
134
|
|
|
145
|
-
|
|
135
|
+
Semua yang penting berada dalam file repositori yang di-commit. Kebenaran mengikuti branch, bekerja dengan pull request biasa, dan tetap terlihat oleh setiap pemelihara serta agen pengodean.
|
|
146
136
|
|
|
147
|
-
|
|
137
|
+
### Operasi yang mengutamakan lokal
|
|
148
138
|
|
|
149
|
-
|
|
139
|
+
Truthmark tidak memerlukan layanan ter-host, daemon, basis data, penyimpanan vektor, atau server Model Context Protocol. Repositori membawa alur kerja dokumentasinya sendiri.
|
|
150
140
|
|
|
151
|
-
|
|
141
|
+
## Posisi Truthmark
|
|
152
142
|
|
|
153
|
-
|
|
143
|
+
| Kebutuhan | Pilihan terbaik |
|
|
144
|
+
| ------------------------------------------------- | ---------------------------- |
|
|
145
|
+
| Output yang lebih baik dari satu sesi agen | Prompt yang lebih baik |
|
|
146
|
+
| Kontinuitas pribadi atau tingkat sesi | Alat memori |
|
|
147
|
+
| Pekerjaan fitur yang dimulai dengan perencanaan | Alur kerja spesifikasi |
|
|
148
|
+
| Dokumentasi berlingkup branch yang mengikuti kode | **Truthmark** |
|
|
149
|
+
| Kebenaran perilaku | Pengujian dan tinjauan kode |
|
|
150
|
+
| Dokumentasi berbantuan AI yang dapat ditinjau | **Truthmark + tinjauan Git** |
|
|
154
151
|
|
|
155
|
-
Truthmark
|
|
152
|
+
Truthmark dibuat untuk pemelihara dan tim rekayasa yang sudah menggunakan agen pengodean AI dan ingin repositori terus menyampaikan kebenaran secepat kode berubah.
|
|
156
153
|
|
|
157
|
-
|
|
154
|
+
## Host yang didukung dan baris perintah
|
|
158
155
|
|
|
159
|
-
|
|
160
|
-
- serah terima yang lebih baik
|
|
161
|
-
- kebenaran produk khusus branch
|
|
162
|
-
- dokumentasi arsitektur dan API yang tahan lama
|
|
163
|
-
- kepemilikan eksplisit antara dokumen dan kode
|
|
164
|
-
- batas tulis agen yang lebih aman
|
|
165
|
-
- dokumentasi yang dapat ditinjau alih-alih memori tersembunyi
|
|
166
|
-
- alur kerja AI yang tetap bekerja dari file repositori yang di-commit
|
|
156
|
+
Host agen yang didukung:
|
|
167
157
|
|
|
168
|
-
|
|
158
|
+
- Codex
|
|
159
|
+
- Claude Code
|
|
160
|
+
- GitHub Copilot
|
|
161
|
+
- OpenCode
|
|
162
|
+
- Antigravity
|
|
163
|
+
- Cursor
|
|
169
164
|
|
|
170
|
-
|
|
165
|
+
<details>
|
|
166
|
+
<summary>Referensi baris perintah</summary>
|
|
171
167
|
|
|
172
|
-
|
|
168
|
+
| Perintah | Tujuan |
|
|
169
|
+
| ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
|
|
170
|
+
| `truthmark init` | Membuat atau menyegarkan konfigurasi, perutean, template, dan alur kerja host yang dipilih |
|
|
171
|
+
| `truthmark check [--base <ref>]` | Memvalidasi kebenaran repositori dan secara opsional menjalankan diagnostik kesegaran branch |
|
|
172
|
+
| `truthmark index --json` | Memeriksa metadata turunan repositori dan perutean |
|
|
173
|
+
| `truthmark impact --base <ref> --json` | Memetakan file yang berubah ke dokumentasi, pemilik, dan pengujian terdekat |
|
|
174
|
+
| `truthmark workflow status --workflow <id> [--base <ref>] --json` | Memeriksa penerapan dan target alur kerja |
|
|
175
|
+
| `truthmark validate ...` | Memvalidasi laporan alur kerja dan sewa penulisan |
|
|
176
|
+
| `truthmark uninstall --dry-run\|--apply` | Meninjau atau menghapus permukaan host yang dihasilkan sambil mempertahankan truth yang ditulis pengguna |
|
|
173
177
|
|
|
174
|
-
|
|
175
|
-
| --- | --- |
|
|
176
|
-
| Output lebih baik dari satu sesi agen | Prompt yang lebih baik |
|
|
177
|
-
| Kontinuitas pribadi atau tingkat sesi | Alat memori |
|
|
178
|
-
| Pekerjaan fitur yang dimulai dengan rencana | Alur kerja spesifikasi |
|
|
179
|
-
| Truth berlingkup branch yang ikut bersama kode | Truthmark |
|
|
180
|
-
| Memvalidasi kebenaran perilaku | Pengujian dan tinjauan |
|
|
181
|
-
| Meninjau perubahan dokumentasi berbantuan AI | Truthmark plus tinjauan Git |
|
|
178
|
+
Output JSON terstruktur tersedia di seluruh antarmuka baris perintah untuk skrip dan integrasi berkelanjutan.
|
|
182
179
|
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
```text
|
|
186
|
-
make repository truth explicit
|
|
187
|
-
route it to code
|
|
188
|
-
memasang panduan agen di sekelilingnya
|
|
189
|
-
keep the result reviewable in Git
|
|
190
|
-
```
|
|
180
|
+
</details>
|
|
191
181
|
|
|
192
|
-
## Pelajari lebih
|
|
182
|
+
## Pelajari lebih lanjut
|
|
193
183
|
|
|
194
|
-
|
|
184
|
+
- [Panduan pengguna Truthmark](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md)
|
|
185
|
+
- [Indeks dokumentasi](https://github.com/merlinhu1/truthmark/blob/main/docs/README.md)
|
|
186
|
+
- [Ikhtisar arsitektur](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/architecture/overview.md)
|
|
187
|
+
- [Kontrak konfigurasi, perutean, dan perintah](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
|
|
188
|
+
- [Berkontribusi](https://github.com/merlinhu1/truthmark/blob/main/CONTRIBUTING.md)
|
|
195
189
|
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
## Status proyek
|
|
199
|
-
|
|
200
|
-
Rilis saat ini menyediakan:
|
|
201
|
-
|
|
202
|
-
- perintah CLI lokal untuk config, init, check, index, impact, dan status alur kerja
|
|
203
|
-
- instruksi agen lokal repositori yang dihasilkan untuk Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, dan Cursor
|
|
204
|
-
- diagnostik perutean, otoritas, frontmatter, tautan, kesegaran, permukaan yang dihasilkan, cakupan branch, dan coverage
|
|
205
|
-
- dokumen kebenaran berlingkup branch dan artefak kecerdasan repositori turunan
|
|
206
|
-
|
|
207
|
-
## Dokumentasi
|
|
208
|
-
|
|
209
|
-
- [Panduan pengguna](../user-guide.md)
|
|
210
|
-
- [Indeks dokumen](../README.md)
|
|
211
|
-
- [Ikhtisar arsitektur](../truthmark/engineering/architecture/overview.md)
|
|
212
|
-
- [Kontrak API dan CLI](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
|
|
213
|
-
- [Panduan pemeliharaan kebenaran repositori](../standards/maintaining-repository-truth.md)
|
|
214
|
-
|
|
215
|
-
Untuk perintah pengembangan lokal dan kontribusi, lihat [CONTRIBUTING.md](../../CONTRIBUTING.md).
|
|
216
|
-
|
|
217
|
-
## Batas desain
|
|
218
|
-
|
|
219
|
-
Truthmark sengaja kecil: lokal, di-commit, berlingkup branch, dan dapat ditinjau.
|
|
220
|
-
|
|
221
|
-
Ini bukan layanan ter-host, server MCP, basis data vektor, lapisan memori tersembunyi, produk penegakan CI, atau mesin penulisan ulang kode otonom. Ini membantu kebenaran repositori tetap terlihat; tidak menggantikan pengujian, tinjauan kode, atau penilaian manusia.
|
|
190
|
+
**Pasang Truthmark, pilih host pengodean Anda, dan ubah satu perilaku nyata menjadi dokumentasi hari ini.**
|
|
222
191
|
|
|
223
192
|
## Lisensi
|
|
224
193
|
|
|
225
194
|
MIT. Lihat [LICENSE](../../LICENSE).
|
|
226
|
-
|
|
227
|
-
## Penghapusan aman
|
|
228
|
-
|
|
229
|
-
Gunakan `truthmark uninstall --dry-run` untuk meninjau permukaan host yang tepat dihasilkan, lalu `truthmark uninstall --apply` untuk menghapusnya. Truth hasil penulisan, konfigurasi, template, keluaran Portal, berkas Gemini, dan berkas pengguna yang tidak terkait akan tetap dipertahankan; hapus instalasi npm global secara terpisah melalui pengelola paket Anda.
|