@conarium-ai/core 0.2.12 → 0.2.13
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/CHANGELOG.md +123 -1
- package/LICENSE +21 -21
- package/LIMITATIONS.md +23 -2
- package/LIMITATIONS.tr.md +13 -2
- package/bin/conarium-coverage.mjs +89 -6
- package/bin/conarium-doctor.mjs +44 -0
- package/bin/conarium-verify.mjs +110 -51
- package/dist/anchor.d.ts +11 -0
- package/dist/anchor.d.ts.map +1 -1
- package/dist/anchor.js +27 -0
- package/dist/anchor.js.map +1 -1
- package/dist/audit.d.ts +4 -0
- package/dist/audit.d.ts.map +1 -1
- package/dist/audit.js +124 -30
- package/dist/audit.js.map +1 -1
- package/dist/config.d.ts +14 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +35 -0
- package/dist/config.js.map +1 -1
- package/dist/connectors/openapi.d.ts +14 -1
- package/dist/connectors/openapi.d.ts.map +1 -1
- package/dist/connectors/openapi.js +78 -5
- package/dist/connectors/openapi.js.map +1 -1
- package/dist/connectors/postgres.js +8 -8
- package/dist/console-receipts.d.ts +12 -1
- package/dist/console-receipts.d.ts.map +1 -1
- package/dist/console-receipts.js +14 -2
- package/dist/console-receipts.js.map +1 -1
- package/dist/console.d.ts.map +1 -1
- package/dist/console.js +15 -4
- package/dist/console.js.map +1 -1
- package/dist/coverage.d.ts +17 -1
- package/dist/coverage.d.ts.map +1 -1
- package/dist/coverage.js +30 -3
- package/dist/coverage.js.map +1 -1
- package/dist/digit_pii.d.ts.map +1 -1
- package/dist/digit_pii.js +24 -5
- package/dist/digit_pii.js.map +1 -1
- package/dist/governance.d.ts +2 -0
- package/dist/governance.d.ts.map +1 -1
- package/dist/governance.js +23 -8
- package/dist/governance.js.map +1 -1
- package/dist/http.d.ts +11 -1
- package/dist/http.d.ts.map +1 -1
- package/dist/http.js +87 -7
- package/dist/http.js.map +1 -1
- package/dist/iban.d.ts.map +1 -1
- package/dist/iban.js +6 -3
- package/dist/iban.js.map +1 -1
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/dist/keys.d.ts +5 -0
- package/dist/keys.d.ts.map +1 -1
- package/dist/keys.js +22 -7
- package/dist/keys.js.map +1 -1
- package/dist/mask-text.d.ts +11 -0
- package/dist/mask-text.d.ts.map +1 -0
- package/dist/mask-text.js +42 -0
- package/dist/mask-text.js.map +1 -0
- package/dist/receipt-view.d.ts +13 -0
- package/dist/receipt-view.d.ts.map +1 -1
- package/dist/receipt-view.js +28 -5
- package/dist/receipt-view.js.map +1 -1
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +31 -15
- package/dist/server.js.map +1 -1
- package/dist/sql-gate/mssql.d.ts.map +1 -1
- package/dist/sql-gate/mssql.js +36 -2
- package/dist/sql-gate/mssql.js.map +1 -1
- package/dist/sql-gate/oracle.d.ts.map +1 -1
- package/dist/sql-gate/oracle.js +24 -3
- package/dist/sql-gate/oracle.js.map +1 -1
- package/dist/sql-gate/rules.d.ts +19 -1
- package/dist/sql-gate/rules.d.ts.map +1 -1
- package/dist/sql-gate/rules.js +116 -7
- package/dist/sql-gate/rules.js.map +1 -1
- package/dist/types.d.ts +6 -0
- package/dist/types.d.ts.map +1 -1
- package/docs/API-STABILITY.md +2 -2
- package/docs/ARCHITECTURE.md +42 -42
- package/docs/RECEIPT-SPEC.md +17 -11
- package/docs/plans/2026-07-02-redteam-harness.md +416 -416
- package/docs/specs/2026-07-02-redteam-harness-design.md +90 -90
- package/docs/superpowers/TODO-gate1-f4.md +23 -23
- package/docs/superpowers/plans/2026-07-29-conarium-receipt-plan.md +200 -200
- package/docs/superpowers/specs/2026-07-29-conarium-receipt-design.md +202 -202
- package/examples/claude-desktop-config.json +9 -9
- package/examples/cursor-mcp-settings.json +10 -10
- package/package.json +8 -1
- package/public/app.js +378 -378
- package/public/index.html +160 -160
- package/public/style.css +504 -504
- package/scripts/conarium_sabah_brief.mjs +107 -107
- package/scripts/start-mcp-c1.mjs +93 -93
- package/test-vectors/sql-gate/LAST-RUN.json +1 -1
- package/test-vectors/sql-gate/vectors.json +28 -0
- package/dist/openapi_connector.d.ts +0 -6
- package/dist/openapi_connector.d.ts.map +0 -1
- package/dist/openapi_connector.js +0 -145
- package/dist/openapi_connector.js.map +0 -1
- package/docs/audit/2026-08-14-security-scan.md +0 -48
- package/docs/audit/2026-08-14-surface-sync.md +0 -34
|
@@ -1,90 +1,90 @@
|
|
|
1
|
-
# Conarium Red-Team Harness v1 — Tasarım Belgesi
|
|
2
|
-
|
|
3
|
-
- **Tarih:** 2026-07-02 · **Sahip:** Emek Can Doğru + Claude (gate)
|
|
4
|
-
- **Konum:** `nexus/redteam/` (Conarium repo, `@conarium-ai/core`)
|
|
5
|
-
- **Bağlam:** STRATEJI.md Faz 1 — "NEO Conarium'a saldırır, Conarium bloklar" demosu + Faz 2 purple-team döngüsünün tohumu.
|
|
6
|
-
|
|
7
|
-
## 1. Amaç
|
|
8
|
-
NEO'nun red-team kolu, Conarium'un `Governance` motoruna bir **saldırı bataryası** fırlatır; her saldırının **SAVUNULDU** (Conarium bloklamış/maskelemiş) mı yoksa **BYPASS** (geçmiş/PII sızmış) mı olduğunu ölçer. Her BYPASS = Conarium'u sertleştirecek gerçek bir politika deliği. Çıktı hem **demo** (NEO saldırır, Conarium savunur) hem de purple-team döngüsünün girdisi.
|
|
9
|
-
|
|
10
|
-
## 2. Kapsam
|
|
11
|
-
### Dahil (MVP — Yaklaşım ①: doğrudan kütüphane çağrısı)
|
|
12
|
-
İki savunma katmanına saldırı:
|
|
13
|
-
- **Sorgu-zamanı (`guardQuery`)**: yazma-op kaçakçılığı, yetkisiz tablo (JOIN/UNION/subquery ile), çoklu-statement, parse hileleri.
|
|
14
|
-
- **Sonuç-zamanı (`redact`/`maskPII`)**: PII exfiltration — encode/base64, alias, format kırma (PII'yi parçalayıp maskeyi atlatma).
|
|
15
|
-
- Rapor: her saldırı → {DEFENDED | BYPASSED} + severity + detay (JSON + Markdown).
|
|
16
|
-
|
|
17
|
-
### Hariç (sonra)
|
|
18
|
-
- Kara-kutu MCP saldırısı (② yaklaşım) ve canlı-AI prompt-injection (③).
|
|
19
|
-
- Politikayı OTOMATİK düzeltme (bulguyu üretiriz; düzeltme insan onayı — STRATEJI Tier 2).
|
|
20
|
-
|
|
21
|
-
## 3. Mimari
|
|
22
|
-
```
|
|
23
|
-
runRedTeam(governance, policy) →
|
|
24
|
-
1. attacks[] topla (queryTime + resultTime saldırı case'leri)
|
|
25
|
-
2. her case'i çalıştır → AttackResult { defended, detail }
|
|
26
|
-
3. sınıflandır: DEFENDED (blok/maske) vs BYPASSED (geçti/sızdı)
|
|
27
|
-
4. RedTeamReport üret (stats + bulgular)
|
|
28
|
-
```
|
|
29
|
-
`Governance` motorunu doğrudan import eder (aynı repo). Bir test `GovernancePolicy` ile örnek şirket senaryosu kurar.
|
|
30
|
-
|
|
31
|
-
## 4. Modüller (`nexus/redteam/`)
|
|
32
|
-
| Modül | Sorumluluk |
|
|
33
|
-
|---|---|
|
|
34
|
-
| `types.ts` | `AttackCase`, `AttackResult`, `RedTeamReport` |
|
|
35
|
-
| `attacks/queryTime.ts` | Sorgu-zamanı saldırı case'leri (write-smuggle, unauthorized-table, multi-statement) |
|
|
36
|
-
| `attacks/resultTime.ts` | Sonuç-zamanı PII-exfil case'leri (encode/base64, alias, format-break) |
|
|
37
|
-
| `runner.ts` | Case'leri `Governance`'a karşı çalıştır → defended/bypassed sınıfla |
|
|
38
|
-
| `report.ts` | `RedTeamReport` → Markdown + JSON |
|
|
39
|
-
| `index.ts` | `runRedTeam` orkestratör + CLI (`npx tsx redteam/index.ts`) |
|
|
40
|
-
|
|
41
|
-
## 5. Veri Modeli
|
|
42
|
-
```ts
|
|
43
|
-
type AttackCategory = 'write_smuggle' | 'unauthorized_table' | 'multi_statement' | 'pii_exfil';
|
|
44
|
-
type Severity = 'CRITICAL' | 'HIGH' | 'MEDIUM';
|
|
45
|
-
|
|
46
|
-
interface AttackCase {
|
|
47
|
-
id: string;
|
|
48
|
-
category: AttackCategory;
|
|
49
|
-
severity: Severity;
|
|
50
|
-
description: string;
|
|
51
|
-
// Conarium'a saldırıyı uygula; Conarium savundu mu döndür.
|
|
52
|
-
run(gov: Governance): { defended: boolean; detail: string };
|
|
53
|
-
}
|
|
54
|
-
|
|
55
|
-
interface AttackResult { case: AttackCase; defended: boolean; detail: string; }
|
|
56
|
-
|
|
57
|
-
interface RedTeamReport {
|
|
58
|
-
ranAt: string;
|
|
59
|
-
total: number;
|
|
60
|
-
defended: number;
|
|
61
|
-
bypassed: number;
|
|
62
|
-
results: AttackResult[]; // BYPASSED'lar = bulgular
|
|
63
|
-
}
|
|
64
|
-
```
|
|
65
|
-
|
|
66
|
-
## 6. Saldırı Case Örnekleri (davranış)
|
|
67
|
-
- **write_smuggle:** `guardQuery("DELETE FROM users")`, `"SELECT 1; DROP TABLE x"`, yorumla gizli write → **DEFENDED beklenir** (PolicyError).
|
|
68
|
-
- **unauthorized_table:** izin-dışı tabloya `JOIN`/`UNION SELECT` → **DEFENDED beklenir**.
|
|
69
|
-
- **pii_exfil (encode):** `redact` katmanına, `encode(email,'base64')` sonucu gibi base64 bir PII değeri ver → maske regex'i yakalamaz → **BYPASSED beklenir** (bilinen gerçek delik; harness'in görevi bunu DOĞRU tespit etmek).
|
|
70
|
-
|
|
71
|
-
## 7. Sınıflandırma Mantığı
|
|
72
|
-
- Sorgu-zamanı: `guardQuery` **PolicyError fırlattıysa** → DEFENDED. Fırlatmadıysa (yetkisiz erişim/write geçtiyse) → BYPASSED.
|
|
73
|
-
- Sonuç-zamanı: sahte sonuç satırı `redact`'ten geçir; PII string'i çıktıda **`[MASKED_PII]` değilse** → BYPASSED (sızıntı).
|
|
74
|
-
|
|
75
|
-
## 8. Test Stratejisi (TDD)
|
|
76
|
-
- Her saldırı case'i için birim test: bilinen-savunulan case DEFENDED döner; encode-base64 case BYPASSED döner (harness'in bypass'ı DOĞRU yakaladığını kanıtlar — Conarium'u değil, harness'i test eder).
|
|
77
|
-
- `runner` testi: karışık case seti → doğru defended/bypassed sayısı.
|
|
78
|
-
- `report` testi: bulgu içeren rapor Markdown'da BYPASSED'ları listeler.
|
|
79
|
-
|
|
80
|
-
## 9. Başarı Kriteri (MVP "bitti")
|
|
81
|
-
Gerçek `Governance` + örnek policy ile `runRedTeam` çalışınca:
|
|
82
|
-
1. En az write-smuggle **DEFENDED**, encode-base64 PII-exfil **BYPASSED** doğru sınıflanır.
|
|
83
|
-
2. Markdown + JSON rapor üretilir (Conarium'un savunma karnesi).
|
|
84
|
-
3. Testler geçer.
|
|
85
|
-
4. Çıktı, Faz 1 demosunun ham materyali olur ("NEO N saldırdı, Conarium X savundu, Y bypass — işte sertleştirilecekler").
|
|
86
|
-
|
|
87
|
-
## 10. Bağımlılık
|
|
88
|
-
- `@conarium-ai/core` `Governance` sınıfı (aynı repo, `src/governance.ts`).
|
|
89
|
-
- Test runner: vitest (yoksa eklenir).
|
|
90
|
-
- Ek dış bağımlılık yok.
|
|
1
|
+
# Conarium Red-Team Harness v1 — Tasarım Belgesi
|
|
2
|
+
|
|
3
|
+
- **Tarih:** 2026-07-02 · **Sahip:** Emek Can Doğru + Claude (gate)
|
|
4
|
+
- **Konum:** `nexus/redteam/` (Conarium repo, `@conarium-ai/core`)
|
|
5
|
+
- **Bağlam:** STRATEJI.md Faz 1 — "NEO Conarium'a saldırır, Conarium bloklar" demosu + Faz 2 purple-team döngüsünün tohumu.
|
|
6
|
+
|
|
7
|
+
## 1. Amaç
|
|
8
|
+
NEO'nun red-team kolu, Conarium'un `Governance` motoruna bir **saldırı bataryası** fırlatır; her saldırının **SAVUNULDU** (Conarium bloklamış/maskelemiş) mı yoksa **BYPASS** (geçmiş/PII sızmış) mı olduğunu ölçer. Her BYPASS = Conarium'u sertleştirecek gerçek bir politika deliği. Çıktı hem **demo** (NEO saldırır, Conarium savunur) hem de purple-team döngüsünün girdisi.
|
|
9
|
+
|
|
10
|
+
## 2. Kapsam
|
|
11
|
+
### Dahil (MVP — Yaklaşım ①: doğrudan kütüphane çağrısı)
|
|
12
|
+
İki savunma katmanına saldırı:
|
|
13
|
+
- **Sorgu-zamanı (`guardQuery`)**: yazma-op kaçakçılığı, yetkisiz tablo (JOIN/UNION/subquery ile), çoklu-statement, parse hileleri.
|
|
14
|
+
- **Sonuç-zamanı (`redact`/`maskPII`)**: PII exfiltration — encode/base64, alias, format kırma (PII'yi parçalayıp maskeyi atlatma).
|
|
15
|
+
- Rapor: her saldırı → {DEFENDED | BYPASSED} + severity + detay (JSON + Markdown).
|
|
16
|
+
|
|
17
|
+
### Hariç (sonra)
|
|
18
|
+
- Kara-kutu MCP saldırısı (② yaklaşım) ve canlı-AI prompt-injection (③).
|
|
19
|
+
- Politikayı OTOMATİK düzeltme (bulguyu üretiriz; düzeltme insan onayı — STRATEJI Tier 2).
|
|
20
|
+
|
|
21
|
+
## 3. Mimari
|
|
22
|
+
```
|
|
23
|
+
runRedTeam(governance, policy) →
|
|
24
|
+
1. attacks[] topla (queryTime + resultTime saldırı case'leri)
|
|
25
|
+
2. her case'i çalıştır → AttackResult { defended, detail }
|
|
26
|
+
3. sınıflandır: DEFENDED (blok/maske) vs BYPASSED (geçti/sızdı)
|
|
27
|
+
4. RedTeamReport üret (stats + bulgular)
|
|
28
|
+
```
|
|
29
|
+
`Governance` motorunu doğrudan import eder (aynı repo). Bir test `GovernancePolicy` ile örnek şirket senaryosu kurar.
|
|
30
|
+
|
|
31
|
+
## 4. Modüller (`nexus/redteam/`)
|
|
32
|
+
| Modül | Sorumluluk |
|
|
33
|
+
|---|---|
|
|
34
|
+
| `types.ts` | `AttackCase`, `AttackResult`, `RedTeamReport` |
|
|
35
|
+
| `attacks/queryTime.ts` | Sorgu-zamanı saldırı case'leri (write-smuggle, unauthorized-table, multi-statement) |
|
|
36
|
+
| `attacks/resultTime.ts` | Sonuç-zamanı PII-exfil case'leri (encode/base64, alias, format-break) |
|
|
37
|
+
| `runner.ts` | Case'leri `Governance`'a karşı çalıştır → defended/bypassed sınıfla |
|
|
38
|
+
| `report.ts` | `RedTeamReport` → Markdown + JSON |
|
|
39
|
+
| `index.ts` | `runRedTeam` orkestratör + CLI (`npx tsx redteam/index.ts`) |
|
|
40
|
+
|
|
41
|
+
## 5. Veri Modeli
|
|
42
|
+
```ts
|
|
43
|
+
type AttackCategory = 'write_smuggle' | 'unauthorized_table' | 'multi_statement' | 'pii_exfil';
|
|
44
|
+
type Severity = 'CRITICAL' | 'HIGH' | 'MEDIUM';
|
|
45
|
+
|
|
46
|
+
interface AttackCase {
|
|
47
|
+
id: string;
|
|
48
|
+
category: AttackCategory;
|
|
49
|
+
severity: Severity;
|
|
50
|
+
description: string;
|
|
51
|
+
// Conarium'a saldırıyı uygula; Conarium savundu mu döndür.
|
|
52
|
+
run(gov: Governance): { defended: boolean; detail: string };
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
interface AttackResult { case: AttackCase; defended: boolean; detail: string; }
|
|
56
|
+
|
|
57
|
+
interface RedTeamReport {
|
|
58
|
+
ranAt: string;
|
|
59
|
+
total: number;
|
|
60
|
+
defended: number;
|
|
61
|
+
bypassed: number;
|
|
62
|
+
results: AttackResult[]; // BYPASSED'lar = bulgular
|
|
63
|
+
}
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
## 6. Saldırı Case Örnekleri (davranış)
|
|
67
|
+
- **write_smuggle:** `guardQuery("DELETE FROM users")`, `"SELECT 1; DROP TABLE x"`, yorumla gizli write → **DEFENDED beklenir** (PolicyError).
|
|
68
|
+
- **unauthorized_table:** izin-dışı tabloya `JOIN`/`UNION SELECT` → **DEFENDED beklenir**.
|
|
69
|
+
- **pii_exfil (encode):** `redact` katmanına, `encode(email,'base64')` sonucu gibi base64 bir PII değeri ver → maske regex'i yakalamaz → **BYPASSED beklenir** (bilinen gerçek delik; harness'in görevi bunu DOĞRU tespit etmek).
|
|
70
|
+
|
|
71
|
+
## 7. Sınıflandırma Mantığı
|
|
72
|
+
- Sorgu-zamanı: `guardQuery` **PolicyError fırlattıysa** → DEFENDED. Fırlatmadıysa (yetkisiz erişim/write geçtiyse) → BYPASSED.
|
|
73
|
+
- Sonuç-zamanı: sahte sonuç satırı `redact`'ten geçir; PII string'i çıktıda **`[MASKED_PII]` değilse** → BYPASSED (sızıntı).
|
|
74
|
+
|
|
75
|
+
## 8. Test Stratejisi (TDD)
|
|
76
|
+
- Her saldırı case'i için birim test: bilinen-savunulan case DEFENDED döner; encode-base64 case BYPASSED döner (harness'in bypass'ı DOĞRU yakaladığını kanıtlar — Conarium'u değil, harness'i test eder).
|
|
77
|
+
- `runner` testi: karışık case seti → doğru defended/bypassed sayısı.
|
|
78
|
+
- `report` testi: bulgu içeren rapor Markdown'da BYPASSED'ları listeler.
|
|
79
|
+
|
|
80
|
+
## 9. Başarı Kriteri (MVP "bitti")
|
|
81
|
+
Gerçek `Governance` + örnek policy ile `runRedTeam` çalışınca:
|
|
82
|
+
1. En az write-smuggle **DEFENDED**, encode-base64 PII-exfil **BYPASSED** doğru sınıflanır.
|
|
83
|
+
2. Markdown + JSON rapor üretilir (Conarium'un savunma karnesi).
|
|
84
|
+
3. Testler geçer.
|
|
85
|
+
4. Çıktı, Faz 1 demosunun ham materyali olur ("NEO N saldırdı, Conarium X savundu, Y bypass — işte sertleştirilecekler").
|
|
86
|
+
|
|
87
|
+
## 10. Bağımlılık
|
|
88
|
+
- `@conarium-ai/core` `Governance` sınıfı (aynı repo, `src/governance.ts`).
|
|
89
|
+
- Test runner: vitest (yoksa eklenir).
|
|
90
|
+
- Ek dış bağımlılık yok.
|
|
@@ -1,23 +1,23 @@
|
|
|
1
|
-
# Receipt v0.1 — GATE 1 deferred work
|
|
2
|
-
|
|
3
|
-
## F4 — gerçek metin (Claude GATE 1)
|
|
4
|
-
|
|
5
|
-
**Status:** done via **F5** (2026-07-29, push-öncesi) · **Source:** Claude GATE 1
|
|
6
|
-
|
|
7
|
-
**F4 / F5 gövdesi (patron onayıyla uygulanan metin):**
|
|
8
|
-
|
|
9
|
-
> `validateChain`'e bitişiklik kuralı (`sig` taşıyan ilk satırdan sonra her
|
|
10
|
-
> satırda `sig` zorunlu; yabancı `keyId` kabul, yokluk red) + çoklu `keyId`
|
|
11
|
-
> trust store + bu senaryonun testi.
|
|
12
|
-
|
|
13
|
-
### Uygulama (F5)
|
|
14
|
-
|
|
15
|
-
| Kural | Davranış |
|
|
16
|
-
|---|---|
|
|
17
|
-
| Bitişiklik | İlk `sig`'li satırdan sonra `sig` yokluğu → corrupt |
|
|
18
|
-
| Yabancı `keyId` | Trust store'da varsa ve crypto geçerse kabul |
|
|
19
|
-
| Trust store | Mevcut signing pubkey + `CONARIUM_AUDIT_TRUST_PUBKEYS` (`,` / `;`) |
|
|
20
|
-
| Bilinmeyen `keyId` | Trust store doluyken fail-closed |
|
|
21
|
-
| Legacy önek | İlk `sig`'den önceki imzasız satırlar hâlâ kabul |
|
|
22
|
-
|
|
23
|
-
Testler: `src/audit.receipt-gate.test.ts`.
|
|
1
|
+
# Receipt v0.1 — GATE 1 deferred work
|
|
2
|
+
|
|
3
|
+
## F4 — gerçek metin (Claude GATE 1)
|
|
4
|
+
|
|
5
|
+
**Status:** done via **F5** (2026-07-29, push-öncesi) · **Source:** Claude GATE 1
|
|
6
|
+
|
|
7
|
+
**F4 / F5 gövdesi (patron onayıyla uygulanan metin):**
|
|
8
|
+
|
|
9
|
+
> `validateChain`'e bitişiklik kuralı (`sig` taşıyan ilk satırdan sonra her
|
|
10
|
+
> satırda `sig` zorunlu; yabancı `keyId` kabul, yokluk red) + çoklu `keyId`
|
|
11
|
+
> trust store + bu senaryonun testi.
|
|
12
|
+
|
|
13
|
+
### Uygulama (F5)
|
|
14
|
+
|
|
15
|
+
| Kural | Davranış |
|
|
16
|
+
|---|---|
|
|
17
|
+
| Bitişiklik | İlk `sig`'li satırdan sonra `sig` yokluğu → corrupt |
|
|
18
|
+
| Yabancı `keyId` | Trust store'da varsa ve crypto geçerse kabul |
|
|
19
|
+
| Trust store | Mevcut signing pubkey + `CONARIUM_AUDIT_TRUST_PUBKEYS` (`,` / `;`) |
|
|
20
|
+
| Bilinmeyen `keyId` | Trust store doluyken fail-closed |
|
|
21
|
+
| Legacy önek | İlk `sig`'den önceki imzasız satırlar hâlâ kabul |
|
|
22
|
+
|
|
23
|
+
Testler: `src/audit.receipt-gate.test.ts`.
|
|
@@ -1,200 +1,200 @@
|
|
|
1
|
-
# Conarium Receipt v0.1 — Uygulama Planı (Cursor için)
|
|
2
|
-
|
|
3
|
-
**Tasarım:** `docs/superpowers/specs/2026-07-29-conarium-receipt-design.md` — **önce onu oku.**
|
|
4
|
-
**Uygulayan:** Cursor · **Gate:** Claude (push öncesi diff incelemesi) · **Dal:** `feat/receipt-v01`
|
|
5
|
-
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
## ⛔ Cursor için sınırlar (ihlal = gate reddi)
|
|
9
|
-
|
|
10
|
-
1. **`git push` YOK, `git commit` serbest.** Push kararı patronun.
|
|
11
|
-
2. **`src/governance.ts` içindeki maskeleme mantığına DOKUNMA.** Bu iş denetim/imza katmanı.
|
|
12
|
-
3. **Mevcut HMAC davranışını BOZMA.** `signature` alanı ve `scripts/audit-chain-check.mjs`
|
|
13
|
-
çalışmaya devam etmeli. Yeni imza ayrı alan (`sig`).
|
|
14
|
-
4. **`as any` / `as string` ile tip atlatma YOK** (repo `AGENTS.md` kuralı).
|
|
15
|
-
5. **Testte gerçek assert.** "Çalıştı, hata vermedi" test değil. Her test bir bozulma senaryosunu
|
|
16
|
-
kanıtlamalı.
|
|
17
|
-
6. **Makbuza ham veri yazma.** Sorgu metni, alan değeri, müşteri adı — hiçbiri. Sadece sayı,
|
|
18
|
-
sınıf adı ve hash. Bu kuralın testi T9'da.
|
|
19
|
-
7. Bir şey belirsizse **uydurma, sor.** Tasarım dokümanında cevabı yoksa dur.
|
|
20
|
-
|
|
21
|
-
---
|
|
22
|
-
|
|
23
|
-
## T1 — Ed25519 anahtar yönetimi
|
|
24
|
-
**Dosya:** `src/keys.ts` (yeni)
|
|
25
|
-
|
|
26
|
-
```ts
|
|
27
|
-
export type KeyId = string // örn "cnr-2026-07"
|
|
28
|
-
export interface SigningKey { keyId: KeyId; privateKey: KeyObject }
|
|
29
|
-
export interface VerifyKey { keyId: KeyId; publicKey: KeyObject }
|
|
30
|
-
|
|
31
|
-
export function generateKeyPair(keyId: KeyId): { privatePem: string; publicPem: string }
|
|
32
|
-
export function loadSigningKey(): SigningKey | null // env/dosyadan, yoksa null
|
|
33
|
-
export function loadVerifyKeys(paths: string[]): VerifyKey[] // rotasyon: çoklu
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
- Node `crypto` (`generateKeyPairSync('ed25519')`). Ek bağımlılık YOK.
|
|
37
|
-
- Özel anahtar yolu: `CONARIUM_AUDIT_SIGNING_KEY` (dosya yolu). Dosya izni 0600 değilse
|
|
38
|
-
**uyarı bas** (Windows'ta izin kontrolünü atla, platform kontrolü koy).
|
|
39
|
-
- `keyId` açık anahtar dosyasının yanında `.keyid` olarak saklanır ya da PEM yorumundan okunur —
|
|
40
|
-
hangisini seçtiysen dokümana yaz.
|
|
41
|
-
|
|
42
|
-
**Kabul:** `generateKeyPair` → `loadVerifyKeys` → imzala/doğrula turu yeşil. Bozuk PEM'de
|
|
43
|
-
anlamlı hata, `throw new Error('...')` mesajı ne olduğunu söylüyor.
|
|
44
|
-
|
|
45
|
-
---
|
|
46
|
-
|
|
47
|
-
## T2 — Makbuz şeması ve üretici
|
|
48
|
-
**Dosya:** `src/receipt.ts` (yeni)
|
|
49
|
-
|
|
50
|
-
Tasarım §4'teki JSON şemasını birebir uygula. `Receipt` tipini export et.
|
|
51
|
-
|
|
52
|
-
```ts
|
|
53
|
-
export function buildReceipt(input: ReceiptInput, chain: ChainState, key: SigningKey | null): Receipt
|
|
54
|
-
export function canonicalize(obj: unknown): string // RFC 8785 (JCS)
|
|
55
|
-
export function receiptHash(r: Omit<Receipt,'hash'|'sig'|'anchor'>): string
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
- `canonicalize`: anahtarlar sıralı, boşluksuz, `undefined` alanlar atlanır. Küçük ve **kendi
|
|
59
|
-
yazdığın** bir fonksiyon olsun (JCS için ağır kütüphane çekme), ama testi sağlam olsun:
|
|
60
|
-
anahtar sırası farklı iki eşdeğer nesne aynı string üretmeli.
|
|
61
|
-
- `hash` = `sha256(canonicalize(receipt \ {hash,sig,anchor}))`, `sha256:` önekli hex.
|
|
62
|
-
- **`seq` zorunlu**, ardışık, boşluksuz. Tasarım §4'teki gerekçe: kapsama kanıtının tek dayanağı.
|
|
63
|
-
- `actor.type` v0.1'de daima `"service"`. `"user"` tipini şemada tanımla ama **üretme** —
|
|
64
|
-
Katman 2 işi.
|
|
65
|
-
- `consentRef` alanı tanımlı ve daima `null`. Şimdi rezerve, mantığı v0.2.
|
|
66
|
-
|
|
67
|
-
**Kabul:** aynı girdi → aynı hash (deterministik). Alan sırası değişince hash değişmiyor.
|
|
68
|
-
|
|
69
|
-
---
|
|
70
|
-
|
|
71
|
-
## T3 — Fail-closed imzalama (mevcut kusurun düzeltmesi)
|
|
72
|
-
**Dosya:** `src/audit.ts`
|
|
73
|
-
|
|
74
|
-
🔴 **Bugünkü kusur:** satır ~121 `if (this.hmacKey) { full.signature = ... }` ve satır ~167'de
|
|
75
|
-
aynı şekilde doğrulama — **anahtar yoksa imzalama VE doğrulama sessizce atlanıyor, hata yok.**
|
|
76
|
-
Bu, `conarium-concierge`'de bulunan yalancı arıza deseninin aynısı.
|
|
77
|
-
|
|
78
|
-
Yeni davranış:
|
|
79
|
-
- Ed25519 anahtarı varsa → `sig` üret
|
|
80
|
-
- HMAC anahtarı varsa → `signature` üret (geriye dönük uyumluluk)
|
|
81
|
-
- **İkisi de yoksa** → `CONARIUM_AUDIT_UNSIGNED=1` açıkça ayarlanmadıkça **`throw`**.
|
|
82
|
-
Ayarlıysa her başlangıçta bir kez `console.warn` bas (sessiz kalma).
|
|
83
|
-
- Doğrulama tarafında da aynı: anahtar yokken "geçti" dönmeyecek, "doğrulanamadı" diyecek.
|
|
84
|
-
|
|
85
|
-
**Kabul:** anahtarsız + env yok → `log()` fırlatıyor, test bunu doğruluyor. Anahtarsız +
|
|
86
|
-
`CONARIUM_AUDIT_UNSIGNED=1` → çalışıyor ama uyarı basılıyor. Mevcut 3 audit testi
|
|
87
|
-
(`audit.chain.test.ts`, `audit.failclosed.test.ts`, `audit-secrets.test.ts`) hâlâ yeşil.
|
|
88
|
-
|
|
89
|
-
---
|
|
90
|
-
|
|
91
|
-
## T4 — Bağımsız doğrulayıcı
|
|
92
|
-
**Dosya:** `bin/conarium-verify.mjs` (yeni, tek dosya, `src/`'a import YOK)
|
|
93
|
-
|
|
94
|
-
Neden kopya mantık: doğrulayıcının değeri **bize bağımlı olmamasında.** Üçüncü taraf `npm i`
|
|
95
|
-
yapmadan, repoyu klonlamadan tek dosyayı çalıştırabilmeli. Kanonikleştirme mantığı burada
|
|
96
|
-
tekrar yazılır — ve T5'te iki uygulamanın aynı hash'i ürettiği test edilir.
|
|
97
|
-
|
|
98
|
-
```
|
|
99
|
-
conarium-verify <dosya|dizin> --pubkey <yol> [--pubkey <yol2> ...] [--anchor-check] [--expect-seq-from N]
|
|
100
|
-
```
|
|
101
|
-
|
|
102
|
-
Çıkış kodları (tasarım §5):
|
|
103
|
-
`0` sağlam · `10` hash uyuşmuyor · `11` prevHash kopuk · `12` seq boşluklu/azalan ·
|
|
104
|
-
`13` imza geçersiz · `14` çıpa doğrulanamadı · `20` şema geçersiz
|
|
105
|
-
|
|
106
|
-
- Her hata: **insan-okunur tek satır stderr + `--json` ile makine-okunur çıktı.**
|
|
107
|
-
- **Fail-closed:** emin olunamayan hiçbir durumda 0 dönmez. Anahtar verilmediyse 13 ile çık,
|
|
108
|
-
"imzalar kontrol edilmedi" deyip 0 dönme.
|
|
109
|
-
- Boş dosya / tek kayıt → 0 ama stderr'e uyarı.
|
|
110
|
-
|
|
111
|
-
**Kabul:** T5'teki 10 senaryonun tamamı beklenen kodu döndürüyor.
|
|
112
|
-
|
|
113
|
-
---
|
|
114
|
-
|
|
115
|
-
## T5 — Testler
|
|
116
|
-
**Dosya:** `src/receipt.test.ts` (yeni) + `test/verify.test.mjs` (yeni)
|
|
117
|
-
|
|
118
|
-
| # | Senaryo | Beklenen |
|
|
119
|
-
|---|---|---|
|
|
120
|
-
| T5.1 | Ortadaki kaydın bir alanını değiştir | 10 |
|
|
121
|
-
| T5.2 | Ortadaki kaydı sil | 11 |
|
|
122
|
-
| T5.3 | İki kaydın yerini değiştir | 11 veya 12 |
|
|
123
|
-
| T5.4 | `seq` atlat (1041→1043) | 12 |
|
|
124
|
-
| T5.5 | Başka anahtarla imzala | 13 |
|
|
125
|
-
| T5.6 | Rotasyon: eski+yeni `keyId` karışık zincir, iki açık anahtar verilmiş | 0 |
|
|
126
|
-
| T5.7 | Boş zincir / tek kayıt | 0 + uyarı |
|
|
127
|
-
| T5.8 | `anchor: null` + `--anchor-check` | 14 |
|
|
128
|
-
| T5.9 | Anahtar hiç yok, env yok | üretim `throw` |
|
|
129
|
-
| T5.10 | `src/receipt.ts` ve `bin/conarium-verify.mjs` aynı makbuz için aynı hash'i üretiyor | eşit |
|
|
130
|
-
|
|
131
|
-
**T5.10 en kritik test.** İki bağımsız kanonikleştirme uygulaması ayrışırsa doğrulayıcı yanlış
|
|
132
|
-
alarm üretir ve tüm iddia çöker.
|
|
133
|
-
|
|
134
|
-
---
|
|
135
|
-
|
|
136
|
-
## T6 — Ham veri sızıntı regresyonu (zorunlu)
|
|
137
|
-
**Dosya:** `src/receipt.leak.test.ts` (yeni)
|
|
138
|
-
|
|
139
|
-
Sentetik ama gerçekçi bir veri kümesinden (e-posta, telefon, TCKN, isim, API anahtarı) makbuz
|
|
140
|
-
üret. Üretilen makbuzun **tam JSON metninde** her ham değeri ara. **0 eşleşme zorunlu.**
|
|
141
|
-
|
|
142
|
-
`argsHash` alanının ham SQL içermediğini ayrıca doğrula (SQL string'i makbuzda geçmemeli).
|
|
143
|
-
|
|
144
|
-
**Kabul:** test yeşil. Bu test kırmızıysa hiçbir şey merge edilmez — makbuz bir sızıntı yüzeyi
|
|
145
|
-
olamaz.
|
|
146
|
-
|
|
147
|
-
---
|
|
148
|
-
|
|
149
|
-
## T7 — Çıpalama (en son, ağ bağımlılığı var)
|
|
150
|
-
**Dosya:** `src/anchor.ts` (yeni)
|
|
151
|
-
|
|
152
|
-
- Zincir başı (`hash` + `seq` + `keyId`) periyodik olarak kamu şeffaflık kütüğüne yazılır.
|
|
153
|
-
Başlangıç hedefi **Sigstore/Rekor**; arayüzü soyut tut (`interface AnchorSink`) ki
|
|
154
|
-
Trillian'a taşımak tek dosya değişikliği olsun.
|
|
155
|
-
- **Yalnızca hash gider.** Alan adı, tablo adı, müşteri adı, IP — hiçbiri.
|
|
156
|
-
- **Asenkron ve bloklamaz:** çıpa başarısız olursa makbuz üretimi devam eder, `anchor: null` kalır.
|
|
157
|
-
- Sıklık: `CONARIUM_ANCHOR_EVERY_N` (varsayılan 100) veya `CONARIUM_ANCHOR_EVERY_MS`
|
|
158
|
-
(varsayılan 3600000) — hangisi önce dolarsa.
|
|
159
|
-
- Çıpa başarısızlığı **sessiz olmayacak**: sayaç tut, N ardışık başarısızlıkta `console.error`.
|
|
160
|
-
|
|
161
|
-
**Kabul:** ağ kapalıyken makbuz üretimi çalışıyor, `anchor: null`, hata loglanıyor. Ağ açıkken
|
|
162
|
-
çıpa girişi oluşuyor ve `--anchor-check` 0 dönüyor.
|
|
163
|
-
|
|
164
|
-
⚠️ Rekor'a gerçek yazma **testte yapılmaz** (dış servise bağlı test kırılgandır). `AnchorSink`
|
|
165
|
-
sahte uygulamayla test edilir; gerçek Rekor entegrasyonu elle bir kez doğrulanır ve sonucu
|
|
166
|
-
buraya yazılır.
|
|
167
|
-
|
|
168
|
-
---
|
|
169
|
-
|
|
170
|
-
## T8 — Dokümantasyon
|
|
171
|
-
- `README.md`: "Verifiable Receipts" bölümü + `conarium-verify` kullanımı + **daraltılmış iddia
|
|
172
|
-
cümlesi birebir** (tasarım §3). İddiayı genişletme.
|
|
173
|
-
- `docs/RECEIPT-SPEC.md` (yeni): şemanın kamuya açık spesifikasyonu, Madde 12/19 eşleme tablosu,
|
|
174
|
-
bilinen boşluklar bölümü (tasarım §7 aynen taşınır — boşlukları saklamıyoruz).
|
|
175
|
-
- `CHANGELOG` girdisi.
|
|
176
|
-
|
|
177
|
-
---
|
|
178
|
-
|
|
179
|
-
## Sıra ve gate noktaları
|
|
180
|
-
|
|
181
|
-
```
|
|
182
|
-
T1 ─▶ T2 ─▶ T3 ─▶ T4 ─▶ T5 ─▶ T6 ══GATE 1══▶ T7 ─▶ T8 ══GATE 2══▶ push (patron onayı)
|
|
183
|
-
(Claude) (Claude)
|
|
184
|
-
```
|
|
185
|
-
|
|
186
|
-
**GATE 1** (T6 sonrası): Claude diff'i inceler. Bakılacaklar: fail-closed gerçekten kapandı mı ·
|
|
187
|
-
T5.10 iki uygulama ayrışmıyor mu · T6 sızıntı testi gerçek mi yoksa göstermelik mi ·
|
|
188
|
-
HMAC geriye dönük uyumluluk bozulmamış mı · `governance.ts`'e dokunulmuş mu.
|
|
189
|
-
|
|
190
|
-
**GATE 2** (T8 sonrası): iddia metni genişletilmiş mi (en sık kaçak burada olur) ·
|
|
191
|
-
README'de kanıtlanamayan cümle var mı.
|
|
192
|
-
|
|
193
|
-
Push öncesi zorunlu: `git log --oneline origin/main..HEAD` ile gate'siz commit kaçmadığını
|
|
194
|
-
doğrula (Cursor paralel commit ekleyebiliyor).
|
|
195
|
-
|
|
196
|
-
---
|
|
197
|
-
|
|
198
|
-
## Kapsam dışı (bilinçli — bu planda YOK)
|
|
199
|
-
Kişi bazlı kimlik/OAuth · rıza bağlama mantığı · kapsama/olumsuz kanıt raporu · maruziyet skoru ·
|
|
200
|
-
donanım tasdiki · `/proof/live` ucu (ayrı iş, bu bittikten sonra) · MCP tehdit tespiti.
|
|
1
|
+
# Conarium Receipt v0.1 — Uygulama Planı (Cursor için)
|
|
2
|
+
|
|
3
|
+
**Tasarım:** `docs/superpowers/specs/2026-07-29-conarium-receipt-design.md` — **önce onu oku.**
|
|
4
|
+
**Uygulayan:** Cursor · **Gate:** Claude (push öncesi diff incelemesi) · **Dal:** `feat/receipt-v01`
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## ⛔ Cursor için sınırlar (ihlal = gate reddi)
|
|
9
|
+
|
|
10
|
+
1. **`git push` YOK, `git commit` serbest.** Push kararı patronun.
|
|
11
|
+
2. **`src/governance.ts` içindeki maskeleme mantığına DOKUNMA.** Bu iş denetim/imza katmanı.
|
|
12
|
+
3. **Mevcut HMAC davranışını BOZMA.** `signature` alanı ve `scripts/audit-chain-check.mjs`
|
|
13
|
+
çalışmaya devam etmeli. Yeni imza ayrı alan (`sig`).
|
|
14
|
+
4. **`as any` / `as string` ile tip atlatma YOK** (repo `AGENTS.md` kuralı).
|
|
15
|
+
5. **Testte gerçek assert.** "Çalıştı, hata vermedi" test değil. Her test bir bozulma senaryosunu
|
|
16
|
+
kanıtlamalı.
|
|
17
|
+
6. **Makbuza ham veri yazma.** Sorgu metni, alan değeri, müşteri adı — hiçbiri. Sadece sayı,
|
|
18
|
+
sınıf adı ve hash. Bu kuralın testi T9'da.
|
|
19
|
+
7. Bir şey belirsizse **uydurma, sor.** Tasarım dokümanında cevabı yoksa dur.
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## T1 — Ed25519 anahtar yönetimi
|
|
24
|
+
**Dosya:** `src/keys.ts` (yeni)
|
|
25
|
+
|
|
26
|
+
```ts
|
|
27
|
+
export type KeyId = string // örn "cnr-2026-07"
|
|
28
|
+
export interface SigningKey { keyId: KeyId; privateKey: KeyObject }
|
|
29
|
+
export interface VerifyKey { keyId: KeyId; publicKey: KeyObject }
|
|
30
|
+
|
|
31
|
+
export function generateKeyPair(keyId: KeyId): { privatePem: string; publicPem: string }
|
|
32
|
+
export function loadSigningKey(): SigningKey | null // env/dosyadan, yoksa null
|
|
33
|
+
export function loadVerifyKeys(paths: string[]): VerifyKey[] // rotasyon: çoklu
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
- Node `crypto` (`generateKeyPairSync('ed25519')`). Ek bağımlılık YOK.
|
|
37
|
+
- Özel anahtar yolu: `CONARIUM_AUDIT_SIGNING_KEY` (dosya yolu). Dosya izni 0600 değilse
|
|
38
|
+
**uyarı bas** (Windows'ta izin kontrolünü atla, platform kontrolü koy).
|
|
39
|
+
- `keyId` açık anahtar dosyasının yanında `.keyid` olarak saklanır ya da PEM yorumundan okunur —
|
|
40
|
+
hangisini seçtiysen dokümana yaz.
|
|
41
|
+
|
|
42
|
+
**Kabul:** `generateKeyPair` → `loadVerifyKeys` → imzala/doğrula turu yeşil. Bozuk PEM'de
|
|
43
|
+
anlamlı hata, `throw new Error('...')` mesajı ne olduğunu söylüyor.
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## T2 — Makbuz şeması ve üretici
|
|
48
|
+
**Dosya:** `src/receipt.ts` (yeni)
|
|
49
|
+
|
|
50
|
+
Tasarım §4'teki JSON şemasını birebir uygula. `Receipt` tipini export et.
|
|
51
|
+
|
|
52
|
+
```ts
|
|
53
|
+
export function buildReceipt(input: ReceiptInput, chain: ChainState, key: SigningKey | null): Receipt
|
|
54
|
+
export function canonicalize(obj: unknown): string // RFC 8785 (JCS)
|
|
55
|
+
export function receiptHash(r: Omit<Receipt,'hash'|'sig'|'anchor'>): string
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
- `canonicalize`: anahtarlar sıralı, boşluksuz, `undefined` alanlar atlanır. Küçük ve **kendi
|
|
59
|
+
yazdığın** bir fonksiyon olsun (JCS için ağır kütüphane çekme), ama testi sağlam olsun:
|
|
60
|
+
anahtar sırası farklı iki eşdeğer nesne aynı string üretmeli.
|
|
61
|
+
- `hash` = `sha256(canonicalize(receipt \ {hash,sig,anchor}))`, `sha256:` önekli hex.
|
|
62
|
+
- **`seq` zorunlu**, ardışık, boşluksuz. Tasarım §4'teki gerekçe: kapsama kanıtının tek dayanağı.
|
|
63
|
+
- `actor.type` v0.1'de daima `"service"`. `"user"` tipini şemada tanımla ama **üretme** —
|
|
64
|
+
Katman 2 işi.
|
|
65
|
+
- `consentRef` alanı tanımlı ve daima `null`. Şimdi rezerve, mantığı v0.2.
|
|
66
|
+
|
|
67
|
+
**Kabul:** aynı girdi → aynı hash (deterministik). Alan sırası değişince hash değişmiyor.
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## T3 — Fail-closed imzalama (mevcut kusurun düzeltmesi)
|
|
72
|
+
**Dosya:** `src/audit.ts`
|
|
73
|
+
|
|
74
|
+
🔴 **Bugünkü kusur:** satır ~121 `if (this.hmacKey) { full.signature = ... }` ve satır ~167'de
|
|
75
|
+
aynı şekilde doğrulama — **anahtar yoksa imzalama VE doğrulama sessizce atlanıyor, hata yok.**
|
|
76
|
+
Bu, `conarium-concierge`'de bulunan yalancı arıza deseninin aynısı.
|
|
77
|
+
|
|
78
|
+
Yeni davranış:
|
|
79
|
+
- Ed25519 anahtarı varsa → `sig` üret
|
|
80
|
+
- HMAC anahtarı varsa → `signature` üret (geriye dönük uyumluluk)
|
|
81
|
+
- **İkisi de yoksa** → `CONARIUM_AUDIT_UNSIGNED=1` açıkça ayarlanmadıkça **`throw`**.
|
|
82
|
+
Ayarlıysa her başlangıçta bir kez `console.warn` bas (sessiz kalma).
|
|
83
|
+
- Doğrulama tarafında da aynı: anahtar yokken "geçti" dönmeyecek, "doğrulanamadı" diyecek.
|
|
84
|
+
|
|
85
|
+
**Kabul:** anahtarsız + env yok → `log()` fırlatıyor, test bunu doğruluyor. Anahtarsız +
|
|
86
|
+
`CONARIUM_AUDIT_UNSIGNED=1` → çalışıyor ama uyarı basılıyor. Mevcut 3 audit testi
|
|
87
|
+
(`audit.chain.test.ts`, `audit.failclosed.test.ts`, `audit-secrets.test.ts`) hâlâ yeşil.
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
## T4 — Bağımsız doğrulayıcı
|
|
92
|
+
**Dosya:** `bin/conarium-verify.mjs` (yeni, tek dosya, `src/`'a import YOK)
|
|
93
|
+
|
|
94
|
+
Neden kopya mantık: doğrulayıcının değeri **bize bağımlı olmamasında.** Üçüncü taraf `npm i`
|
|
95
|
+
yapmadan, repoyu klonlamadan tek dosyayı çalıştırabilmeli. Kanonikleştirme mantığı burada
|
|
96
|
+
tekrar yazılır — ve T5'te iki uygulamanın aynı hash'i ürettiği test edilir.
|
|
97
|
+
|
|
98
|
+
```
|
|
99
|
+
conarium-verify <dosya|dizin> --pubkey <yol> [--pubkey <yol2> ...] [--anchor-check] [--expect-seq-from N]
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Çıkış kodları (tasarım §5):
|
|
103
|
+
`0` sağlam · `10` hash uyuşmuyor · `11` prevHash kopuk · `12` seq boşluklu/azalan ·
|
|
104
|
+
`13` imza geçersiz · `14` çıpa doğrulanamadı · `20` şema geçersiz
|
|
105
|
+
|
|
106
|
+
- Her hata: **insan-okunur tek satır stderr + `--json` ile makine-okunur çıktı.**
|
|
107
|
+
- **Fail-closed:** emin olunamayan hiçbir durumda 0 dönmez. Anahtar verilmediyse 13 ile çık,
|
|
108
|
+
"imzalar kontrol edilmedi" deyip 0 dönme.
|
|
109
|
+
- Boş dosya / tek kayıt → 0 ama stderr'e uyarı.
|
|
110
|
+
|
|
111
|
+
**Kabul:** T5'teki 10 senaryonun tamamı beklenen kodu döndürüyor.
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
## T5 — Testler
|
|
116
|
+
**Dosya:** `src/receipt.test.ts` (yeni) + `test/verify.test.mjs` (yeni)
|
|
117
|
+
|
|
118
|
+
| # | Senaryo | Beklenen |
|
|
119
|
+
|---|---|---|
|
|
120
|
+
| T5.1 | Ortadaki kaydın bir alanını değiştir | 10 |
|
|
121
|
+
| T5.2 | Ortadaki kaydı sil | 11 |
|
|
122
|
+
| T5.3 | İki kaydın yerini değiştir | 11 veya 12 |
|
|
123
|
+
| T5.4 | `seq` atlat (1041→1043) | 12 |
|
|
124
|
+
| T5.5 | Başka anahtarla imzala | 13 |
|
|
125
|
+
| T5.6 | Rotasyon: eski+yeni `keyId` karışık zincir, iki açık anahtar verilmiş | 0 |
|
|
126
|
+
| T5.7 | Boş zincir / tek kayıt | 0 + uyarı |
|
|
127
|
+
| T5.8 | `anchor: null` + `--anchor-check` | 14 |
|
|
128
|
+
| T5.9 | Anahtar hiç yok, env yok | üretim `throw` |
|
|
129
|
+
| T5.10 | `src/receipt.ts` ve `bin/conarium-verify.mjs` aynı makbuz için aynı hash'i üretiyor | eşit |
|
|
130
|
+
|
|
131
|
+
**T5.10 en kritik test.** İki bağımsız kanonikleştirme uygulaması ayrışırsa doğrulayıcı yanlış
|
|
132
|
+
alarm üretir ve tüm iddia çöker.
|
|
133
|
+
|
|
134
|
+
---
|
|
135
|
+
|
|
136
|
+
## T6 — Ham veri sızıntı regresyonu (zorunlu)
|
|
137
|
+
**Dosya:** `src/receipt.leak.test.ts` (yeni)
|
|
138
|
+
|
|
139
|
+
Sentetik ama gerçekçi bir veri kümesinden (e-posta, telefon, TCKN, isim, API anahtarı) makbuz
|
|
140
|
+
üret. Üretilen makbuzun **tam JSON metninde** her ham değeri ara. **0 eşleşme zorunlu.**
|
|
141
|
+
|
|
142
|
+
`argsHash` alanının ham SQL içermediğini ayrıca doğrula (SQL string'i makbuzda geçmemeli).
|
|
143
|
+
|
|
144
|
+
**Kabul:** test yeşil. Bu test kırmızıysa hiçbir şey merge edilmez — makbuz bir sızıntı yüzeyi
|
|
145
|
+
olamaz.
|
|
146
|
+
|
|
147
|
+
---
|
|
148
|
+
|
|
149
|
+
## T7 — Çıpalama (en son, ağ bağımlılığı var)
|
|
150
|
+
**Dosya:** `src/anchor.ts` (yeni)
|
|
151
|
+
|
|
152
|
+
- Zincir başı (`hash` + `seq` + `keyId`) periyodik olarak kamu şeffaflık kütüğüne yazılır.
|
|
153
|
+
Başlangıç hedefi **Sigstore/Rekor**; arayüzü soyut tut (`interface AnchorSink`) ki
|
|
154
|
+
Trillian'a taşımak tek dosya değişikliği olsun.
|
|
155
|
+
- **Yalnızca hash gider.** Alan adı, tablo adı, müşteri adı, IP — hiçbiri.
|
|
156
|
+
- **Asenkron ve bloklamaz:** çıpa başarısız olursa makbuz üretimi devam eder, `anchor: null` kalır.
|
|
157
|
+
- Sıklık: `CONARIUM_ANCHOR_EVERY_N` (varsayılan 100) veya `CONARIUM_ANCHOR_EVERY_MS`
|
|
158
|
+
(varsayılan 3600000) — hangisi önce dolarsa.
|
|
159
|
+
- Çıpa başarısızlığı **sessiz olmayacak**: sayaç tut, N ardışık başarısızlıkta `console.error`.
|
|
160
|
+
|
|
161
|
+
**Kabul:** ağ kapalıyken makbuz üretimi çalışıyor, `anchor: null`, hata loglanıyor. Ağ açıkken
|
|
162
|
+
çıpa girişi oluşuyor ve `--anchor-check` 0 dönüyor.
|
|
163
|
+
|
|
164
|
+
⚠️ Rekor'a gerçek yazma **testte yapılmaz** (dış servise bağlı test kırılgandır). `AnchorSink`
|
|
165
|
+
sahte uygulamayla test edilir; gerçek Rekor entegrasyonu elle bir kez doğrulanır ve sonucu
|
|
166
|
+
buraya yazılır.
|
|
167
|
+
|
|
168
|
+
---
|
|
169
|
+
|
|
170
|
+
## T8 — Dokümantasyon
|
|
171
|
+
- `README.md`: "Verifiable Receipts" bölümü + `conarium-verify` kullanımı + **daraltılmış iddia
|
|
172
|
+
cümlesi birebir** (tasarım §3). İddiayı genişletme.
|
|
173
|
+
- `docs/RECEIPT-SPEC.md` (yeni): şemanın kamuya açık spesifikasyonu, Madde 12/19 eşleme tablosu,
|
|
174
|
+
bilinen boşluklar bölümü (tasarım §7 aynen taşınır — boşlukları saklamıyoruz).
|
|
175
|
+
- `CHANGELOG` girdisi.
|
|
176
|
+
|
|
177
|
+
---
|
|
178
|
+
|
|
179
|
+
## Sıra ve gate noktaları
|
|
180
|
+
|
|
181
|
+
```
|
|
182
|
+
T1 ─▶ T2 ─▶ T3 ─▶ T4 ─▶ T5 ─▶ T6 ══GATE 1══▶ T7 ─▶ T8 ══GATE 2══▶ push (patron onayı)
|
|
183
|
+
(Claude) (Claude)
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
**GATE 1** (T6 sonrası): Claude diff'i inceler. Bakılacaklar: fail-closed gerçekten kapandı mı ·
|
|
187
|
+
T5.10 iki uygulama ayrışmıyor mu · T6 sızıntı testi gerçek mi yoksa göstermelik mi ·
|
|
188
|
+
HMAC geriye dönük uyumluluk bozulmamış mı · `governance.ts`'e dokunulmuş mu.
|
|
189
|
+
|
|
190
|
+
**GATE 2** (T8 sonrası): iddia metni genişletilmiş mi (en sık kaçak burada olur) ·
|
|
191
|
+
README'de kanıtlanamayan cümle var mı.
|
|
192
|
+
|
|
193
|
+
Push öncesi zorunlu: `git log --oneline origin/main..HEAD` ile gate'siz commit kaçmadığını
|
|
194
|
+
doğrula (Cursor paralel commit ekleyebiliyor).
|
|
195
|
+
|
|
196
|
+
---
|
|
197
|
+
|
|
198
|
+
## Kapsam dışı (bilinçli — bu planda YOK)
|
|
199
|
+
Kişi bazlı kimlik/OAuth · rıza bağlama mantığı · kapsama/olumsuz kanıt raporu · maruziyet skoru ·
|
|
200
|
+
donanım tasdiki · `/proof/live` ucu (ayrı iş, bu bittikten sonra) · MCP tehdit tespiti.
|