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
|
-
**Twoi agenci piszą kod. Truthmark
|
|
3
|
+
**Twoi agenci piszą kod. Truthmark dba o dokumentację dla ludzi, gotową do przeglądu w Git.**
|
|
4
|
+
|
|
5
|
+
Truthmark instaluje natywne dla Git przepływy pracy, dzięki którym agenci programistyczni AI tworzą nową dokumentację produktu i inżynierii na podstawie istniejącego kodu i testów, aktualizują ją po każdej zmianie kodu oraz przekazują Ci zwykłe diffy Markdown do przeglądu.
|
|
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
|
+
[Zacznij](#szybki-start-utwórz-swój-pierwszy-dokument-truth) · [Strona internetowa](https://merlinhu1.github.io/truthmark/) · [Przewodnik użytkownika](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md) · [GitHub](https://github.com/merlinhu1/truthmark)
|
|
13
|
+
|
|
14
|
+
<details>
|
|
15
|
+
<summary>Przeczytaj ten plik README w jednym z 16 języków</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
|
+
## Twórz dokumentację od podstaw. Dbaj, by pozostawała prawdziwa.
|
|
10
22
|
|
|
11
|
-
|
|
23
|
+
Większość narzędzi do dokumentacji kończy pracę po jej wygenerowaniu. Truthmark zapewnia agentom pełny cykl życia dokumentacji wewnątrz repozytorium:
|
|
12
24
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
25
|
+
- **Twórz nową dokumentację na podstawie działającego oprogramowania.** Truth Document odczytuje kod i testy, a następnie tworzy precyzyjnie ograniczoną dokumentację produktu lub inżynierii.
|
|
26
|
+
- **Automatycznie utrzymuj zgodność dokumentacji.** Truth Sync uruchamia się przy przekazaniu pracy przez agenta po zmianach kodu funkcjonalnego i aktualizuje prawdę repozytorium przed zakończeniem zadania.
|
|
27
|
+
- **Zamieniaj dokumentację z powrotem w kod.** Truth Realize implementuje zatwierdzone dokumenty truth, zachowując przejrzysty przepływ pracy doc-first.
|
|
28
|
+
- **Naprawiaj własność wraz z rozwojem bazy kodu.** Truth Structure tworzy precyzyjne trasy i dokumenty startowe dla nowych lub przeciążonych obszarów.
|
|
29
|
+
- **Przeglądaj wszystko w Git.** Kod, decyzje, kontrakty, architektura, operacje i zachowanie podążają razem z gałęzią.
|
|
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
|
+
Bez hostowanej bazy wiedzy. Bez prywatnej pamięci agenta. Bez dokumentacji uwięzionej w historii czatu.
|
|
31
32
|
|
|
32
|
-
|
|
33
|
+
## Szybki start: utwórz swój pierwszy dokument truth
|
|
34
|
+
|
|
35
|
+
**Wymagania:** Node.js 24 lub nowszy, repozytorium Git oraz obsługiwany host programistyczny AI do przepływów pracy agentów.
|
|
36
|
+
|
|
37
|
+
Uruchom poniższe polecenia w repozytorium, którym ma zarządzać 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` pozwala wybrać Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, Cursor albo konfigurację interfejsu wiersza poleceń niezależną od hosta.
|
|
46
|
+
|
|
47
|
+
Teraz poproś skonfigurowanego agenta o udokumentowanie jednego rzeczywistego zachowania:
|
|
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
|
-
Jeśli chcesz tylko walidacji CLI i nie potrzebujesz jeszcze workflow AI specyficznych dla hosta, pozostaw `platforms` pominięte i uruchom `truthmark init && truthmark check`; później możesz dodać platformę i ponownie uruchomić `truthmark init`.
|
|
49
|
-
|
|
50
|
-
## 💡 Problem: luka w dokumentacji AI
|
|
53
|
+
Truth Document tworzy nowy, precyzyjnie ograniczony dokument truth, jeśli taki jeszcze nie istnieje, aktualizuje istniejącego właściciela, gdy już istnieje, i w razie potrzeby aktualizuje routing. Nie zmienia kodu funkcjonalnego.
|
|
51
54
|
|
|
52
|
-
|
|
55
|
+
Przejrzyj rezultat:
|
|
53
56
|
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
## 🎯 Rozwiązanie: Truthmark
|
|
61
|
-
|
|
62
|
-
**Truthmark** instaluje w Twoim repozytorium warstwę workflow natywną dla Git. Naprawia tę część rozwoju z AI, która zwykle się psuje: pomaga utrzymać dokumentację w zgodzie z kodem.
|
|
63
|
-
|
|
64
|
-
Zamiast liczyć, że ludzie i agenci AI będą pamiętać o aktualizowaniu dokumentów, Truthmark zamienia dokumentację w systematyczny, możliwy do przeglądu nawyk wewnątrz repozytorium.
|
|
65
|
-
|
|
66
|
-
### ✨ Dlaczego Truthmark jest wyjątkowy
|
|
57
|
+
```bash
|
|
58
|
+
truthmark check
|
|
59
|
+
git status --short --untracked-files=all
|
|
60
|
+
git diff
|
|
61
|
+
```
|
|
67
62
|
|
|
68
|
-
|
|
63
|
+
Powinny teraz istnieć:
|
|
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
|
+
Dokładne ścieżki wynikają ze struktury własności w Twoim repozytorium. Nowe pliki pojawiają się w `git status`, a zmiany w śledzonych plikach — w `git diff`.
|
|
76
71
|
|
|
77
|
-
|
|
72
|
+
Sposób wywołania zależy od hosta. OpenCode używa `/skill truthmark-document`, Antigravity używa `@truthmark-document`, a pozostałe obsługiwane hosty korzystają ze swoich natywnych umiejętności lub poleceń z ukośnikiem. Dokładne polecenia znajdziesz w [tabeli platform](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md#supported-agent-platforms).
|
|
78
73
|
|
|
79
|
-
|
|
80
|
-
2. 🧪 **Test:** wykonywane są odpowiednie testy.
|
|
81
|
-
3. 🔍 **Sprawdzenie:** Truthmark sprawdza zmapowaną dokumentację jako część zainstalowanego końcowego przeglądu.
|
|
82
|
-
4. 📝 **Dokumentacja:** agent aktualizuje dokumenty, gdy truth repozytorium się zmieniła.
|
|
83
|
-
5. 👀 **Przegląd:** człowiek przegląda *diff kodu* + *diff truth*.
|
|
74
|
+
W skryptach i ciągłej integracji jawnie przekaż wybrane platformy:
|
|
84
75
|
|
|
85
|
-
|
|
76
|
+
```bash
|
|
77
|
+
truthmark init --platform codex --platform cursor
|
|
78
|
+
truthmark init --json
|
|
79
|
+
```
|
|
86
80
|
|
|
87
|
-
|
|
81
|
+
Wybierz interaktywnie `none` albo uruchom `truthmark init --clear-platforms`, aby uzyskać repozytorium niezależne od hosta. Platformy agentów możesz dodać później, ponownie uruchamiając `truthmark init`.
|
|
88
82
|
|
|
89
|
-
|
|
83
|
+
Aby uzyskać diagnostykę aktualności względem gałęzi, przekaż bazę Git:
|
|
90
84
|
|
|
91
|
-
|
|
85
|
+
```bash
|
|
86
|
+
truthmark check --base <base-ref>
|
|
87
|
+
```
|
|
92
88
|
|
|
93
|
-
|
|
94
|
-
* `truthmark init` - instaluje lub odświeża routing, szkielety truth-doc i instrukcje dla hostów AI.
|
|
95
|
-
* `truthmark check` - waliduje truth repozytorium z terminala.
|
|
89
|
+
## Jak działa 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="Jak działa Truthmark" width="1440">
|
|
94
|
+
</picture>
|
|
98
95
|
|
|
99
|
-
Truthmark instaluje
|
|
96
|
+
Interfejs wiersza poleceń Truthmark instaluje i sprawdza kontrakt repozytorium. Twój agent programistyczny analizuje dowody i wykonuje pracę dokumentacyjną za pomocą zainstalowanych, natywnych dla hosta przepływów pracy.
|
|
100
97
|
|
|
101
|
-
|
|
98
|
+
Typowa zmiana kodu przebiega w jednej prostej pętli:
|
|
102
99
|
|
|
103
|
-
1.
|
|
104
|
-
2.
|
|
105
|
-
3.
|
|
100
|
+
1. Agent zmienia kod funkcjonalny.
|
|
101
|
+
2. Uruchamiane są odpowiednie testy.
|
|
102
|
+
3. Truth Sync sprawdza zmapowaną dokumentację.
|
|
103
|
+
4. Gdy prawda repozytorium się zmieniła, agent tworzy lub aktualizuje dokumentację oraz routing.
|
|
104
|
+
5. Wspólnie przeglądasz diff kodu i diff dokumentów truth.
|
|
106
105
|
|
|
107
|
-
|
|
106
|
+
## Przepływy pracy
|
|
108
107
|
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
108
|
+
| Przepływ pracy | Kiedy go używać | Rezultat |
|
|
109
|
+
| -------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
|
|
110
|
+
| **Truth Document** | Istniejący kod wymaga dokumentacji | Tworzy lub aktualizuje opartą na dowodach dokumentację produktu i inżynierii |
|
|
111
|
+
| **Truth Sync** | Zmienił się kod funkcjonalny | Przed przekazaniem pracy utrzymuje zgodność zmapowanej dokumentacji i routingu |
|
|
112
|
+
| **Truth Structure** | Nowy obszar potrzebuje właściciela albo istniejąca dokumentacja jest zbyt szeroka | Tworzy precyzyjne trasy i szkieletowe dokumenty startowe |
|
|
113
|
+
| **Truth Realize** | Zatwierdzony dokument truth powinien stać się działającym oprogramowaniem | Aktualizuje kod funkcjonalny na podstawie dokumentacji |
|
|
114
|
+
| **Truth Check** | Prawda repozytorium wymaga audytu | Zgłasza problemy z routingiem, własnością, dowodami i dokumentacją |
|
|
115
|
+
| **Truthmark Portal** | Zespół potrzebuje witryny z dokumentacją do wygodnego przeglądania | Generuje zatwierdzoną statyczną prezentację HTML z dokumentów truth w Markdown |
|
|
112
116
|
|
|
113
|
-
|
|
114
|
-
Truth Structure nie jest codzienną komendą; naprawia routing lub własność tylko wtedy, gdy blokuje to pracę.
|
|
117
|
+
Truthmark instaluje te przepływy pracy jako natywne powierzchnie repozytorium dla Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity i Cursor.
|
|
115
118
|
|
|
116
119
|
## Co otrzymujesz
|
|
117
120
|
|
|
118
|
-
|
|
119
|
-
| --- | --- |
|
|
120
|
-
| Truth natywny dla Git | Utrzymuje truth repozytorium w zatwierdzonych plikach Markdown i konfiguracji. |
|
|
121
|
-
| Dokumentacja w zakresie gałęzi | Truth porusza się z gałęzią zamiast mieszkać w prywatnej sesji. |
|
|
122
|
-
| CLI dla ludzi | Daje opiekunom komendy konfiguracji, odświeżania, walidacji i inspekcji. |
|
|
123
|
-
| Zainstalowana instrukcja agenta | Mówi agentom kodującym, kiedy dokumentować, testować, synchronizować truth, audytować lub zatrzymać się do przeglądu. |
|
|
124
|
-
| Jawny routing | Mapuje obszary kodu na kanoniczne dokumenty truth. |
|
|
125
|
-
| Przekazania możliwe do przeglądu | Tworzy zwykłe diffy Git zarówno dla kodu, jak i dokumentów truth. |
|
|
126
|
-
| Działanie local-first | Nie wymaga hostowanej usługi, demona, bazy danych ani serwera MCP. |
|
|
127
|
-
| Bezpieczniejsze granice zapisu | Rozdziela workflow code-first, doc-first, read-only i doc-only. |
|
|
128
|
-
| Walidacja | Raportuje problemy z routingiem, uprawnieniami, frontmatter, linkami, wygenerowaną powierzchnią, zakresem gałęzi, świeżością i pokryciem. |
|
|
129
|
-
| Opcjonalny Portal | Generuje zatwierdzoną statyczną witrynę prezentacyjną HTML z dokumentów truth w Markdown, gdy jest wyraźnie włączony i zażądany. |
|
|
130
|
-
|
|
131
|
-
## Przegląd wizualny
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
**Funkcje:** co Truthmark instaluje i jak podzielona jest powierzchnia workflow.
|
|
136
|
-
|
|
137
|
-
|
|
121
|
+
### Dokumentację, która zaczyna od rzeczywistości
|
|
138
122
|
|
|
139
|
-
|
|
123
|
+
Truthmark potrafi tworzyć dokumentację możliwości produktu, zachowania implementacji, interfejsów programistycznych aplikacji, architektury, przepływów pracy, operacji i testów. Kod i testy dostarczają dowodów, a precyzyjnie ograniczone dokumenty Markdown utrwalają wynik.
|
|
140
124
|
|
|
141
|
-
|
|
125
|
+
### Dokumentację, która przetrwa kolejną zmianę
|
|
142
126
|
|
|
143
|
-
|
|
127
|
+
Trasy łączą obszary kodu z kanonicznymi dokumentami. Kiedy agenci zmieniają zachowanie, Truth Sync wie, gdzie należy zapisać odpowiadającą mu prawdę, i utrzymuje przekazanie pracy w formie gotowej do przeglądu.
|
|
144
128
|
|
|
145
|
-
|
|
129
|
+
### Prawdę produktu i inżynierii w osobnych obszarach
|
|
146
130
|
|
|
147
|
-
|
|
131
|
+
Prawda produktu obejmuje obietnice dla użytkowników, granice, decyzje i kryteria akceptacji. Prawda inżynierii obejmuje bieżące zachowanie, kontrakty, architekturę, przepływy pracy, operacje oraz zachowanie testów.
|
|
148
132
|
|
|
149
|
-
|
|
133
|
+
### Współpracę natywną dla Git
|
|
150
134
|
|
|
151
|
-
|
|
135
|
+
Wszystko, co ważne, znajduje się w zatwierdzonych plikach repozytorium. Prawda podąża za gałęzią, współpracuje ze zwykłymi pull requestami i pozostaje widoczna dla każdego opiekuna oraz agenta programistycznego.
|
|
152
136
|
|
|
153
|
-
|
|
137
|
+
### Działanie local-first
|
|
154
138
|
|
|
155
|
-
Truthmark
|
|
156
|
-
|
|
157
|
-
Jest przydatny, gdy potrzebujesz:
|
|
158
|
-
|
|
159
|
-
- mniejszego rozjazdu dokumentacji
|
|
160
|
-
- lepszych przekazań pracy
|
|
161
|
-
- truth produktu specyficznego dla gałęzi
|
|
162
|
-
- trwałej dokumentacji architektury i API
|
|
163
|
-
- jawnej własności między dokumentami a kodem
|
|
164
|
-
- bezpieczniejszych granic zapisu dla agentów
|
|
165
|
-
- dokumentacji możliwej do przeglądu zamiast ukrytej pamięci
|
|
166
|
-
- instrukcje agenta, które nadal działają z commitowanych plików repozytorium
|
|
139
|
+
Truthmark nie potrzebuje hostowanej usługi, demona, bazy danych, magazynu wektorowego ani serwera Model Context Protocol. Repozytorium zawiera własny przepływ pracy dokumentacyjnej.
|
|
167
140
|
|
|
168
141
|
## Gdzie pasuje Truthmark
|
|
169
142
|
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
143
|
+
| Potrzeba | Najlepsze rozwiązanie |
|
|
144
|
+
| ----------------------------------------------------- | ------------------------------ |
|
|
145
|
+
| Lepszy wynik z jednej sesji agenta | Lepszy prompt |
|
|
146
|
+
| Ciągłość osobista lub na poziomie sesji | Narzędzie pamięci |
|
|
147
|
+
| Praca nad funkcją rozpoczynana od planu | Przepływ pracy specyfikacji |
|
|
148
|
+
| Dokumentacja w zakresie gałęzi, która podąża za kodem | **Truthmark** |
|
|
149
|
+
| Poprawność zachowania | Testy i przegląd kodu |
|
|
150
|
+
| Dokumentacja wspierana przez AI i gotowa do przeglądu | **Truthmark + przegląd w Git** |
|
|
173
151
|
|
|
174
|
-
|
|
175
|
-
| --- | --- |
|
|
176
|
-
| Lepszy wynik z jednej sesji agenta | Lepszy prompt |
|
|
177
|
-
| Ciągłość osobista lub na poziomie sesji | Narzędzie pamięci |
|
|
178
|
-
| Praca nad funkcją zaczynająca się od planu | Workflow specyfikacji |
|
|
179
|
-
| Truth w zakresie gałęzi, która podróżuje z kodem | Truthmark |
|
|
180
|
-
| Walidacja poprawności zachowania | Testy i przegląd |
|
|
181
|
-
| Przegląd zmian dokumentacji wspieranych przez AI | Truthmark plus przegląd Git |
|
|
152
|
+
Truthmark powstał dla opiekunów i zespołów inżynierskich, które już korzystają z agentów programistycznych AI i chcą, aby repozytorium nadążało z prawdą za każdą zmianą kodu.
|
|
182
153
|
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
```text
|
|
186
|
-
make repository truth explicit
|
|
187
|
-
route it to code
|
|
188
|
-
zainstalować wokół niej instrukcje agenta
|
|
189
|
-
keep the result reviewable in Git
|
|
190
|
-
```
|
|
154
|
+
## Obsługiwane hosty i wiersz poleceń
|
|
191
155
|
|
|
192
|
-
|
|
156
|
+
Obsługiwane hosty agentów:
|
|
193
157
|
|
|
194
|
-
|
|
158
|
+
- Codex
|
|
159
|
+
- Claude Code
|
|
160
|
+
- GitHub Copilot
|
|
161
|
+
- OpenCode
|
|
162
|
+
- Antigravity
|
|
163
|
+
- Cursor
|
|
195
164
|
|
|
196
|
-
|
|
165
|
+
<details>
|
|
166
|
+
<summary>Dokumentacja wiersza poleceń</summary>
|
|
197
167
|
|
|
198
|
-
|
|
168
|
+
| Polecenie | Zastosowanie |
|
|
169
|
+
| ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
|
|
170
|
+
| `truthmark init` | Tworzy lub odświeża konfigurację, routing, szablony i przepływy pracy wybranych hostów |
|
|
171
|
+
| `truthmark check [--base <ref>]` | Sprawdza prawdę repozytorium i opcjonalnie uruchamia diagnostykę aktualności gałęzi |
|
|
172
|
+
| `truthmark index --json` | Wyświetla pochodne metadane repozytorium i routingu |
|
|
173
|
+
| `truthmark impact --base <ref> --json` | Mapuje zmienione pliki na dokumentację, właścicieli i pobliskie testy |
|
|
174
|
+
| `truthmark workflow status --workflow <id> [--base <ref>] --json` | Wyświetla zastosowanie przepływu pracy i jego cele |
|
|
175
|
+
| `truthmark validate ...` | Sprawdza raporty przepływów pracy i dzierżawy zapisu |
|
|
176
|
+
| `truthmark uninstall --dry-run\|--apply` | Wyświetla podgląd lub usuwa wygenerowane powierzchnie hosta, zachowując utworzone dokumenty truth |
|
|
199
177
|
|
|
200
|
-
|
|
178
|
+
Strukturyzowane dane wyjściowe JSON są dostępne w całym interfejsie wiersza poleceń na potrzeby skryptów i ciągłej integracji.
|
|
201
179
|
|
|
202
|
-
|
|
203
|
-
- wygenerowane lokalne instrukcje agenta dla Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity i Cursor
|
|
204
|
-
- diagnostykę route, authority, frontmatter, link, freshness, generated-surface, branch-scope i coverage
|
|
205
|
-
- dokumenty truth w zakresie gałęzi oraz pochodne artefakty inteligencji repozytorium
|
|
180
|
+
</details>
|
|
206
181
|
|
|
207
|
-
##
|
|
182
|
+
## Dowiedz się więcej
|
|
208
183
|
|
|
209
|
-
- [Przewodnik użytkownika](
|
|
210
|
-
- [Indeks dokumentacji](
|
|
211
|
-
- [Przegląd architektury](
|
|
212
|
-
- [Kontrakty
|
|
213
|
-
- [
|
|
184
|
+
- [Przewodnik użytkownika Truthmark](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md)
|
|
185
|
+
- [Indeks dokumentacji](https://github.com/merlinhu1/truthmark/blob/main/docs/README.md)
|
|
186
|
+
- [Przegląd architektury](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/architecture/overview.md)
|
|
187
|
+
- [Kontrakty konfiguracji, routingu i poleceń](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
|
|
188
|
+
- [Współtworzenie](https://github.com/merlinhu1/truthmark/blob/main/CONTRIBUTING.md)
|
|
214
189
|
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
## Granice projektu
|
|
218
|
-
|
|
219
|
-
Truthmark jest celowo mały: lokalny, zatwierdzony, ograniczony do gałęzi i możliwy do przeglądu.
|
|
220
|
-
|
|
221
|
-
Nie jest usługą hostowaną, serwerem MCP, wektorową bazą danych, ukrytą warstwą pamięci, produktem wymuszającym CI ani autonomicznym silnikiem przepisywania kodu. Pomaga utrzymać widoczność truth repozytorium; nie zastępuje testów, przeglądu kodu ani ludzkiego osądu.
|
|
190
|
+
**Zainstaluj Truthmark, wybierz host programistyczny i już dziś zamień jedno rzeczywiste zachowanie w dokumentację.**
|
|
222
191
|
|
|
223
192
|
## Licencja
|
|
224
193
|
|
|
225
194
|
MIT. Zobacz [LICENSE](../../LICENSE).
|
|
226
|
-
|
|
227
|
-
## Bezpieczne usuwanie
|
|
228
|
-
|
|
229
|
-
Użyj `truthmark uninstall --dry-run`, aby przejrzeć dokładnie wygenerowane powierzchnie hosta, a następnie `truthmark uninstall --apply`, aby je usunąć. Utworzone truth, konfiguracja, szablony, wyjście Portalu, pliki Gemini i niezwiązane pliki użytkownika są zachowane; globalną instalację npm usuń oddzielnie za pomocą swojego menedżera pakietów.
|