@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.
Files changed (102) hide show
  1. package/CHANGELOG.md +123 -1
  2. package/LICENSE +21 -21
  3. package/LIMITATIONS.md +23 -2
  4. package/LIMITATIONS.tr.md +13 -2
  5. package/bin/conarium-coverage.mjs +89 -6
  6. package/bin/conarium-doctor.mjs +44 -0
  7. package/bin/conarium-verify.mjs +110 -51
  8. package/dist/anchor.d.ts +11 -0
  9. package/dist/anchor.d.ts.map +1 -1
  10. package/dist/anchor.js +27 -0
  11. package/dist/anchor.js.map +1 -1
  12. package/dist/audit.d.ts +4 -0
  13. package/dist/audit.d.ts.map +1 -1
  14. package/dist/audit.js +124 -30
  15. package/dist/audit.js.map +1 -1
  16. package/dist/config.d.ts +14 -0
  17. package/dist/config.d.ts.map +1 -1
  18. package/dist/config.js +35 -0
  19. package/dist/config.js.map +1 -1
  20. package/dist/connectors/openapi.d.ts +14 -1
  21. package/dist/connectors/openapi.d.ts.map +1 -1
  22. package/dist/connectors/openapi.js +78 -5
  23. package/dist/connectors/openapi.js.map +1 -1
  24. package/dist/connectors/postgres.js +8 -8
  25. package/dist/console-receipts.d.ts +12 -1
  26. package/dist/console-receipts.d.ts.map +1 -1
  27. package/dist/console-receipts.js +14 -2
  28. package/dist/console-receipts.js.map +1 -1
  29. package/dist/console.d.ts.map +1 -1
  30. package/dist/console.js +15 -4
  31. package/dist/console.js.map +1 -1
  32. package/dist/coverage.d.ts +17 -1
  33. package/dist/coverage.d.ts.map +1 -1
  34. package/dist/coverage.js +30 -3
  35. package/dist/coverage.js.map +1 -1
  36. package/dist/digit_pii.d.ts.map +1 -1
  37. package/dist/digit_pii.js +24 -5
  38. package/dist/digit_pii.js.map +1 -1
  39. package/dist/governance.d.ts +2 -0
  40. package/dist/governance.d.ts.map +1 -1
  41. package/dist/governance.js +23 -8
  42. package/dist/governance.js.map +1 -1
  43. package/dist/http.d.ts +11 -1
  44. package/dist/http.d.ts.map +1 -1
  45. package/dist/http.js +87 -7
  46. package/dist/http.js.map +1 -1
  47. package/dist/iban.d.ts.map +1 -1
  48. package/dist/iban.js +6 -3
  49. package/dist/iban.js.map +1 -1
  50. package/dist/index.js +1 -0
  51. package/dist/index.js.map +1 -1
  52. package/dist/keys.d.ts +5 -0
  53. package/dist/keys.d.ts.map +1 -1
  54. package/dist/keys.js +22 -7
  55. package/dist/keys.js.map +1 -1
  56. package/dist/mask-text.d.ts +11 -0
  57. package/dist/mask-text.d.ts.map +1 -0
  58. package/dist/mask-text.js +42 -0
  59. package/dist/mask-text.js.map +1 -0
  60. package/dist/receipt-view.d.ts +13 -0
  61. package/dist/receipt-view.d.ts.map +1 -1
  62. package/dist/receipt-view.js +28 -5
  63. package/dist/receipt-view.js.map +1 -1
  64. package/dist/server.d.ts.map +1 -1
  65. package/dist/server.js +31 -15
  66. package/dist/server.js.map +1 -1
  67. package/dist/sql-gate/mssql.d.ts.map +1 -1
  68. package/dist/sql-gate/mssql.js +36 -2
  69. package/dist/sql-gate/mssql.js.map +1 -1
  70. package/dist/sql-gate/oracle.d.ts.map +1 -1
  71. package/dist/sql-gate/oracle.js +24 -3
  72. package/dist/sql-gate/oracle.js.map +1 -1
  73. package/dist/sql-gate/rules.d.ts +19 -1
  74. package/dist/sql-gate/rules.d.ts.map +1 -1
  75. package/dist/sql-gate/rules.js +116 -7
  76. package/dist/sql-gate/rules.js.map +1 -1
  77. package/dist/types.d.ts +6 -0
  78. package/dist/types.d.ts.map +1 -1
  79. package/docs/API-STABILITY.md +2 -2
  80. package/docs/ARCHITECTURE.md +42 -42
  81. package/docs/RECEIPT-SPEC.md +17 -11
  82. package/docs/plans/2026-07-02-redteam-harness.md +416 -416
  83. package/docs/specs/2026-07-02-redteam-harness-design.md +90 -90
  84. package/docs/superpowers/TODO-gate1-f4.md +23 -23
  85. package/docs/superpowers/plans/2026-07-29-conarium-receipt-plan.md +200 -200
  86. package/docs/superpowers/specs/2026-07-29-conarium-receipt-design.md +202 -202
  87. package/examples/claude-desktop-config.json +9 -9
  88. package/examples/cursor-mcp-settings.json +10 -10
  89. package/package.json +8 -1
  90. package/public/app.js +378 -378
  91. package/public/index.html +160 -160
  92. package/public/style.css +504 -504
  93. package/scripts/conarium_sabah_brief.mjs +107 -107
  94. package/scripts/start-mcp-c1.mjs +93 -93
  95. package/test-vectors/sql-gate/LAST-RUN.json +1 -1
  96. package/test-vectors/sql-gate/vectors.json +28 -0
  97. package/dist/openapi_connector.d.ts +0 -6
  98. package/dist/openapi_connector.d.ts.map +0 -1
  99. package/dist/openapi_connector.js +0 -145
  100. package/dist/openapi_connector.js.map +0 -1
  101. package/docs/audit/2026-08-14-security-scan.md +0 -48
  102. 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.