truthmark 2.3.0 → 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 -157
- package/dist/main.js +198 -44
- package/dist/main.js.map +1 -1
- package/docs/README.md +45 -33
- package/docs/assets/truthmark-workflow-mobile.svg +118 -0
- package/docs/assets/truthmark-workflow.svg +182 -0
- package/docs/readmes/README.ar.md +125 -151
- package/docs/readmes/README.de.md +127 -153
- package/docs/readmes/README.el.md +127 -153
- package/docs/readmes/README.es.md +125 -151
- package/docs/readmes/README.fr.md +125 -151
- package/docs/readmes/README.id.md +126 -152
- package/docs/readmes/README.it.md +125 -151
- package/docs/readmes/README.ja.md +126 -152
- package/docs/readmes/README.ko.md +127 -153
- package/docs/readmes/README.pl.md +125 -151
- package/docs/readmes/README.pt.md +126 -152
- package/docs/readmes/README.ru.md +124 -150
- package/docs/readmes/README.tr.md +125 -151
- package/docs/readmes/README.vi.md +126 -152
- package/docs/readmes/README.zh.md +128 -154
- package/package.json +3 -1
|
@@ -1,220 +1,194 @@
|
|
|
1
1
|
# Truthmark
|
|
2
2
|
|
|
3
|
-
**Οι πράκτορές σας γράφουν κώδικα. Το Truthmark διατηρεί τεκμηρίωση
|
|
3
|
+
**Οι πράκτορές σας γράφουν κώδικα. Το Truthmark διατηρεί την τεκμηρίωση για ανθρώπους, έτοιμη για έλεγχο στο Git.**
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
## 🚀 Γρήγορη εκκίνηση: τοπική εκτέλεση σε πέντε λεπτά
|
|
10
|
-
|
|
11
|
-
Εκτελέστε το μέσα στο αποθετήριο Git που θέλετε να διαχειρίζεται το Truthmark:
|
|
12
|
-
|
|
13
|
-
```bash
|
|
14
|
-
cd /path/to/your-repo
|
|
15
|
-
npm install -g truthmark
|
|
16
|
-
truthmark init
|
|
17
|
-
truthmark check
|
|
18
|
-
git diff
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
Σε διαδραστικό τερματικό, το `truthmark init` εμφανίζει αριθμημένη πολλαπλή επιλογή. Επιλέξτε μηδέν ή περισσότερες πλατφόρμες ή εισαγάγετε `none` για ρύθμιση ουδέτερη ως προς τον host και μόνο με CLI.
|
|
5
|
+
Το Truthmark εγκαθιστά ροές εργασίας εγγενείς στο Git, ώστε οι πράκτορες προγραμματισμού AI να δημιουργούν νέα τεκμηρίωση προϊόντος και μηχανικής από υπάρχοντα κώδικα και tests, να τη διατηρούν ενημερωμένη μετά από κάθε αλλαγή κώδικα και να σας παραδίδουν συνηθισμένα Markdown diffs για έλεγχο.
|
|
22
6
|
|
|
23
|
-
|
|
7
|
+
[](https://www.npmjs.com/package/truthmark)
|
|
8
|
+
[](https://github.com/merlinhu1/truthmark/actions/workflows/ci.yml)
|
|
9
|
+
[](../../LICENSE)
|
|
10
|
+
[](../../package.json)
|
|
24
11
|
|
|
25
|
-
|
|
26
|
-
truthmark init --platform codex --platform cursor
|
|
27
|
-
truthmark init --json
|
|
28
|
-
```
|
|
12
|
+
[Ξεκινήστε](#γρήγορη-εκκίνηση-δημιουργήστε-το-πρώτο-έγγραφο-truth) · [Ιστότοπος](https://merlinhu1.github.io/truthmark/) · [Οδηγός χρήστη](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md) · [GitHub](https://github.com/merlinhu1/truthmark)
|
|
29
13
|
|
|
30
|
-
|
|
14
|
+
<details>
|
|
15
|
+
<summary>Διαβάστε αυτό το README σε μία από 16 γλώσσες</summary>
|
|
31
16
|
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
```text
|
|
35
|
-
/truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
|
|
36
|
-
```
|
|
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)
|
|
37
18
|
|
|
38
|
-
|
|
19
|
+
</details>
|
|
39
20
|
|
|
40
|
-
|
|
21
|
+
## Δημιουργήστε την πρώτη τεκμηρίωση. Διατηρήστε την ακριβή.
|
|
41
22
|
|
|
42
|
-
|
|
23
|
+
Τα περισσότερα εργαλεία τεκμηρίωσης σταματούν μετά τη δημιουργία περιεχομένου. Το Truthmark προσφέρει στους πράκτορες έναν πλήρη κύκλο ζωής τεκμηρίωσης μέσα στο αποθετήριό σας:
|
|
43
24
|
|
|
44
|
-
|
|
25
|
+
- **Δημιουργήστε νέα τεκμηρίωση από λογισμικό που λειτουργεί.** Το Truth Document διαβάζει κώδικα και tests και έπειτα δημιουργεί τεκμηρίωση προϊόντος ή μηχανικής με σαφή όρια.
|
|
26
|
+
- **Διατηρήστε αυτόματα ευθυγραμμισμένη την τεκμηρίωση.** Το Truth Sync εκτελείται κατά την παράδοση του πράκτορα μετά από αλλαγές λειτουργικού κώδικα και ενημερώνει την αλήθεια του αποθετηρίου πριν ολοκληρωθεί η εργασία.
|
|
27
|
+
- **Μετατρέψτε την τεκμηρίωση ξανά σε κώδικα.** Το Truth Realize υλοποιεί εγκεκριμένα έγγραφα truth, διατηρώντας μια καθαρή ροή εργασίας doc-first.
|
|
28
|
+
- **Αποκαταστήστε την ιδιοκτησία καθώς μεγαλώνει η βάση κώδικα.** Το Truth Structure δημιουργεί διαδρομές με σαφή όρια και αρχικά έγγραφα για νέες ή υπερφορτωμένες περιοχές.
|
|
29
|
+
- **Ελέγξτε τα πάντα στο Git.** Κώδικας, αποφάσεις, συμβόλαια, αρχιτεκτονική, λειτουργίες και συμπεριφορά ταξιδεύουν μαζί με το branch.
|
|
45
30
|
|
|
46
|
-
|
|
47
|
-
* Τα έγγραφα αρχιτεκτονικής μένουν γρήγορα πίσω.
|
|
48
|
-
* Οι αποφάσεις προϊόντος εξαφανίζονται μετά την παράδοση.
|
|
49
|
-
* Οι reviewers κώδικα μένουν να εξετάζουν ωμά code diffs χωρίς να καταλαβαίνουν το «γιατί».
|
|
50
|
-
* Κάθε νέα AI session αναγκάζεται να ανακαλύψει ξανά την αλήθεια του αποθετηρίου σας από την αρχή.
|
|
31
|
+
Χωρίς φιλοξενούμενη βάση γνώσης. Χωρίς ιδιωτική μνήμη πράκτορα. Χωρίς τεκμηρίωση παγιδευμένη στο ιστορικό συνομιλιών.
|
|
51
32
|
|
|
52
|
-
##
|
|
33
|
+
## Γρήγορη εκκίνηση: δημιουργήστε το πρώτο έγγραφο truth
|
|
53
34
|
|
|
54
|
-
|
|
35
|
+
**Απαιτήσεις:** Node.js 24 ή νεότερο, ένα αποθετήριο Git και ένας υποστηριζόμενος host προγραμματισμού AI για ροές εργασίας πρακτόρων.
|
|
55
36
|
|
|
56
|
-
|
|
37
|
+
Εκτελέστε τις παρακάτω εντολές μέσα στο αποθετήριο που θέλετε να διαχειρίζεται το Truthmark:
|
|
57
38
|
|
|
58
|
-
|
|
39
|
+
```bash
|
|
40
|
+
cd /path/to/your-repo
|
|
41
|
+
npm install -g truthmark
|
|
42
|
+
truthmark init
|
|
43
|
+
```
|
|
59
44
|
|
|
60
|
-
Το
|
|
45
|
+
Το `truthmark init` σάς επιτρέπει να επιλέξετε Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, Cursor ή μια ρύθμιση διεπαφής γραμμής εντολών ανεξάρτητη από host.
|
|
61
46
|
|
|
62
|
-
|
|
63
|
-
* **🌳 100% Git-native:** Όλα ζουν στο αποθετήριό σας. Η αλήθεια κινείται μαζί με το branch σας.
|
|
64
|
-
* **🤝 Συμβόλαιο που ανήκει σε ανθρώπους και ακολουθείται από agents:** Οι συντηρητές κατέχουν το συμβόλαιο του αποθετηρίου· οι agents ακολουθούν τις εγκατεστημένες οδηγίες ενώ γράφουν κώδικα.
|
|
65
|
-
* **✅ Εμπιστοσύνη μέσω επαλήθευσης:** Η εργασία AI γίνεται ευκολότερο να εμπιστευτεί, επειδή η εργασία που αλλάζει συμπεριφορά περιλαμβάνει μια απόφαση ή ένα diff εγγράφου αλήθειας που μπορεί να ελεγχθεί από άνθρωπο.
|
|
47
|
+
Τώρα ζητήστε από τον διαμορφωμένο πράκτορά σας να τεκμηριώσει μία πραγματική συμπεριφορά:
|
|
66
48
|
|
|
67
|
-
|
|
49
|
+
```text
|
|
50
|
+
/truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
|
|
51
|
+
```
|
|
68
52
|
|
|
69
|
-
|
|
53
|
+
Το Truth Document δημιουργεί ένα νέο έγγραφο truth με σαφή όρια όταν δεν υπάρχει ήδη, ενημερώνει τον υπάρχοντα ιδιοκτήτη όταν υπάρχει και ενημερώνει τη δρομολόγηση όταν χρειάζεται. Δεν αλλάζει λειτουργικό κώδικα.
|
|
70
54
|
|
|
71
|
-
|
|
72
|
-
2. 🧪 **Test:** Εκτελούνται τα σχετικά tests.
|
|
73
|
-
3. 🔍 **Έλεγχος:** Το Truthmark ελέγχει τη χαρτογραφημένη τεκμηρίωση ως μέρος της εγκατεστημένης τελικής ανασκόπησης.
|
|
74
|
-
4. 📝 **Τεκμηρίωση:** Τα docs ενημερώνονται από τον πράκτορα όταν αλλάζει η αλήθεια του αποθετηρίου.
|
|
75
|
-
5. 👀 **Ανασκόπηση:** Ένας άνθρωπος ανασκοπεί το *code diff* + το *diff αλήθειας*.
|
|
55
|
+
Ελέγξτε το αποτέλεσμα:
|
|
76
56
|
|
|
77
|
-
|
|
57
|
+
```bash
|
|
58
|
+
truthmark check
|
|
59
|
+
git status --short --untracked-files=all
|
|
60
|
+
git diff
|
|
61
|
+
```
|
|
78
62
|
|
|
79
|
-
|
|
63
|
+
Τώρα θα πρέπει να έχετε:
|
|
80
64
|
|
|
81
|
-
|
|
65
|
+
```text
|
|
66
|
+
docs/truthmark/engineering/behaviors/session-timeout.md
|
|
67
|
+
docs/truthmark/routes/areas/authentication.md
|
|
68
|
+
```
|
|
82
69
|
|
|
83
|
-
Οι
|
|
70
|
+
Οι ακριβείς διαδρομές ακολουθούν τη δομή ιδιοκτησίας του αποθετηρίου σας. Τα νέα αρχεία εμφανίζονται στο `git status` και οι αλλαγές σε παρακολουθούμενα αρχεία στο `git diff`.
|
|
84
71
|
|
|
85
|
-
|
|
86
|
-
* `truthmark check` - επικυρώνει την αλήθεια του αποθετηρίου από το τερματικό.
|
|
72
|
+
Ο τρόπος κλήσης διαφέρει ανά host. Το OpenCode χρησιμοποιεί `/skill truthmark-document`, το Antigravity χρησιμοποιεί `@truthmark-document` και οι άλλοι υποστηριζόμενοι hosts χρησιμοποιούν τη δική τους εγγενή επιφάνεια skill ή slash command. Δείτε τον [πίνακα πλατφορμών](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md#supported-agent-platforms) για τις ακριβείς εντολές.
|
|
87
73
|
|
|
88
|
-
|
|
74
|
+
Για scripts και συνεχή ενοποίηση, δηλώστε ρητά τις επιλεγμένες πλατφόρμες:
|
|
89
75
|
|
|
90
|
-
|
|
76
|
+
```bash
|
|
77
|
+
truthmark init --platform codex --platform cursor
|
|
78
|
+
truthmark init --json
|
|
79
|
+
```
|
|
91
80
|
|
|
92
|
-
|
|
81
|
+
Επιλέξτε διαδραστικά `none` ή εκτελέστε `truthmark init --clear-platforms` για ένα αποθετήριο ανεξάρτητο από host. Μπορείτε να προσθέσετε πλατφόρμες πρακτόρων αργότερα, εκτελώντας ξανά το `truthmark init`.
|
|
93
82
|
|
|
94
|
-
|
|
95
|
-
2. Οι εγκατεστημένες οδηγίες λένε στον agent πότε να δοκιμάσει, πότε να ενημερώσει truth docs και πότε να σταματήσει για ανθρώπινη ανασκόπηση.
|
|
96
|
-
3. Εσείς ελέγχετε κανονικά Git diffs: κώδικα και τυχόν αλλαγές σε truth docs.
|
|
83
|
+
Για διάγνωση ενημερότητας σε σχέση με το branch, δώστε μια βάση Git:
|
|
97
84
|
|
|
98
|
-
|
|
85
|
+
```bash
|
|
86
|
+
truthmark check --base <base-ref>
|
|
87
|
+
```
|
|
99
88
|
|
|
100
|
-
|
|
101
|
-
* `/truthmark-realize` - υλοποιεί κώδικα από υπάρχοντα truth docs.
|
|
102
|
-
* `/truthmark-check` - ελέγχει την αλήθεια του αποθετηρίου.
|
|
89
|
+
## Πώς λειτουργεί το Truthmark
|
|
103
90
|
|
|
104
|
-
|
|
105
|
-
|
|
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>
|
|
106
95
|
|
|
107
|
-
|
|
96
|
+
Η διεπαφή γραμμής εντολών του Truthmark εγκαθιστά και επικυρώνει το συμβόλαιο του αποθετηρίου. Ο πράκτορας προγραμματισμού σας εκτελεί την εξέταση αποδεικτικών στοιχείων και την εργασία τεκμηρίωσης μέσω των εγκατεστημένων, εγγενών ροών εργασίας του host.
|
|
108
97
|
|
|
109
|
-
|
|
110
|
-
| --- | --- |
|
|
111
|
-
| Git-native αλήθεια | Διατηρεί την αλήθεια του αποθετηρίου σε committed Markdown και config. |
|
|
112
|
-
| Τεκμηρίωση με scope branch | Η αλήθεια κινείται με το branch αντί να ζει σε ιδιωτική session. |
|
|
113
|
-
| Ανθρώπινο CLI | Δίνει στους συντηρητές εντολές setup, refresh, validation και inspection. |
|
|
114
|
-
| Εγκατεστημένη καθοδήγηση agent | Λέει στους coding agents πότε να τεκμηριώσουν, να δοκιμάσουν, να συγχρονίσουν truth, να κάνουν audit ή να σταματήσουν για review. |
|
|
115
|
-
| Ρητή δρομολόγηση | Αντιστοιχίζει περιοχές κώδικα σε κανονικά έγγραφα αλήθειας. |
|
|
116
|
-
| Ελέγξιμες παραδόσεις | Παράγει συνηθισμένα Git diffs τόσο για κώδικα όσο και για έγγραφα αλήθειας. |
|
|
117
|
-
| Local-first λειτουργία | Δεν απαιτεί hosted service, daemon, βάση δεδομένων ή MCP server. |
|
|
118
|
-
| Ασφαλέστερα όρια εγγραφής | Διαχωρίζει code-first, doc-first, read-only και doc-only workflows. |
|
|
119
|
-
| Επικύρωση | Αναφέρει ζητήματα routing, authority, frontmatter, links, generated surfaces, branch scope, freshness και coverage. |
|
|
120
|
-
| Προαιρετικό Portal | Δημιουργεί ένα committed στατικό HTML presentation site από έγγραφα αλήθειας Markdown όταν ενεργοποιηθεί και ζητηθεί ρητά. |
|
|
98
|
+
Μια συνηθισμένη αλλαγή κώδικα ακολουθεί έναν απλό κύκλο:
|
|
121
99
|
|
|
122
|
-
|
|
100
|
+
1. Ο πράκτορας αλλάζει λειτουργικό κώδικα.
|
|
101
|
+
2. Εκτελούνται τα σχετικά tests.
|
|
102
|
+
3. Το Truth Sync ελέγχει τη χαρτογραφημένη τεκμηρίωση.
|
|
103
|
+
4. Ο πράκτορας δημιουργεί ή ενημερώνει τεκμηρίωση και δρομολόγηση όταν έχει αλλάξει η αλήθεια του αποθετηρίου.
|
|
104
|
+
5. Ελέγχετε μαζί το diff κώδικα και το diff truth.
|
|
123
105
|
|
|
124
|
-
|
|
106
|
+
## Ροές εργασίας
|
|
125
107
|
|
|
126
|
-
|
|
108
|
+
| Ροή εργασίας | Πότε χρησιμοποιείται | Αποτέλεσμα |
|
|
109
|
+
| -------------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
|
|
110
|
+
| **Truth Document** | Ο υπάρχων κώδικας χρειάζεται τεκμηρίωση | Δημιουργεί ή ενημερώνει τεκμηρίωση προϊόντος και μηχανικής που βασίζεται σε αποδεικτικά στοιχεία |
|
|
111
|
+
| **Truth Sync** | Άλλαξε λειτουργικός κώδικας | Διατηρεί ευθυγραμμισμένα τη χαρτογραφημένη τεκμηρίωση και τη δρομολόγηση πριν από την παράδοση |
|
|
112
|
+
| **Truth Structure** | Μια νέα περιοχή χρειάζεται ιδιοκτησία ή η υπάρχουσα τεκμηρίωση είναι υπερβολικά ευρεία | Δημιουργεί διαδρομές με σαφή όρια και σκελετικά αρχικά έγγραφα |
|
|
113
|
+
| **Truth Realize** | Ένα εγκεκριμένο έγγραφο truth πρέπει να γίνει λογισμικό που λειτουργεί | Ενημερώνει λειτουργικό κώδικα από την τεκμηρίωση |
|
|
114
|
+
| **Truth Check** | Η αλήθεια του αποθετηρίου χρειάζεται έλεγχο | Αναφέρει ζητήματα δρομολόγησης, ιδιοκτησίας, αποδεικτικών στοιχείων και τεκμηρίωσης |
|
|
115
|
+
| **Truthmark Portal** | Η ομάδα θέλει έναν εύχρηστο ιστότοπο τεκμηρίωσης | Δημιουργεί μια committed στατική παρουσίαση HTML από έγγραφα truth σε Markdown |
|
|
127
116
|
|
|
128
|
-
|
|
117
|
+
Το Truthmark εγκαθιστά αυτές τις ροές εργασίας ως εγγενείς επιφάνειες αποθετηρίου για Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity και Cursor.
|
|
129
118
|
|
|
130
|
-
|
|
119
|
+
## Τι αποκτάτε
|
|
131
120
|
|
|
132
|
-
|
|
121
|
+
### Τεκμηρίωση που ξεκινά από την πραγματικότητα
|
|
133
122
|
|
|
134
|
-
|
|
123
|
+
Το Truthmark μπορεί να δημιουργήσει τεκμηρίωση για δυνατότητες προϊόντος, συμπεριφορά υλοποίησης, διεπαφές προγραμματισμού εφαρμογών, αρχιτεκτονική, ροές εργασίας, λειτουργίες και tests. Ο κώδικας και τα tests παρέχουν τα αποδεικτικά στοιχεία· τα έγγραφα Markdown με σαφή όρια διατηρούν το αποτέλεσμα.
|
|
135
124
|
|
|
136
|
-
|
|
125
|
+
### Τεκμηρίωση που αντέχει στην επόμενη αλλαγή
|
|
137
126
|
|
|
138
|
-
|
|
127
|
+
Οι διαδρομές συνδέουν περιοχές κώδικα με κανονικά έγγραφα. Όταν οι πράκτορες αλλάζουν συμπεριφορά, το Truth Sync γνωρίζει πού ανήκει η αντίστοιχη αλήθεια και διατηρεί την παράδοση ελέγξιμη.
|
|
139
128
|
|
|
140
|
-
|
|
129
|
+
### Αλήθεια προϊόντος και μηχανικής σε ξεχωριστές ροές
|
|
141
130
|
|
|
142
|
-
|
|
131
|
+
Η αλήθεια προϊόντος καταγράφει υποσχέσεις προς τους χρήστες, όρια, αποφάσεις και κριτήρια αποδοχής. Η αλήθεια μηχανικής καταγράφει την τρέχουσα συμπεριφορά, τα συμβόλαια, την αρχιτεκτονική, τις ροές εργασίας, τις λειτουργίες και τη συμπεριφορά των tests.
|
|
143
132
|
|
|
144
|
-
|
|
133
|
+
### Συνεργασία εγγενής στο Git
|
|
145
134
|
|
|
146
|
-
|
|
135
|
+
Όλα τα σημαντικά στοιχεία βρίσκονται σε committed αρχεία του αποθετηρίου. Η αλήθεια ακολουθεί το branch, συνεργάζεται με συνηθισμένα pull requests και παραμένει ορατή σε κάθε συντηρητή και πράκτορα προγραμματισμού.
|
|
147
136
|
|
|
148
|
-
|
|
137
|
+
### Τοπική λειτουργία κατά προτεραιότητα
|
|
149
138
|
|
|
150
|
-
|
|
151
|
-
- καλύτερες παραδόσεις
|
|
152
|
-
- αλήθεια προϊόντος ειδική ανά branch
|
|
153
|
-
- ανθεκτική τεκμηρίωση αρχιτεκτονικής και API
|
|
154
|
-
- ρητή ιδιοκτησία μεταξύ docs και code
|
|
155
|
-
- ασφαλέστερα όρια εγγραφής πρακτόρων
|
|
156
|
-
- ελέγξιμη τεκμηρίωση αντί για κρυφή μνήμη
|
|
157
|
-
- καθοδήγηση για agents που εξακολουθεί να λειτουργεί από committed αρχεία του repo
|
|
139
|
+
Το Truthmark δεν χρειάζεται φιλοξενούμενη υπηρεσία, daemon, βάση δεδομένων, διανυσματική αποθήκη ή διακομιστή Model Context Protocol. Το αποθετήριο μεταφέρει τη δική του ροή εργασίας τεκμηρίωσης.
|
|
158
140
|
|
|
159
141
|
## Πού ταιριάζει το Truthmark
|
|
160
142
|
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
|
166
|
-
|
|
|
167
|
-
|
|
|
168
|
-
|
|
|
169
|
-
| Feature work με σχέδιο πρώτα | Spec workflow |
|
|
170
|
-
| Αλήθεια με scope branch που ταξιδεύει με τον κώδικα | Truthmark |
|
|
171
|
-
| Επικύρωση ορθότητας συμπεριφοράς | Tests και review |
|
|
172
|
-
| Ανασκόπηση AI-assisted αλλαγών τεκμηρίωσης | Truthmark μαζί με Git review |
|
|
173
|
-
|
|
174
|
-
Η λωρίδα του Truthmark είναι σκόπιμα στενή:
|
|
143
|
+
| Ανάγκη | Καλύτερη επιλογή |
|
|
144
|
+
| ----------------------------------------------------------- | ------------------------------- |
|
|
145
|
+
| Καλύτερο αποτέλεσμα από μία συνεδρία πράκτορα | Καλύτερο prompt |
|
|
146
|
+
| Προσωπική συνέχεια ή συνέχεια σε επίπεδο συνεδρίας | Εργαλείο μνήμης |
|
|
147
|
+
| Εργασία σε λειτουργίες με πρώτο βήμα τον σχεδιασμό | Ροή εργασίας προδιαγραφών |
|
|
148
|
+
| Τεκμηρίωση με εύρος branch που ταξιδεύει μαζί με τον κώδικα | **Truthmark** |
|
|
149
|
+
| Ορθότητα συμπεριφοράς | Tests και έλεγχος κώδικα |
|
|
150
|
+
| Ελέγξιμη τεκμηρίωση με τη βοήθεια AI | **Truthmark + έλεγχος στο Git** |
|
|
175
151
|
|
|
176
|
-
|
|
177
|
-
make repository truth explicit
|
|
178
|
-
route it to code
|
|
179
|
-
εγκατάσταση καθοδήγησης για agents γύρω από αυτή
|
|
180
|
-
keep the result reviewable in Git
|
|
181
|
-
```
|
|
182
|
-
|
|
183
|
-
## Πηγαίνετε βαθύτερα
|
|
152
|
+
Το Truthmark έχει σχεδιαστεί για συντηρητές και ομάδες μηχανικής που χρησιμοποιούν ήδη πράκτορες προγραμματισμού AI και θέλουν το αποθετήριο να συνεχίζει να λέει την αλήθεια με την ίδια ταχύτητα που αλλάζει ο κώδικας.
|
|
184
153
|
|
|
185
|
-
|
|
154
|
+
## Υποστηριζόμενοι hosts και γραμμή εντολών
|
|
186
155
|
|
|
187
|
-
|
|
156
|
+
Υποστηριζόμενοι hosts πρακτόρων:
|
|
188
157
|
|
|
189
|
-
|
|
158
|
+
- Codex
|
|
159
|
+
- Claude Code
|
|
160
|
+
- GitHub Copilot
|
|
161
|
+
- OpenCode
|
|
162
|
+
- Antigravity
|
|
163
|
+
- Cursor
|
|
190
164
|
|
|
191
|
-
|
|
165
|
+
<details>
|
|
166
|
+
<summary>Αναφορά γραμμής εντολών</summary>
|
|
192
167
|
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
168
|
+
| Εντολή | Σκοπός |
|
|
169
|
+
| ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
|
|
170
|
+
| `truthmark init` | Δημιουργεί ή ανανεώνει τη διαμόρφωση, τη δρομολόγηση, τα πρότυπα και τις ροές εργασίας των επιλεγμένων hosts |
|
|
171
|
+
| `truthmark check [--base <ref>]` | Επικυρώνει την αλήθεια του αποθετηρίου και προαιρετικά εκτελεί διάγνωση ενημερότητας branch |
|
|
172
|
+
| `truthmark index --json` | Εξετάζει παράγωγα μεταδεδομένα αποθετηρίου και δρομολόγησης |
|
|
173
|
+
| `truthmark impact --base <ref> --json` | Χαρτογραφεί τα αλλαγμένα αρχεία σε τεκμηρίωση, ιδιοκτήτες και κοντινά tests |
|
|
174
|
+
| `truthmark workflow status --workflow <id> [--base <ref>] --json` | Εξετάζει τη δυνατότητα εφαρμογής και τους στόχους της ροής εργασίας |
|
|
175
|
+
| `truthmark validate ...` | Επικυρώνει αναφορές ροών εργασίας και άδειες εγγραφής |
|
|
176
|
+
| `truthmark uninstall --dry-run\|--apply` | Προεπισκοπεί ή αφαιρεί τις παραγόμενες επιφάνειες host, διατηρώντας τα έγγραφα truth που έχουν συνταχθεί |
|
|
197
177
|
|
|
198
|
-
|
|
178
|
+
Δομημένη έξοδος JSON είναι διαθέσιμη σε ολόκληρη τη διεπαφή γραμμής εντολών για scripts και συνεχή ενοποίηση.
|
|
199
179
|
|
|
200
|
-
|
|
201
|
-
- [Ευρετήριο docs](../README.md)
|
|
202
|
-
- [Επισκόπηση αρχιτεκτονικής](../truthmark/engineering/architecture/overview.md)
|
|
203
|
-
- [Συμβάσεις API και CLI](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
|
|
204
|
-
- [Οδηγός συντήρησης αλήθειας αποθετηρίου](../standards/maintaining-repository-truth.md)
|
|
180
|
+
</details>
|
|
205
181
|
|
|
206
|
-
|
|
182
|
+
## Μάθετε περισσότερα
|
|
207
183
|
|
|
208
|
-
|
|
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)
|
|
209
189
|
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
Δεν είναι hosted service, MCP server, vector database, κρυφό memory layer, προϊόν επιβολής CI ή αυτόνομη μηχανή επανεγγραφής κώδικα. Βοηθά την αλήθεια του αποθετηρίου να παραμένει ορατή· δεν αντικαθιστά tests, code review ή ανθρώπινη κρίση.
|
|
190
|
+
**Εγκαταστήστε το Truthmark, επιλέξτε τον host προγραμματισμού σας και μετατρέψτε σήμερα μία πραγματική συμπεριφορά σε τεκμηρίωση.**
|
|
213
191
|
|
|
214
192
|
## Άδεια
|
|
215
193
|
|
|
216
|
-
MIT. Δείτε [LICENSE](../../LICENSE).
|
|
217
|
-
|
|
218
|
-
## Ασφαλής κατάργηση
|
|
219
|
-
|
|
220
|
-
Χρησιμοποιήστε το `truthmark uninstall --dry-run` για να ελέγξετε τις ακριβώς παραγόμενες επιφάνειες host και στη συνέχεια το `truthmark uninstall --apply` για να τις αφαιρέσετε. Το δημιουργημένο truth, η διαμόρφωση, τα templates, η έξοδος του Portal, τα αρχεία Gemini και τα μη σχετιζόμενα αρχεία χρήστη διατηρούνται. Καταργήστε την παγκόσμια εγκατάσταση του npm ξεχωριστά με το εργαλείο διαχείρισης πακέτων σας.
|
|
194
|
+
MIT. Δείτε το [LICENSE](../../LICENSE).
|