Skip to content

Commit 2911b74

Browse files
github-actions[bot]github-actions[bot]
authored
docs: update translations for changed English sources (#379)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
1 parent 911cce8 commit 2911b74

14 files changed

Lines changed: 1408 additions & 0 deletions

File tree

‎docs/ar/cli/audit.mdx‎

Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
1+
---
2+
title: تدقيق الجلسات السابقة (نسخة تجريبية)
3+
description: "عد عدد مرات قيام الوكيل بأشياء مهدرة أو محفوفة بالمخاطر عبر النصوص السابقة"
4+
---
5+
6+
<Note>
7+
**ميزة تجريبية.** `failproofai audit` تُطلق كنسخة تجريبية بينما نجمع التعليقات المبكرة. قد تتغير أعلام سطر الأوامر وتنسيق الإخراج وكتالوج كاشفات التدقيق فقط قبل الإصدار المستقر التالي. قادم قريباً جداً — يرجى فتح مشكلة إذا بدا شيء ما خاطئاً.
8+
</Note>
9+
10+
```bash
11+
failproofai audit [options]
12+
```
13+
14+
يفحص نصوص CLI للوكيل السابقة على هذا الجهاز (Claude Code و Codex و Copilot و Cursor و OpenCode و Pi و Gemini) ويُبلّغ عن عدد مرات قيام الوكيل بأشياء مصممة failproofai لإيقافها — فحوصات متغيرات البيئة والدفع القسري وبادئات `cd <cwd>` الزائدة وحلقات sleep-polling وإعادة قراءة الملفات المعدّلة للتو والمزيد.
15+
16+
بالنسبة لكل نص، يتم إعادة تشغيل كل حدث استخدام أداة من خلال سياسات 39 مدمجة **و** من خلال 8 كاشفات تدقيق فقط تلتقط الأنماط التي لم تغطها السياسات في وقت التشغيل بعد. يتم تجميع الأعداد لكل سياسة / كاشف عبر جميع الجلسات.
17+
18+
## الخيارات
19+
20+
| العلم | الوصف |
21+
|------|--------|
22+
| `--cli claude\|codex\|copilot\|cursor\|opencode\|pi\|gemini` | تقصر على CLI واحد أو أكثر (مفصول بمسافات أو مكرر). الافتراضي: الـ 7 جميعاً. |
23+
| `--project <path>` | تقصر على الجلسات التي يطابق فيها `cwd` هذا المسار. قابل للتكرار. |
24+
| `--since 7d\|30d\|2026-04-01` | فقط الجلسات التي تقع فيها mtime النص ضمن النافذة. |
25+
| `--policy <name>` | تقصر على اسم سياسة أو كاشف واحد. قابل للتكرار. |
26+
| `--limit N` | أعلى N صف في الجدول (الافتراضي 20). |
27+
| `--show-examples` | تضمين أمر مثال واحد لكل صف في الجدول. |
28+
| `--report <path>` | مسار تقرير Markdown (الافتراضي `./failproofai-audit.md`). |
29+
| `--no-report` | تخطي كتابة تقرير Markdown. |
30+
| `--json` | طباعة JSON إلى stdout بدلاً من الجدول. تعني `--no-report` ما لم يتم تمرير `--report` أيضاً. |
31+
| `--no-cache` | تجاوز ذاكرة التخزين المؤقت لكل نص في `~/.failproofai/cache/audit/`. |
32+
33+
## كاشفات التدقيق فقط
34+
35+
تكتشف أنماط السلوك "الغبي" التي لم تُطبّق (حتى الآن) في الوقت الفعلي. تعمل فقط أثناء `audit` ولا تحظر أبداً استدعاء أداة حي.
36+
37+
| الكاشف | ما يعده |
38+
|---|---|
39+
| `redundant-cd-cwd` | أوامر Bash التي تبدأ بـ `cd <cwd> && …` رغم أن الأوامر تعمل بالفعل في `cwd`. |
40+
| `prefer-edit-over-read-cat` | `cat`/`head`/`tail`/`less`/`more` على ملف مصدر واحد — استخدم أداة `Read`. |
41+
| `prefer-edit-over-sed-awk` | `sed -i` / `awk … > file` تعديلات موضعية — استخدم أداة `Edit`. |
42+
| `prefer-write-over-heredoc` | Heredoc / متعدد الأسطر `echo > file` كتابة الملفات — استخدم أداة `Write`. |
43+
| `sleep-polling-loop` | `sleep N` طويل (≥ 30s) أو `while …; sleep …; done` حلقات polling. |
44+
| `find-from-root` | `find /` و `find /home` و `find /usr` وما إلى ذلك — حصر النطاق إلى `cwd` بدلاً من ذلك. |
45+
| `git-commit-no-verify` | `git commit … --no-verify` / `-n` تخطي الخطافات. |
46+
| `reread-after-edit` | `Read` لملف تم `Edit`/`Write` للتو في نفس الجلسة. |
47+
48+
## الإخراج
49+
50+
الإخراج الافتراضي عبارة عن جدول ANSI إلى stdout بالإضافة إلى تقرير markdown منقسم في `./failproofai-audit.md`. كلاهما يجمّع الضربات حسب الفئة (Sanitize / Wasteful / Risky / ...) مع أعداد الضربات وأعداد المشاريع وحتى ثلاث أوامر مثال لكل صف.
51+
52+
يطبع `--json` الإخراج الذي يمكن قراءته بواسطة الآلة:
53+
54+
```json
55+
{
56+
"version": 1,
57+
"scannedAt": "2026-05-21T...",
58+
"scope": { "cli": [...], "projects": "all", "since": null },
59+
"transcripts": { "scanned": 4187, "skipped": 0, "errors": 0, "durationMs": 12345 },
60+
"results": [
61+
{
62+
"name": "failproofai/protect-env-vars",
63+
"source": "builtin",
64+
"category": "Environment",
65+
"hits": 428,
66+
"projects": 142,
67+
"firstSeen": "...",
68+
"lastSeen": "...",
69+
"examples": [{ "sessionId": "...", "cwd": "...", "timestamp": "...", "example": "env" }]
70+
}
71+
],
72+
"totals": { "hits": 1398, "projectsWithHits": 392 }
73+
}
74+
```
75+
76+
## أمثلة
77+
78+
```bash
79+
# فحص كل شيء عبر كل CLI على هذا الجهاز
80+
failproofai audit
81+
82+
# آخر 30 يوماً فقط، Claude فقط
83+
failproofai audit --cli claude --since 30d
84+
85+
# عرض الأمثلة للضربات الأعلى
86+
failproofai audit --show-examples --limit 10
87+
88+
# التعمق في سياسة واحدة
89+
failproofai audit --policy protect-env-vars --policy block-force-push
90+
91+
# إخراج قابل للقراءة الآلية
92+
failproofai audit --json > audit.json
93+
```
94+
95+
## ملاحظات
96+
97+
- **ذاكرة التخزين المؤقت.** يتم تخزين نتائج كل نص مؤقتاً في `~/.failproofai/cache/audit/<sha1>.json` يفتاح على `(mtime, size, engineVersion, detectorVersion)`. ذاكرة التخزين المؤقت تبطل تلقائياً عند تغيير كود السياسة أو الكاشف.
98+
- **بدون تحوير.** يعاد تشغيل التدقيق في وضع القراءة فقط. يتم تخطي `warn-repeated-tool-calls` لأن ملفه الجانبي لكل جلسة سيتم تعديله بخلاف ذلك.
99+
- **تخطي سياسات سير العمل.** سياسات `require-*-before-stop` تطلق فقط على أحداث `Stop` و `execSync` ضد حالة git الحية — ليس لديها تفسير معنى "ماذا كان سيحدث في 2025" لذا لا تظهر في أعداد التدقيق.
100+
- **تخطي السياسات المخصصة.** خطافات مخصصة يوفرها المستخدم لا تُعاد تشغيلها (قد تكون تغيرت منذ الجلسة الأصلية).

‎docs/de/cli/audit.mdx‎

Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
1+
---
2+
title: Vergangene Sitzungen prüfen (Beta)
3+
description: "Zählt, wie oft der Agent in vergangenen Transkripten verschwenderische oder riskante Aktionen durchgeführt hat"
4+
---
5+
6+
<Note>
7+
**Beta-Funktion.** `failproofai audit` wird als Beta-Version veröffentlicht, während wir erstes Feedback sammeln. CLI-Flags, Ausgabeformat und der Katalog der Audit-spezifischen Detektoren können sich vor dem nächsten stabilen Release ändern. Wird in Kürze live geschaltet – bitte öffne ein Issue, wenn etwas nicht stimmt.
8+
</Note>
9+
10+
```bash
11+
failproofai audit [options]
12+
```
13+
14+
Durchsucht vergangene Agent-CLI-Transkripte auf diesem Rechner (Claude Code, Codex, Copilot, Cursor, OpenCode, Pi, Gemini) und zeigt, wie oft der Agent Dinge getan hat, die failproofai verhindern soll – Umgebungsvariablen-Abfragen, Force-Pushes, redundante `cd <cwd>`-Präfixe, Sleep-Polling-Schleifen, erneutes Lesen gerade bearbeiteter Dateien und mehr.
15+
16+
Für jedes Transkript wird jedes Tool-Use-Ereignis durch die 39 integrierten Richtlinien **und** durch 8 Audit-spezifische Detektoren wiederholt, die Muster erkennen, die noch nicht durch Laufzeit-Richtlinien abgedeckt sind. Treffer werden pro Richtlinie / Detektor über alle Sitzungen hinweg aggregiert.
17+
18+
## Optionen
19+
20+
| Flag | Beschreibung |
21+
|------|-------------|
22+
| `--cli claude\|codex\|copilot\|cursor\|opencode\|pi\|gemini` | Auf eine oder mehrere CLIs beschränken (durch Leerzeichen getrennt oder wiederholt). Standard: alle 7. |
23+
| `--project <path>` | Auf Sitzungen beschränken, deren `cwd` diesem Pfad entspricht. Wiederholbar. |
24+
| `--since 7d\|30d\|2026-04-01` | Nur Sitzungen, deren Transkript-mtime innerhalb des Zeitfensters liegt. |
25+
| `--policy <name>` | Auf einen Richtlinien- oder Detektornamen beschränken. Wiederholbar. |
26+
| `--limit N` | Anzahl der Zeilen in der Tabelle (Standard: 20). |
27+
| `--show-examples` | Ein Beispielbefehl pro Zeile in der Tabelle einbeziehen. |
28+
| `--report <path>` | Pfad für den Markdown-Bericht (Standard: `./failproofai-audit.md`). |
29+
| `--no-report` | Schreiben des Markdown-Berichts überspringen. |
30+
| `--json` | JSON auf stdout ausgeben statt der Tabelle. Impliziert `--no-report`, sofern nicht auch `--report` angegeben. |
31+
| `--no-cache` | Den transkript-bezogenen Ergebnis-Cache unter `~/.failproofai/cache/audit/` umgehen. |
32+
33+
## Audit-spezifische Detektoren
34+
35+
Diese erkennen Muster für „unnötiges Verhalten", die (noch) nicht in Echtzeit durchgesetzt werden. Sie laufen nur während `audit` und blockieren niemals einen Live-Tool-Aufruf.
36+
37+
| Detektor | Was gezählt wird |
38+
|---|---|
39+
| `redundant-cd-cwd` | Bash-Befehle, die mit `cd <cwd> && …` beginnen, obwohl Befehle bereits in `cwd` ausgeführt werden. |
40+
| `prefer-edit-over-read-cat` | `cat`/`head`/`tail`/`less`/`more` auf eine einzelne Quelldatei – nutze stattdessen das `Read`-Tool. |
41+
| `prefer-edit-over-sed-awk` | `sed -i` / `awk … > file` In-Place-Bearbeitungen – nutze stattdessen das `Edit`-Tool. |
42+
| `prefer-write-over-heredoc` | Heredoc- / mehrzeilige `echo > file`-Schreibvorgänge – nutze stattdessen das `Write`-Tool. |
43+
| `sleep-polling-loop` | Lange `sleep N` (≥ 30s) oder `while …; sleep …; done`-Polling-Schleifen. |
44+
| `find-from-root` | `find /`, `find /home`, `find /usr` usw. – auf `cwd` eingrenzen. |
45+
| `git-commit-no-verify` | `git commit … --no-verify` / `-n`, wodurch Hooks übersprungen werden. |
46+
| `reread-after-edit` | `Read` einer Datei, die in derselben Sitzung gerade per `Edit`/`Write` bearbeitet wurde. |
47+
48+
## Ausgabe
49+
50+
Die Standardausgabe ist eine ANSI-Tabelle auf stdout sowie ein gegliederter Markdown-Bericht unter `./failproofai-audit.md`. Beide gruppieren Treffer nach Kategorie (Sanitize / Wasteful / Risky / …) mit Trefferanzahl, Projektanzahl und bis zu drei Beispielbefehlen pro Zeile.
51+
52+
`--json` erzeugt maschinenlesbare Ausgabe:
53+
54+
```json
55+
{
56+
"version": 1,
57+
"scannedAt": "2026-05-21T...",
58+
"scope": { "cli": [...], "projects": "all", "since": null },
59+
"transcripts": { "scanned": 4187, "skipped": 0, "errors": 0, "durationMs": 12345 },
60+
"results": [
61+
{
62+
"name": "failproofai/protect-env-vars",
63+
"source": "builtin",
64+
"category": "Environment",
65+
"hits": 428,
66+
"projects": 142,
67+
"firstSeen": "...",
68+
"lastSeen": "...",
69+
"examples": [{ "sessionId": "...", "cwd": "...", "timestamp": "...", "example": "env" }]
70+
}
71+
],
72+
"totals": { "hits": 1398, "projectsWithHits": 392 }
73+
}
74+
```
75+
76+
## Beispiele
77+
78+
```bash
79+
# Alles über alle CLIs auf diesem Rechner scannen
80+
failproofai audit
81+
82+
# Nur die letzten 30 Tage, nur Claude
83+
failproofai audit --cli claude --since 30d
84+
85+
# Beispiele für die häufigsten Treffer anzeigen
86+
failproofai audit --show-examples --limit 10
87+
88+
# Eine einzelne Richtlinie genauer untersuchen
89+
failproofai audit --policy protect-env-vars --policy block-force-push
90+
91+
# Maschinenlesbare Ausgabe
92+
failproofai audit --json > audit.json
93+
```
94+
95+
## Hinweise
96+
97+
- **Cache.** Transkript-bezogene Ergebnisse werden unter `~/.failproofai/cache/audit/<sha1>.json` zwischengespeichert, mit dem Schlüssel `(mtime, size, engineVersion, detectorVersion)`. Der Cache wird automatisch invalidiert, wenn sich der Richtlinien- oder Detektorcode ändert.
98+
- **Keine Änderungen.** Das Audit läuft im Nur-Lese-Modus. `warn-repeated-tool-calls` wird übersprungen, da sein sitzungsbezogener Sidecar sonst verändert würde.
99+
- **Workflow-Richtlinien werden übersprungen.** `require-*-before-stop`-Richtlinien werden nur bei `Stop`-Ereignissen ausgelöst und führen `execSync` gegen den Live-Git-Zustand aus – sie haben keine sinnvolle Interpretation im Sinne von „was wäre 2025 passiert?" und erscheinen daher nicht in den Audit-Zählungen.
100+
- **Benutzerdefinierte Richtlinien werden übersprungen.** Vom Nutzer bereitgestellte benutzerdefinierte Hooks werden nicht wiederholt (sie können sich seit der ursprünglichen Sitzung geändert haben).

‎docs/es/cli/audit.mdx‎

Lines changed: 104 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,104 @@
1+
---
2+
title: Auditar sesiones pasadas (beta)
3+
description: "Cuenta con qué frecuencia el agente realizó acciones costosas o riesgosas en transcripciones anteriores"
4+
---
5+
6+
<Note>
7+
**Función beta.** `failproofai audit` se lanza en beta mientras recopilamos
8+
comentarios iniciales. Los flags de CLI, el formato de salida y el catálogo
9+
de detectores exclusivos de auditoría pueden cambiar antes del próximo corte
10+
estable. Entrará en funcionamiento próximamente — abre un issue si algo
11+
parece incorrecto.
12+
</Note>
13+
14+
```bash
15+
failproofai audit [options]
16+
```
17+
18+
Analiza las transcripciones pasadas del agente CLI en esta máquina (Claude Code, Codex, Copilot, Cursor, OpenCode, Pi, Gemini) e informa con qué frecuencia el agente realizó acciones que failproofai está diseñado para detener: comprobaciones de variables de entorno, force pushes, prefijos redundantes `cd <cwd>`, bucles de sleep-polling, relectura de archivos recién editados y más.
19+
20+
Por cada transcripción, cada evento de uso de herramienta se reprocesa a través de las 39 políticas integradas **y** de 8 detectores exclusivos de auditoría que identifican patrones que aún no están cubiertos por las políticas en tiempo real. Los conteos se agregan por política / detector en todas las sesiones.
21+
22+
## Opciones
23+
24+
| Flag | Descripción |
25+
|------|-------------|
26+
| `--cli claude\|codex\|copilot\|cursor\|opencode\|pi\|gemini` | Restringe a uno o más CLIs (separados por espacios o repetidos). Por defecto: los 7. |
27+
| `--project <path>` | Restringe a sesiones cuyo `cwd` coincida con esta ruta. Se puede repetir. |
28+
| `--since 7d\|30d\|2026-04-01` | Solo sesiones cuyo mtime de transcripción esté dentro del intervalo. |
29+
| `--policy <name>` | Restringe a una política o nombre de detector. Se puede repetir. |
30+
| `--limit N` | Las N filas superiores de la tabla (por defecto 20). |
31+
| `--show-examples` | Incluye un comando de ejemplo por fila en la tabla. |
32+
| `--report <path>` | Ruta del informe en Markdown (por defecto `./failproofai-audit.md`). |
33+
| `--no-report` | Omite la generación del informe en Markdown. |
34+
| `--json` | Imprime JSON en stdout en lugar de la tabla. Implica `--no-report` a menos que también se pase `--report`. |
35+
| `--no-cache` | Omite la caché de resultados por transcripción en `~/.failproofai/cache/audit/`. |
36+
37+
## Detectores exclusivos de auditoría
38+
39+
Estos detectan patrones de "comportamiento ineficiente" que aún no se aplican en tiempo real. Solo se ejecutan durante `audit` y nunca bloquean una llamada a herramienta en vivo.
40+
41+
| Detector | Qué cuenta |
42+
|---|---|
43+
| `redundant-cd-cwd` | Comandos Bash que comienzan con `cd <cwd> && …` aunque los comandos ya se ejecutan en `cwd`. |
44+
| `prefer-edit-over-read-cat` | `cat`/`head`/`tail`/`less`/`more` en un único archivo fuente — usa la herramienta `Read`. |
45+
| `prefer-edit-over-sed-awk` | Ediciones en el lugar con `sed -i` / `awk … > file` — usa la herramienta `Edit`. |
46+
| `prefer-write-over-heredoc` | Escritura de archivos con heredoc / `echo > file` multilínea — usa la herramienta `Write`. |
47+
| `sleep-polling-loop` | `sleep N` prolongado (≥ 30s) o bucles de polling `while …; sleep …; done`. |
48+
| `find-from-root` | `find /`, `find /home`, `find /usr`, etc. — limita el alcance a `cwd`. |
49+
| `git-commit-no-verify` | `git commit … --no-verify` / `-n`, que omite los hooks. |
50+
| `reread-after-edit` | `Read` de un archivo que acaba de ser modificado con `Edit`/`Write` en la misma sesión. |
51+
52+
## Salida
53+
54+
La salida predeterminada es una tabla ANSI en stdout más un informe Markdown con secciones en `./failproofai-audit.md`. Ambos agrupan los resultados por categoría (Sanitize / Wasteful / Risky / …) con recuentos de hits, recuentos de proyectos y hasta tres comandos de ejemplo por fila.
55+
56+
`--json` genera salida legible por máquina:
57+
58+
```json
59+
{
60+
"version": 1,
61+
"scannedAt": "2026-05-21T...",
62+
"scope": { "cli": [...], "projects": "all", "since": null },
63+
"transcripts": { "scanned": 4187, "skipped": 0, "errors": 0, "durationMs": 12345 },
64+
"results": [
65+
{
66+
"name": "failproofai/protect-env-vars",
67+
"source": "builtin",
68+
"category": "Environment",
69+
"hits": 428,
70+
"projects": 142,
71+
"firstSeen": "...",
72+
"lastSeen": "...",
73+
"examples": [{ "sessionId": "...", "cwd": "...", "timestamp": "...", "example": "env" }]
74+
}
75+
],
76+
"totals": { "hits": 1398, "projectsWithHits": 392 }
77+
}
78+
```
79+
80+
## Ejemplos
81+
82+
```bash
83+
# Analizar todo en cada CLI de esta máquina
84+
failproofai audit
85+
86+
# Solo los últimos 30 días, únicamente Claude
87+
failproofai audit --cli claude --since 30d
88+
89+
# Mostrar ejemplos para los hits principales
90+
failproofai audit --show-examples --limit 10
91+
92+
# Profundizar en una política específica
93+
failproofai audit --policy protect-env-vars --policy block-force-push
94+
95+
# Salida legible por máquina
96+
failproofai audit --json > audit.json
97+
```
98+
99+
## Notas
100+
101+
- **Caché.** Los resultados por transcripción se almacenan en caché en `~/.failproofai/cache/audit/<sha1>.json` con clave `(mtime, size, engineVersion, detectorVersion)`. La caché se invalida automáticamente cuando cambia el código de políticas o detectores.
102+
- **Sin mutaciones.** La auditoría se reproduce en modo de solo lectura. `warn-repeated-tool-calls` se omite porque de lo contrario se modificaría su archivo auxiliar por sesión.
103+
- **Políticas de flujo de trabajo omitidas.** Las políticas `require-*-before-stop` solo se activan en eventos `Stop` y ejecutan `execSync` contra el estado git en vivo — no tienen una interpretación significativa de "qué habría pasado en 2025", por lo que no aparecen en los recuentos de auditoría.
104+
- **Políticas personalizadas omitidas.** Los hooks personalizados proporcionados por el usuario no se reproducen (pueden haber cambiado desde la sesión original).

0 commit comments

Comments
 (0)