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