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
|
-
**وكلاؤك يكتبون الكود.
|
|
3
|
+
**وكلاؤك يكتبون الكود. ويحافظ Truthmark على التوثيق الموجّه للبشر والقابل للمراجعة عبر Git.**
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
يثبّت Truthmark مسارات عمل أصلية لـ Git تتيح لوكلاء البرمجة بالذكاء الاصطناعي إنشاء توثيق جديد للمنتج والهندسة من الكود والاختبارات الموجودة، والحفاظ على حداثته بعد كل تغيير في الكود، وتسليمك فروق Markdown عادية لمراجعتها.
|
|
6
6
|
|
|
7
|
-
](https://www.npmjs.com/package/truthmark)
|
|
8
|
+
[](https://github.com/merlinhu1/truthmark/actions/workflows/ci.yml)
|
|
9
|
+
[](../../LICENSE)
|
|
10
|
+
[](../../package.json)
|
|
8
11
|
|
|
9
|
-
|
|
12
|
+
[ابدأ الآن](#البدء-السريع-أنشئ-أول-وثيقة-حقيقة) · [الموقع](https://merlinhu1.github.io/truthmark/) · [دليل المستخدم](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md) · [GitHub](https://github.com/merlinhu1/truthmark)
|
|
10
13
|
|
|
11
|
-
|
|
14
|
+
<details>
|
|
15
|
+
<summary>اقرأ ملف README هذا بـ 16 لغة</summary>
|
|
12
16
|
|
|
13
|
-
|
|
14
|
-
cd /path/to/your-repo
|
|
15
|
-
npm install -g truthmark
|
|
16
|
-
truthmark init
|
|
17
|
-
truthmark check
|
|
18
|
-
git diff
|
|
19
|
-
```
|
|
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)
|
|
20
18
|
|
|
21
|
-
|
|
19
|
+
</details>
|
|
22
20
|
|
|
23
|
-
|
|
21
|
+
## أنشئ الوثائق الأولى. وحافظ على صدقها.
|
|
24
22
|
|
|
25
|
-
|
|
26
|
-
truthmark init --platform codex --platform cursor
|
|
27
|
-
truthmark init --json
|
|
28
|
-
```
|
|
23
|
+
تتوقف معظم أدوات التوثيق بعد التوليد. أما Truthmark فيمنح الوكلاء دورة حياة كاملة للتوثيق داخل مستودعك:
|
|
29
24
|
|
|
30
|
-
|
|
25
|
+
- **أنشئ توثيقاً جديداً من برمجيات عاملة.** يقرأ Truth Document الكود والاختبارات، ثم ينشئ توثيقاً محدد النطاق للمنتج أو الهندسة.
|
|
26
|
+
- **حافظ على توافق الوثائق تلقائياً.** يعمل Truth Sync عند تسليم الوكيل بعد تغييرات الكود الوظيفية، ويحدّث حقيقة المستودع قبل اكتمال العمل.
|
|
27
|
+
- **حوّل الوثائق مجدداً إلى كود.** ينفّذ Truth Realize وثائق الحقيقة المعتمدة مع الحفاظ على مسار عمل نظيف يبدأ بالتوثيق.
|
|
28
|
+
- **أصلح الملكية مع نمو قاعدة الكود.** ينشئ Truth Structure مسارات محددة النطاق ووثائق أولية للمناطق الجديدة أو المثقلة.
|
|
29
|
+
- **راجع كل شيء في Git.** ينتقل الكود والقرارات والعقود والمعمارية والعمليات والسلوك معاً ضمن الفرع.
|
|
31
30
|
|
|
32
|
-
|
|
31
|
+
لا قاعدة معرفة مستضافة. لا ذاكرة خاصة للوكلاء. لا توثيق عالق في سجل المحادثات.
|
|
33
32
|
|
|
34
|
-
|
|
35
|
-
/truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
|
|
36
|
-
```
|
|
33
|
+
## البدء السريع: أنشئ أول وثيقة حقيقة
|
|
37
34
|
|
|
38
|
-
|
|
35
|
+
**المتطلبات:** Node.js 24 أو أحدث، ومستودع Git، ومضيف برمجة بالذكاء الاصطناعي مدعوم لمسارات عمل الوكلاء.
|
|
39
36
|
|
|
40
|
-
|
|
37
|
+
شغّل ما يلي داخل المستودع الذي تريد أن يديره Truthmark:
|
|
41
38
|
|
|
42
|
-
|
|
39
|
+
```bash
|
|
40
|
+
cd /path/to/your-repo
|
|
41
|
+
npm install -g truthmark
|
|
42
|
+
truthmark init
|
|
43
|
+
```
|
|
43
44
|
|
|
44
|
-
|
|
45
|
+
يتيح لك `truthmark init` اختيار Codex أو Claude Code أو GitHub Copilot أو OpenCode أو Antigravity أو Cursor أو إعداد واجهة سطر أوامر محايد تجاه المضيف.
|
|
45
46
|
|
|
46
|
-
|
|
47
|
-
* تتأخر وثائق المعمارية بسرعة.
|
|
48
|
-
* تختفي قرارات المنتج بعد التسليم.
|
|
49
|
-
* يُترك مراجعو الكود لفحص فروق كود خام من دون فهم "السبب".
|
|
50
|
-
* تُجبر كل جلسة ذكاء اصطناعي جديدة على إعادة اكتشاف حقيقة مستودعك من الصفر.
|
|
47
|
+
اطلب الآن من الوكيل الذي أعددته توثيق سلوك حقيقي واحد:
|
|
51
48
|
|
|
52
|
-
|
|
49
|
+
```text
|
|
50
|
+
/truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
|
|
51
|
+
```
|
|
53
52
|
|
|
54
|
-
|
|
53
|
+
ينشئ Truth Document وثيقة حقيقة جديدة محددة النطاق عند عدم وجودها، ويحدّث الوثيقة المالكة الموجودة عند وجودها، ويحدّث التوجيه عند الحاجة. ولا يغيّر الكود الوظيفي.
|
|
55
54
|
|
|
56
|
-
|
|
55
|
+
راجع النتيجة:
|
|
57
56
|
|
|
58
|
-
|
|
57
|
+
```bash
|
|
58
|
+
truthmark check
|
|
59
|
+
git status --short --untracked-files=all
|
|
60
|
+
git diff
|
|
61
|
+
```
|
|
59
62
|
|
|
60
|
-
|
|
63
|
+
ينبغي أن يصبح لديك الآن:
|
|
61
64
|
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
65
|
+
```text
|
|
66
|
+
docs/truthmark/engineering/behaviors/session-timeout.md
|
|
67
|
+
docs/truthmark/routes/areas/authentication.md
|
|
68
|
+
```
|
|
66
69
|
|
|
67
|
-
|
|
70
|
+
تتبع المسارات الدقيقة بنية الملكية في مستودعك. تظهر الملفات الجديدة في `git status`، وتظهر تغييرات الملفات المتتبعة في `git diff`.
|
|
68
71
|
|
|
69
|
-
|
|
72
|
+
تختلف طريقة الاستدعاء بحسب المضيف. يستخدم OpenCode الأمر `/skill truthmark-document`، ويستخدم Antigravity الأمر `@truthmark-document`، بينما تستخدم المضيفات الأخرى المدعومة واجهتها الأصلية للمهارات أو أوامر الشرطة المائلة. راجع [جدول المنصات](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md#supported-agent-platforms) لمعرفة الأوامر الدقيقة.
|
|
70
73
|
|
|
71
|
-
|
|
72
|
-
2. 🧪 **الاختبار:** تُشغّل الاختبارات ذات الصلة.
|
|
73
|
-
3. 🔍 **التحقق:** يتحقق Truthmark من التوثيق المربوط كجزء من مراجعة وقت الإنهاء المثبّتة.
|
|
74
|
-
4. 📝 **التوثيق:** يحدّث الوكيل الوثائق عندما تتغير حقيقة المستودع.
|
|
75
|
-
5. 👀 **المراجعة:** يراجع إنسان *فرق الكود* + *فرق الحقيقة*.
|
|
74
|
+
بالنسبة إلى السكربتات والتكامل المستمر، مرّر المنصات المختارة صراحةً:
|
|
76
75
|
|
|
77
|
-
|
|
76
|
+
```bash
|
|
77
|
+
truthmark init --platform codex --platform cursor
|
|
78
|
+
truthmark init --json
|
|
79
|
+
```
|
|
78
80
|
|
|
79
|
-
|
|
81
|
+
اختر `none` تفاعلياً أو شغّل `truthmark init --clear-platforms` للحصول على مستودع محايد تجاه المضيف. ويمكنك إضافة منصات الوكلاء لاحقاً بإعادة تشغيل `truthmark init`.
|
|
80
82
|
|
|
81
|
-
|
|
83
|
+
للحصول على تشخيصات الحداثة نسبةً إلى الفرع، مرّر مرجع Git أساسياً:
|
|
82
84
|
|
|
83
|
-
|
|
85
|
+
```bash
|
|
86
|
+
truthmark check --base <base-ref>
|
|
87
|
+
```
|
|
84
88
|
|
|
85
|
-
|
|
86
|
-
* `truthmark check` - التحقق من حقيقة المستودع من الطرفية.
|
|
89
|
+
## كيف يعمل Truthmark
|
|
87
90
|
|
|
88
|
-
|
|
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>
|
|
89
95
|
|
|
90
|
-
|
|
96
|
+
تثبّت واجهة سطر أوامر Truthmark عقد المستودع وتتحقق منه. وينفّذ وكيل البرمجة مراجعة الأدلة وأعمال التوثيق من خلال مسارات العمل الأصلية للمضيف التي جرى تثبيتها.
|
|
91
97
|
|
|
92
|
-
|
|
98
|
+
يتبع تغيير الكود المعتاد حلقة بسيطة:
|
|
93
99
|
|
|
94
|
-
1.
|
|
95
|
-
2.
|
|
96
|
-
3.
|
|
100
|
+
1. يغيّر الوكيل الكود الوظيفي.
|
|
101
|
+
2. تُشغّل الاختبارات ذات الصلة.
|
|
102
|
+
3. يتحقق Truth Sync من التوثيق المرتبط.
|
|
103
|
+
4. ينشئ الوكيل الوثائق والتوجيه أو يحدّثهما عندما تتغير حقيقة المستودع.
|
|
104
|
+
5. تراجع فرق الكود وفرق الحقيقة معاً.
|
|
97
105
|
|
|
98
|
-
|
|
106
|
+
## مسارات العمل
|
|
99
107
|
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
108
|
+
| مسار العمل | متى تستخدمه | النتيجة |
|
|
109
|
+
| -------------------- | -------------------------------------------------------------------------- | ---------------------------------------------------------------- |
|
|
110
|
+
| **Truth Document** | يحتاج الكود الموجود إلى توثيق | ينشئ توثيقاً للمنتج والهندسة مدعوماً بالأدلة أو يحدّثه |
|
|
111
|
+
| **Truth Sync** | تغيّر الكود الوظيفي | يحافظ على توافق الوثائق المرتبطة والتوجيه قبل التسليم |
|
|
112
|
+
| **Truth Structure** | تحتاج منطقة جديدة إلى ملكية أو أصبحت الوثائق الموجودة واسعة أكثر من اللازم | ينشئ مسارات محددة النطاق وهياكل أولية للوثائق |
|
|
113
|
+
| **Truth Realize** | ينبغي تحويل وثيقة حقيقة معتمدة إلى برمجيات عاملة | يحدّث الكود الوظيفي انطلاقاً من التوثيق |
|
|
114
|
+
| **Truth Check** | تحتاج حقيقة المستودع إلى تدقيق | يبلّغ عن مشكلات التوجيه والملكية والأدلة والتوثيق |
|
|
115
|
+
| **Truthmark Portal** | يريد الفريق موقع توثيق سهل التصفح | ينشئ عرض HTML ثابتاً وملتزماً به من وثائق الحقيقة بصيغة Markdown |
|
|
103
116
|
|
|
104
|
-
|
|
105
|
-
Truth Structure ليس أمراً يومياً؛ إنه يصلح التوجيه أو الملكية فقط عندما يعيق ذلك العمل.
|
|
117
|
+
يثبّت Truthmark مسارات العمل هذه كأسطح أصلية للمستودع في Codex وClaude Code وGitHub Copilot وOpenCode وAntigravity وCursor.
|
|
106
118
|
|
|
107
119
|
## ما الذي تحصل عليه
|
|
108
120
|
|
|
109
|
-
|
|
110
|
-
| --- | --- |
|
|
111
|
-
| حقيقة أصلية لـ Git | تُبقي حقيقة المستودع في Markdown وإعدادات ملتزم بها. |
|
|
112
|
-
| توثيق مرتبط بالفرع | تنتقل الحقيقة مع الفرع بدلاً من العيش في جلسة خاصة. |
|
|
113
|
-
| CLI بشري | يمنح الصائنين أوامر للإعداد والتحديث والتحقق والفحص. |
|
|
114
|
-
| إرشادات الوكيل المثبّتة | تخبر وكلاء البرمجة متى يوثقون، أو يختبرون، أو يزامنون الحقيقة، أو يدققون، أو يتوقفون للمراجعة. |
|
|
115
|
-
| توجيه صريح | يربط مناطق الكود بوثائق الحقيقة المعتمدة. |
|
|
116
|
-
| تسليمات قابلة للمراجعة | ينتج فروق Git عادية لكل من الكود ووثائق الحقيقة. |
|
|
117
|
-
| تشغيل محلي أولاً | لا يتطلب خدمة مستضافة أو daemon أو قاعدة بيانات أو خادم MCP. |
|
|
118
|
-
| حدود كتابة أكثر أماناً | يفصل بين مسارات العمل التي تبدأ بالكود، أو تبدأ بالتوثيق، أو للقراءة فقط، أو للتوثيق فقط. |
|
|
119
|
-
| التحقق | يبلّغ عن مشكلات التوجيه والسلطة وfrontmatter والروابط والأسطح المولّدة ونطاق الفرع والحداثة والتغطية. |
|
|
120
|
-
| Portal اختياري | يولّد موقع عرض HTML ثابتاً وملتزماً به من وثائق حقيقة Markdown عندما يُفعّل ويُطلب ذلك صراحةً. |
|
|
121
|
-
|
|
122
|
-
## نظرة بصرية عامة
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
**الميزات:** ما يثبّته Truthmark وكيف ينقسم سطح سير العمل.
|
|
121
|
+
### توثيق يبدأ من الواقع
|
|
127
122
|
|
|
128
|
-
|
|
123
|
+
يستطيع Truthmark إنشاء توثيق لقدرات المنتج وسلوك التنفيذ وواجهات برمجة التطبيقات والمعمارية ومسارات العمل والعمليات والاختبارات. يقدّم الكود والاختبارات الأدلة، وتحفظ وثائق Markdown محددة النطاق النتيجة.
|
|
129
124
|
|
|
130
|
-
|
|
125
|
+
### توثيق يصمد أمام التغيير التالي
|
|
131
126
|
|
|
132
|
-
|
|
127
|
+
تربط المسارات مناطق الكود بالوثائق المعتمدة. وعندما يغيّر الوكلاء السلوك، يعرف Truth Sync أين تنتمي الحقيقة المقابلة ويحافظ على قابلية مراجعة التسليم.
|
|
133
128
|
|
|
134
|
-
|
|
129
|
+
### حقيقة المنتج والهندسة في مسارين منفصلين
|
|
135
130
|
|
|
136
|
-
|
|
131
|
+
تسجّل حقيقة المنتج الوعود الموجّهة للمستخدم والحدود والقرارات ومعايير القبول. وتسجّل حقيقة الهندسة السلوك الحالي والعقود والمعمارية ومسارات العمل والعمليات وسلوك الاختبارات.
|
|
137
132
|
|
|
138
|
-
|
|
133
|
+
### تعاون أصلي لـ Git
|
|
139
134
|
|
|
140
|
-
|
|
135
|
+
يعيش كل ما يهم في ملفات المستودع الملتزم بها. تتبع الحقيقة الفرع، وتعمل مع طلبات السحب العادية، وتبقى مرئية لكل صائن ووكيل برمجة.
|
|
141
136
|
|
|
142
|
-
|
|
137
|
+
### تشغيل محلي أولاً
|
|
143
138
|
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
يساعد Truthmark الفرق على الإجابة عن ذلك بملفات ملتزم بها، وتوجيه صريح، وفروق قابلة للمراجعة.
|
|
147
|
-
|
|
148
|
-
يكون مفيداً عندما تحتاج إلى:
|
|
149
|
-
|
|
150
|
-
- انحراف أقل في التوثيق
|
|
151
|
-
- تسليمات أفضل
|
|
152
|
-
- حقيقة منتج خاصة بالفرع
|
|
153
|
-
- توثيق معماري وAPI دائم
|
|
154
|
-
- ملكية صريحة بين الوثائق والكود
|
|
155
|
-
- حدود كتابة أكثر أماناً للوكلاء
|
|
156
|
-
- توثيق قابل للمراجعة بدلاً من ذاكرة مخفية
|
|
157
|
-
- مسارات عمل ذكاء اصطناعي تستمر في العمل من ملفات المستودع الملتزم بها
|
|
139
|
+
لا يحتاج Truthmark إلى خدمة مستضافة أو برنامج خفي أو قاعدة بيانات أو مخزن متجهات أو خادم Model Context Protocol. يحمل المستودع مسار عمل التوثيق الخاص به.
|
|
158
140
|
|
|
159
141
|
## أين يندرج Truthmark
|
|
160
142
|
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
|
166
|
-
|
|
|
167
|
-
|
|
|
168
|
-
|
|
|
169
|
-
| عمل ميزات يبدأ بالخطة | سير عمل مواصفات |
|
|
170
|
-
| حقيقة مرتبطة بالفرع تنتقل مع الكود | Truthmark |
|
|
171
|
-
| التحقق من صحة السلوك | الاختبارات والمراجعة |
|
|
172
|
-
| مراجعة تغييرات التوثيق المدعومة بالذكاء الاصطناعي | Truthmark مع مراجعة Git |
|
|
173
|
-
|
|
174
|
-
مجال Truthmark ضيق عمداً بحسب التصميم:
|
|
143
|
+
| الحاجة | الأنسب |
|
|
144
|
+
| -------------------------------------------- | -------------------------- |
|
|
145
|
+
| مخرجات أفضل من جلسة وكيل واحدة | مطالبة أفضل |
|
|
146
|
+
| استمرارية شخصية أو على مستوى الجلسة | أداة ذاكرة |
|
|
147
|
+
| تطوير ميزات يبدأ بالخطة | مسار عمل للمواصفات |
|
|
148
|
+
| توثيق مرتبط بالفرع ينتقل مع الكود | **Truthmark** |
|
|
149
|
+
| صحة السلوك | الاختبارات ومراجعة الكود |
|
|
150
|
+
| توثيق مدعوم بالذكاء الاصطناعي وقابل للمراجعة | **Truthmark + مراجعة Git** |
|
|
175
151
|
|
|
176
|
-
|
|
177
|
-
make repository truth explicit
|
|
178
|
-
route it to code
|
|
179
|
-
تثبيت إرشادات الوكلاء حولها
|
|
180
|
-
keep the result reviewable in Git
|
|
181
|
-
```
|
|
182
|
-
|
|
183
|
-
## تعمّق أكثر
|
|
152
|
+
صُمّم Truthmark للصائنين وفرق الهندسة التي تستخدم بالفعل وكلاء البرمجة بالذكاء الاصطناعي وتريد أن يواصل المستودع قول الحقيقة بالسرعة نفسها التي يتغير بها الكود.
|
|
184
153
|
|
|
185
|
-
|
|
154
|
+
## المضيفات المدعومة وسطر الأوامر
|
|
186
155
|
|
|
187
|
-
|
|
156
|
+
مضيفات الوكلاء المدعومة:
|
|
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` | ينشئ الإعدادات والتوجيه والقوالب ومسارات عمل المضيفات المختارة أو يحدّثها |
|
|
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` | يعاين أسطح المضيف المولّدة أو يزيلها مع الحفاظ على الحقيقة المؤلّفة |
|
|
197
177
|
|
|
198
|
-
|
|
178
|
+
تتوفر مخرجات JSON منظّمة في جميع أجزاء واجهة سطر الأوامر للسكربتات والتكامل المستمر.
|
|
199
179
|
|
|
200
|
-
|
|
201
|
-
- [فهرس الوثائق](../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
|
-
Truthmark
|
|
211
|
-
|
|
212
|
-
إنه ليس خدمة مستضافة، ولا خادم MCP، ولا قاعدة بيانات متجهات، ولا طبقة ذاكرة مخفية، ولا منتج إنفاذ CI، ولا محركاً مستقلاً لإعادة كتابة الكود. يساعد حقيقة المستودع على البقاء مرئية؛ ولا يستبدل الاختبارات أو مراجعة الكود أو حكم البشر.
|
|
190
|
+
**ثبّت Truthmark، واختر مضيف البرمجة، وحوّل سلوكاً حقيقياً إلى توثيق اليوم.**
|
|
213
191
|
|
|
214
192
|
## الترخيص
|
|
215
193
|
|
|
216
194
|
MIT. راجع [LICENSE](../../LICENSE).
|
|
217
|
-
|
|
218
|
-
## إزالة آمنة
|
|
219
|
-
|
|
220
|
-
استخدم `truthmark uninstall --dry-run` لمراجعة أسطح الاستضافة المولّدة بدقة، ثم `truthmark uninstall --apply` لإزالتها. يتم الاحتفاظ بـ truth المؤلفة والتكوين والقوالب ومخرجات البوابة وملفات Gemini والملفات غير المتعلقة بالمستخدم؛ أزل التثبيت العالمي لـ npm بشكل منفصل عبر مدير الحزم.
|