@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,202 +1,202 @@
1
- # Conarium Receipt v0.1 — Tasarım Dokümanı
2
-
3
- **Tarih:** 2026-07-29 · **Durum:** onay bekliyor · **Kapsam:** Katman 0 (okuyucudan bağımsız)
4
-
5
- ---
6
-
7
- ## 1. Problem
8
-
9
- AB AI Yasası **Madde 12** yüksek riskli AI sistemleri için otomatik, **kurcalanma-kanıtlı** kayıt
10
- zorunlu kılıyor; **Madde 19** içeriği sayıyor. Uygulama tarihi: 2 Aralık 2027 (bağımsız sistemler).
11
-
12
- Bugün Conarium'un denetim kaydı var ama **üçüncü tarafa hiçbir şey kanıtlamıyor**, çünkü imza
13
- simetrik (`createHmac('sha256', CONARIUM_AUDIT_HMAC_KEY)` — `src/audit.ts`). Doğrulayan taraf
14
- imzalayanla aynı gizli anahtarı tutmak zorunda; o anahtarı verdiğin an aynı kişi kayıt da
15
- uydurabilir. Yani mevcut kayıt **iç tutarlılık** sağlıyor, **inkâr edilemezlik** sağlamıyor.
16
-
17
- Bu doküman, denetim satırını taşınabilir ve bağımsız doğrulanabilir bir **makbuza** çeviriyor.
18
-
19
- ## 2. Kapsam (v0.1)
20
-
21
- **İçinde:** Ed25519 asimetrik imza · makbuz şeması (Md.12/19 eşlemeli) · bağımsız doğrulayıcı CLI ·
22
- zincir başının kamu şeffaflık kütüğüne çıpalanması · mevcut HMAC zincirlerinden geçiş.
23
-
24
- **Dışında (bilinçli):** kişi bazlı kimlik (ayrı iş, Katman 2) · rıza bağlama (alan rezerve edildi,
25
- mantık v0.2) · kapsama/olumsuz kanıt raporu (v0.2, ama v0.1 şeması buna izin verecek şekilde
26
- tasarlandı) · maruziyet skoru · donanım tasdiki.
27
-
28
- ## 3. En kritik karar: imzayı kim üretir, ne iddia ediyoruz
29
-
30
- Conarium self-hosted çalışır. Müşteri kendi anahtarıyla imzalarsa **müşteri makbuz uydurabilir.**
31
- Bu, hiçbir kriptografiyle çözülemez; sadece kapsamı dürüst daraltarak yönetilir.
32
-
33
- Değerlendirilen yollar:
34
-
35
- | Yol | Karar |
36
- |---|---|
37
- | (a) Conarium birlikte imzalar | ⛔ RED — trafiği görmemiz gerekir, "veri sınırından çıkmaz" vaadini bozar |
38
- | (b) Donanım tasdiki / TEE | ⏸ ERTELENDİ — kurulum yükü çok ağır, v0.1'i öldürür (Aegon bu yolu seçmiş) |
39
- | (c) Sadece çıpalama: yalnızca zincir başı bize gelir | ✅ **SEÇİLDİ** |
40
- | (d) Daraltılmış iddia beyanı | ✅ **SEÇİLDİ (c ile birlikte)** |
41
-
42
- **Sonuç ve resmî iddia metni** (asıl = İngilizce; TR çeviri):
43
-
44
- > A Conarium Receipt proves that records have **not been altered, deleted,
45
- > reordered, or backdated after they were created**. It does **not** prove they
46
- > were correct at the moment of creation.
47
-
48
- > *(TR)* Conarium Makbuzu, kayıtların **oluşturulduktan sonra değiştirilmediğini,
49
- > silinmediğini, yeniden sıralanmadığını ve geriye dönük tarihlenmediğini**
50
- > kanıtlar. **Oluşturma anında doğru olduğunu kanıtlamaz.**
51
-
52
- Bu daraltma bir zayıflık değil, satılabilir tek dürüst konum: rakiplerin "audit logging" iddiası
53
- bundan daha geniş ve daha az kanıtlanabilir.
54
-
55
- ## 4. Makbuz şeması v0.1
56
-
57
- Kural: **ham veri hiçbir alana girmez.** Yalnızca sayılar, sınıflar ve hash'ler.
58
-
59
- ```jsonc
60
- {
61
- "v": "conarium-receipt/0.1",
62
- "id": "01J8...", // ULID
63
- "ts": "2026-07-29T08:14:02.113Z", // Md.19: zaman damgası
64
- "period": { "start": "...", "end": "..." }, // Md.19: kullanım dönemi
65
-
66
- "actor": { "type": "service", "id": "conarium_c2" },
67
- // v0.1'de type daima "service" (bkz. §7 bilinen boşluk). Katman 2'de "user" + idp gelir.
68
-
69
- "model": { "provider": "anthropic", "name": "claude-haiku-4-5", "version": "20251001" }, // Md.19
70
- "client": { "name": "cursor", "version": "2.x" },
71
-
72
- "request": { "tool": "query", "target": "demo-db", "argsHash": "sha256:..." },
73
- // argsHash: sorgunun kendisi DEĞİL, hash'i. Ham SQL müşteri verisi içerebilir.
74
-
75
- "dataRefs": [ // Md.19: kontrol edilen referans veritabanları
76
- { "source": "zion", "object": "v_monthly", "fieldsRequested": ["month","revenue"] }
77
- ],
78
-
79
- "policy": { // Md.19: uygulanan yönetişim politikası
80
- "id": "conarium.config.c2", "version": "3",
81
- "decision": "partial", // allow | deny | partial
82
- "rulesApplied": ["allowlist.table", "mask.pii", "rowcap"]
83
- },
84
- "flags": ["rowcap_hit"], // Md.19: tetiklenen politika bayrakları
85
-
86
- "masking": {
87
- "maskedCount": 485496,
88
- "byClass": { "email": 121366, "phone": 98004, "tckn": 0, "secret": 0 },
89
- "rowsReturned": 121374,
90
- "rowCapApplied": false
91
- },
92
- "outcome": { "status": "complete", "denied": false },
93
-
94
- "consentRef": null, // v0.2 için rezerve (ISO/IEC TS 27560 kaydına bağlama)
95
-
96
- "chain": { "seq": 1042, "prevHash": "sha256:...", "hash": "sha256:..." },
97
- "sig": { "alg": "Ed25519", "keyId": "cnr-2026-07", "value": "base64..." },
98
- "anchor": null // asenkron doldurulur, bkz. §6
99
- }
100
- ```
101
-
102
- `hash` = `sha256(canonical_json(makbuz \ {hash, sig, anchor}))`. Kanonikleştirme: JCS (RFC 8785),
103
- anahtarlar sıralı, boşluksuz. `sig` = `Ed25519(hash)`.
104
-
105
- **Neden `seq` var:** ardışık ve boşluksuz sıra numarası, "hiçbir etkileşim eksik değil"
106
- iddiasının tek dayanağı. Kapsama/olumsuz kanıt (v0.2) buna oturacak. v0.1'de üretmesek de
107
- şemaya şimdi koymak zorundayız, sonradan eklenirse geçmiş zincir işe yaramaz.
108
-
109
- ## 5. Doğrulayıcı sözleşmesi
110
-
111
- Tek dosya, sıfır Conarium bağımlılığı, çevrimdışı çalışır. Ağ yalnızca `--anchor-check` ile.
112
-
113
- ```
114
- conarium-verify <dosya|dizin> --pubkey <yol|url> [--anchor-check] [--expect-seq-from N]
115
- ```
116
-
117
- Kontroller ve çıkış kodları:
118
-
119
- | Kod | Anlam |
120
- |---|---|
121
- | 0 | Zincir sağlam, imzalar geçerli |
122
- | 10 | `hash` yeniden hesaplanamıyor → kayıt değiştirilmiş |
123
- | 11 | `prevHash` kopuk → kayıt silinmiş ya da araya eklenmiş |
124
- | 12 | `seq` boşluklu ya da azalıyor → kayıt eksik / yeniden sıralanmış |
125
- | 13 | İmza geçersiz → yetkisiz anahtarla üretilmiş |
126
- | 14 | Çıpa kanıtı doğrulanamadı → geriye dönük tarihlenmiş olabilir |
127
- | 20 | Şema geçersiz |
128
-
129
- Her hata **insan-okunur tek satır + makine-okunur JSON** basar. Sessiz başarısızlık yok:
130
- doğrulayıcı emin olamadığı hiçbir durumda 0 dönmez (fail-closed).
131
-
132
- ## 6. Çıpalama
133
-
134
- Kendi Sertifika Otoritemizi kurmuyoruz. Zincir başı (`hash` + `seq` + `keyId`) periyodik olarak
135
- mevcut bir kamu şeffaflık kütüğüne yazılır (Sigstore/Rekor veya Trillian). Yazılan şey **yalnızca
136
- hash'tir** — veri değil, alan adı değil, tablo adı değil.
137
-
138
- ```
139
- Conarium (müşteri sunucusu) Kamu şeffaflık kütüğü
140
- makbuz #1042 ──┐
141
- makbuz #1043 ├─ zincir başı hash ──────▶ kütük girişi + inclusion proof
142
- makbuz #1044 ──┘ │
143
- anchor alanı ◀────────────┘
144
- ```
145
-
146
- Bu neden önemli: çıpa olmadan operatör tüm zinciri baştan yeniden üretip eski tarih yazabilir.
147
- Çıpa ile "bu hash şu tarihte zaten vardı" bağımsız olarak kanıtlanır.
148
-
149
- ⚠️ Çıpalama **asenkron** ve **başarısız olabilir** (ağ yok, kütük erişilemez). Tasarım kararı:
150
- çıpa başarısızlığı makbuz üretimini **bloklamaz**, ama `anchor: null` kalır ve doğrulayıcı
151
- `--anchor-check` ile çağrıldığında bunu **eksik** olarak raporlar (sessizce geçmez).
152
-
153
- ## 7. Bilinen boşluklar (dokümante ediliyor, saklanmıyor)
154
-
155
- 1. **`actor` gerçek insanı göstermiyor.** v0.1'de daima servis kimliği. Bir ekipte on kişinin on
156
- erişimi aynı isimle düşer. Katman 2'de per-user OAuth ile kapanacak. **Bu boşluk kapanmadan
157
- "kim erişti" iddiası pazarlama metninde kullanılamaz.**
158
- 2. **Bypass tespiti yok.** Operatör Conarium'u tamamen devre dışı bırakıp veriye doğrudan
159
- erişirse makbuz hiç üretilmez ve zincir yine sağlam görünür. Kapsama kanıtı (v0.2) bunu
160
- *beyan edilmiş şema* karşısında kısmen tespit edebilir, tamamen çözemez.
161
- 3. **Oluşturma anı doğruluğu kanıtlanamıyor** (bkz. §3). Donanım tasdiki olmadan çözümü yok.
162
- 4. **In-file `sig` stripping + HMAC/`anchor` azaltımı.** İçerik `hash`'i `{hash, sig, anchor}`
163
- (ve audit `signature`/`sig`) hariç hesaplanır; dosyayı kontrol eden operatör bu alanları
164
- düşürüp/inceltebilir ve içerik hash'i bozulmaz. Bitişiklik + trust store boot'ta bir kısmını
165
- yakalar, ama in-file strip/reduce oyunlarına karşı tam koruma **in-file çözülemez** —
166
- dış çıpa (şeffaflık kütüğü) ve/veya band-dışı anahtar töreni gerekir.
167
- 5. **`argsHash` ile hata ayıklama zorlaşıyor.** Ham sorguyu tutmuyoruz; destek vakalarında
168
- müşterinin kendi tarafındaki logla eşleştirmek gerekecek. Kabul edilen ödün.
169
-
170
- ## 8. Geçiş (mevcut zincirler bozulmayacak)
171
-
172
- `src/audit.ts` bugün `signature` alanına HMAC yazıyor. Plan:
173
- - `signature` alanı **korunur** (geriye dönük uyumluluk, mevcut `audit-chain-check.mjs` çalışmaya devam eder)
174
- - yeni `sig` alanı Ed25519 ile eklenir
175
- - `CONARIUM_AUDIT_HMAC_KEY` yoksa ve Ed25519 anahtarı varsa yalnızca `sig` üretilir
176
- - ikisi de yoksa: **fail-closed** — imzasız makbuz üretmeyi reddet (bugünkü davranış imzayı
177
- sessizce atlıyor, bu düzeltilecek)
178
- - anahtar üretimi: `conarium keygen` → özel anahtar diskte 0600, açık anahtar + `keyId` yayımlanabilir
179
- - anahtar rotasyonu: `keyId` her makbuzda taşınır, doğrulayıcı birden fazla açık anahtar kabul eder
180
-
181
- ## 9. Test planı
182
-
183
- | Senaryo | Beklenen |
184
- |---|---|
185
- | Ortadaki kaydın bir alanını değiştir | çıkış 10 |
186
- | Ortadaki kaydı sil | çıkış 11 |
187
- | İki kaydın yerini değiştir | çıkış 11 veya 12 |
188
- | `seq` atlat (1041 → 1043) | çıkış 12 |
189
- | Başka anahtarla imzala | çıkış 13 |
190
- | Rotasyon: eski+yeni keyId karışık zincir | çıkış 0 (iki açık anahtar verilirse) |
191
- | Boş zincir / tek kayıt | çıkış 0, uyarı basar |
192
- | `anchor: null` + `--anchor-check` | çıkış 14, eksik olarak raporlanır |
193
- | İmza anahtarı hiç yok | üretim reddedilir (fail-closed), test bunu doğrular |
194
- | Ham PII sızıntı taraması: 121k'lık gerçek koşudan üretilen makbuzlarda ham değer ara | 0 eşleşme |
195
-
196
- Son satır zorunlu regresyon: makbuzun kendisi bir sızıntı yüzeyi olamaz.
197
-
198
- ## 10. Açık sorular (uygulamayı bloklamıyor)
199
-
200
- - Çıpa hedefi Rekor mu, kendi Trillian örneğimiz mi? (Rekor ile başla, bağımlılık riski varsa taşı)
201
- - Çıpalama sıklığı: her N makbuz mu, her T dakika mı? (öneri: ikisinin ilki, yapılandırılabilir)
202
- - `consentRef` şeması ISO/IEC TS 27560'ın hangi alanlarını taşıyacak? (v0.2)
1
+ # Conarium Receipt v0.1 — Tasarım Dokümanı
2
+
3
+ **Tarih:** 2026-07-29 · **Durum:** onay bekliyor · **Kapsam:** Katman 0 (okuyucudan bağımsız)
4
+
5
+ ---
6
+
7
+ ## 1. Problem
8
+
9
+ AB AI Yasası **Madde 12** yüksek riskli AI sistemleri için otomatik, **kurcalanma-kanıtlı** kayıt
10
+ zorunlu kılıyor; **Madde 19** içeriği sayıyor. Uygulama tarihi: 2 Aralık 2027 (bağımsız sistemler).
11
+
12
+ Bugün Conarium'un denetim kaydı var ama **üçüncü tarafa hiçbir şey kanıtlamıyor**, çünkü imza
13
+ simetrik (`createHmac('sha256', CONARIUM_AUDIT_HMAC_KEY)` — `src/audit.ts`). Doğrulayan taraf
14
+ imzalayanla aynı gizli anahtarı tutmak zorunda; o anahtarı verdiğin an aynı kişi kayıt da
15
+ uydurabilir. Yani mevcut kayıt **iç tutarlılık** sağlıyor, **inkâr edilemezlik** sağlamıyor.
16
+
17
+ Bu doküman, denetim satırını taşınabilir ve bağımsız doğrulanabilir bir **makbuza** çeviriyor.
18
+
19
+ ## 2. Kapsam (v0.1)
20
+
21
+ **İçinde:** Ed25519 asimetrik imza · makbuz şeması (Md.12/19 eşlemeli) · bağımsız doğrulayıcı CLI ·
22
+ zincir başının kamu şeffaflık kütüğüne çıpalanması · mevcut HMAC zincirlerinden geçiş.
23
+
24
+ **Dışında (bilinçli):** kişi bazlı kimlik (ayrı iş, Katman 2) · rıza bağlama (alan rezerve edildi,
25
+ mantık v0.2) · kapsama/olumsuz kanıt raporu (v0.2, ama v0.1 şeması buna izin verecek şekilde
26
+ tasarlandı) · maruziyet skoru · donanım tasdiki.
27
+
28
+ ## 3. En kritik karar: imzayı kim üretir, ne iddia ediyoruz
29
+
30
+ Conarium self-hosted çalışır. Müşteri kendi anahtarıyla imzalarsa **müşteri makbuz uydurabilir.**
31
+ Bu, hiçbir kriptografiyle çözülemez; sadece kapsamı dürüst daraltarak yönetilir.
32
+
33
+ Değerlendirilen yollar:
34
+
35
+ | Yol | Karar |
36
+ |---|---|
37
+ | (a) Conarium birlikte imzalar | ⛔ RED — trafiği görmemiz gerekir, "veri sınırından çıkmaz" vaadini bozar |
38
+ | (b) Donanım tasdiki / TEE | ⏸ ERTELENDİ — kurulum yükü çok ağır, v0.1'i öldürür (Aegon bu yolu seçmiş) |
39
+ | (c) Sadece çıpalama: yalnızca zincir başı bize gelir | ✅ **SEÇİLDİ** |
40
+ | (d) Daraltılmış iddia beyanı | ✅ **SEÇİLDİ (c ile birlikte)** |
41
+
42
+ **Sonuç ve resmî iddia metni** (asıl = İngilizce; TR çeviri):
43
+
44
+ > A Conarium Receipt proves that records have **not been altered, deleted,
45
+ > reordered, or backdated after they were created**. It does **not** prove they
46
+ > were correct at the moment of creation.
47
+
48
+ > *(TR)* Conarium Makbuzu, kayıtların **oluşturulduktan sonra değiştirilmediğini,
49
+ > silinmediğini, yeniden sıralanmadığını ve geriye dönük tarihlenmediğini**
50
+ > kanıtlar. **Oluşturma anında doğru olduğunu kanıtlamaz.**
51
+
52
+ Bu daraltma bir zayıflık değil, satılabilir tek dürüst konum: rakiplerin "audit logging" iddiası
53
+ bundan daha geniş ve daha az kanıtlanabilir.
54
+
55
+ ## 4. Makbuz şeması v0.1
56
+
57
+ Kural: **ham veri hiçbir alana girmez.** Yalnızca sayılar, sınıflar ve hash'ler.
58
+
59
+ ```jsonc
60
+ {
61
+ "v": "conarium-receipt/0.1",
62
+ "id": "01J8...", // ULID
63
+ "ts": "2026-07-29T08:14:02.113Z", // Md.19: zaman damgası
64
+ "period": { "start": "...", "end": "..." }, // Md.19: kullanım dönemi
65
+
66
+ "actor": { "type": "service", "id": "conarium_c2" },
67
+ // v0.1'de type daima "service" (bkz. §7 bilinen boşluk). Katman 2'de "user" + idp gelir.
68
+
69
+ "model": { "provider": "anthropic", "name": "claude-haiku-4-5", "version": "20251001" }, // Md.19
70
+ "client": { "name": "cursor", "version": "2.x" },
71
+
72
+ "request": { "tool": "query", "target": "demo-db", "argsHash": "sha256:..." },
73
+ // argsHash: sorgunun kendisi DEĞİL, hash'i. Ham SQL müşteri verisi içerebilir.
74
+
75
+ "dataRefs": [ // Md.19: kontrol edilen referans veritabanları
76
+ { "source": "zion", "object": "v_monthly", "fieldsRequested": ["month","revenue"] }
77
+ ],
78
+
79
+ "policy": { // Md.19: uygulanan yönetişim politikası
80
+ "id": "conarium.config.c2", "version": "3",
81
+ "decision": "partial", // allow | deny | partial
82
+ "rulesApplied": ["allowlist.table", "mask.pii", "rowcap"]
83
+ },
84
+ "flags": ["rowcap_hit"], // Md.19: tetiklenen politika bayrakları
85
+
86
+ "masking": {
87
+ "maskedCount": 485496,
88
+ "byClass": { "email": 121366, "phone": 98004, "tckn": 0, "secret": 0 },
89
+ "rowsReturned": 121374,
90
+ "rowCapApplied": false
91
+ },
92
+ "outcome": { "status": "complete", "denied": false },
93
+
94
+ "consentRef": null, // v0.2 için rezerve (ISO/IEC TS 27560 kaydına bağlama)
95
+
96
+ "chain": { "seq": 1042, "prevHash": "sha256:...", "hash": "sha256:..." },
97
+ "sig": { "alg": "Ed25519", "keyId": "cnr-2026-07", "value": "base64..." },
98
+ "anchor": null // asenkron doldurulur, bkz. §6
99
+ }
100
+ ```
101
+
102
+ `hash` = `sha256(canonical_json(makbuz \ {hash, sig, anchor}))`. Kanonikleştirme: JCS (RFC 8785),
103
+ anahtarlar sıralı, boşluksuz. `sig` = `Ed25519(hash)`.
104
+
105
+ **Neden `seq` var:** ardışık ve boşluksuz sıra numarası, "hiçbir etkileşim eksik değil"
106
+ iddiasının tek dayanağı. Kapsama/olumsuz kanıt (v0.2) buna oturacak. v0.1'de üretmesek de
107
+ şemaya şimdi koymak zorundayız, sonradan eklenirse geçmiş zincir işe yaramaz.
108
+
109
+ ## 5. Doğrulayıcı sözleşmesi
110
+
111
+ Tek dosya, sıfır Conarium bağımlılığı, çevrimdışı çalışır. Ağ yalnızca `--anchor-check` ile.
112
+
113
+ ```
114
+ conarium-verify <dosya|dizin> --pubkey <yol|url> [--anchor-check] [--expect-seq-from N]
115
+ ```
116
+
117
+ Kontroller ve çıkış kodları:
118
+
119
+ | Kod | Anlam |
120
+ |---|---|
121
+ | 0 | Zincir sağlam, imzalar geçerli |
122
+ | 10 | `hash` yeniden hesaplanamıyor → kayıt değiştirilmiş |
123
+ | 11 | `prevHash` kopuk → kayıt silinmiş ya da araya eklenmiş |
124
+ | 12 | `seq` boşluklu ya da azalıyor → kayıt eksik / yeniden sıralanmış |
125
+ | 13 | İmza geçersiz → yetkisiz anahtarla üretilmiş |
126
+ | 14 | Çıpa kanıtı doğrulanamadı → geriye dönük tarihlenmiş olabilir |
127
+ | 20 | Şema geçersiz |
128
+
129
+ Her hata **insan-okunur tek satır + makine-okunur JSON** basar. Sessiz başarısızlık yok:
130
+ doğrulayıcı emin olamadığı hiçbir durumda 0 dönmez (fail-closed).
131
+
132
+ ## 6. Çıpalama
133
+
134
+ Kendi Sertifika Otoritemizi kurmuyoruz. Zincir başı (`hash` + `seq` + `keyId`) periyodik olarak
135
+ mevcut bir kamu şeffaflık kütüğüne yazılır (Sigstore/Rekor veya Trillian). Yazılan şey **yalnızca
136
+ hash'tir** — veri değil, alan adı değil, tablo adı değil.
137
+
138
+ ```
139
+ Conarium (müşteri sunucusu) Kamu şeffaflık kütüğü
140
+ makbuz #1042 ──┐
141
+ makbuz #1043 ├─ zincir başı hash ──────▶ kütük girişi + inclusion proof
142
+ makbuz #1044 ──┘ │
143
+ anchor alanı ◀────────────┘
144
+ ```
145
+
146
+ Bu neden önemli: çıpa olmadan operatör tüm zinciri baştan yeniden üretip eski tarih yazabilir.
147
+ Çıpa ile "bu hash şu tarihte zaten vardı" bağımsız olarak kanıtlanır.
148
+
149
+ ⚠️ Çıpalama **asenkron** ve **başarısız olabilir** (ağ yok, kütük erişilemez). Tasarım kararı:
150
+ çıpa başarısızlığı makbuz üretimini **bloklamaz**, ama `anchor: null` kalır ve doğrulayıcı
151
+ `--anchor-check` ile çağrıldığında bunu **eksik** olarak raporlar (sessizce geçmez).
152
+
153
+ ## 7. Bilinen boşluklar (dokümante ediliyor, saklanmıyor)
154
+
155
+ 1. **`actor` gerçek insanı göstermiyor.** v0.1'de daima servis kimliği. Bir ekipte on kişinin on
156
+ erişimi aynı isimle düşer. Katman 2'de per-user OAuth ile kapanacak. **Bu boşluk kapanmadan
157
+ "kim erişti" iddiası pazarlama metninde kullanılamaz.**
158
+ 2. **Bypass tespiti yok.** Operatör Conarium'u tamamen devre dışı bırakıp veriye doğrudan
159
+ erişirse makbuz hiç üretilmez ve zincir yine sağlam görünür. Kapsama kanıtı (v0.2) bunu
160
+ *beyan edilmiş şema* karşısında kısmen tespit edebilir, tamamen çözemez.
161
+ 3. **Oluşturma anı doğruluğu kanıtlanamıyor** (bkz. §3). Donanım tasdiki olmadan çözümü yok.
162
+ 4. **In-file `sig` stripping + HMAC/`anchor` azaltımı.** İçerik `hash`'i `{hash, sig, anchor}`
163
+ (ve audit `signature`/`sig`) hariç hesaplanır; dosyayı kontrol eden operatör bu alanları
164
+ düşürüp/inceltebilir ve içerik hash'i bozulmaz. Bitişiklik + trust store boot'ta bir kısmını
165
+ yakalar, ama in-file strip/reduce oyunlarına karşı tam koruma **in-file çözülemez** —
166
+ dış çıpa (şeffaflık kütüğü) ve/veya band-dışı anahtar töreni gerekir.
167
+ 5. **`argsHash` ile hata ayıklama zorlaşıyor.** Ham sorguyu tutmuyoruz; destek vakalarında
168
+ müşterinin kendi tarafındaki logla eşleştirmek gerekecek. Kabul edilen ödün.
169
+
170
+ ## 8. Geçiş (mevcut zincirler bozulmayacak)
171
+
172
+ `src/audit.ts` bugün `signature` alanına HMAC yazıyor. Plan:
173
+ - `signature` alanı **korunur** (geriye dönük uyumluluk, mevcut `audit-chain-check.mjs` çalışmaya devam eder)
174
+ - yeni `sig` alanı Ed25519 ile eklenir
175
+ - `CONARIUM_AUDIT_HMAC_KEY` yoksa ve Ed25519 anahtarı varsa yalnızca `sig` üretilir
176
+ - ikisi de yoksa: **fail-closed** — imzasız makbuz üretmeyi reddet (bugünkü davranış imzayı
177
+ sessizce atlıyor, bu düzeltilecek)
178
+ - anahtar üretimi: `conarium keygen` → özel anahtar diskte 0600, açık anahtar + `keyId` yayımlanabilir
179
+ - anahtar rotasyonu: `keyId` her makbuzda taşınır, doğrulayıcı birden fazla açık anahtar kabul eder
180
+
181
+ ## 9. Test planı
182
+
183
+ | Senaryo | Beklenen |
184
+ |---|---|
185
+ | Ortadaki kaydın bir alanını değiştir | çıkış 10 |
186
+ | Ortadaki kaydı sil | çıkış 11 |
187
+ | İki kaydın yerini değiştir | çıkış 11 veya 12 |
188
+ | `seq` atlat (1041 → 1043) | çıkış 12 |
189
+ | Başka anahtarla imzala | çıkış 13 |
190
+ | Rotasyon: eski+yeni keyId karışık zincir | çıkış 0 (iki açık anahtar verilirse) |
191
+ | Boş zincir / tek kayıt | çıkış 0, uyarı basar |
192
+ | `anchor: null` + `--anchor-check` | çıkış 14, eksik olarak raporlanır |
193
+ | İmza anahtarı hiç yok | üretim reddedilir (fail-closed), test bunu doğrular |
194
+ | Ham PII sızıntı taraması: 121k'lık gerçek koşudan üretilen makbuzlarda ham değer ara | 0 eşleşme |
195
+
196
+ Son satır zorunlu regresyon: makbuzun kendisi bir sızıntı yüzeyi olamaz.
197
+
198
+ ## 10. Açık sorular (uygulamayı bloklamıyor)
199
+
200
+ - Çıpa hedefi Rekor mu, kendi Trillian örneğimiz mi? (Rekor ile başla, bağımlılık riski varsa taşı)
201
+ - Çıpalama sıklığı: her N makbuz mu, her T dakika mı? (öneri: ikisinin ilki, yapılandırılabilir)
202
+ - `consentRef` şeması ISO/IEC TS 27560'ın hangi alanlarını taşıyacak? (v0.2)
@@ -1,9 +1,9 @@
1
- {
2
- "_comment": "Add this block to your Claude Desktop config at ~/Library/Application Support/Claude/claude_desktop_config.json",
3
- "mcpServers": {
4
- "conarium": {
5
- "command": "npx",
6
- "args": ["-y", "--package=@conarium-ai/core", "conarium", "--config", "/path/to/your/conarium.config.json"]
7
- }
8
- }
9
- }
1
+ {
2
+ "_comment": "Add this block to your Claude Desktop config at ~/Library/Application Support/Claude/claude_desktop_config.json",
3
+ "mcpServers": {
4
+ "conarium": {
5
+ "command": "npx",
6
+ "args": ["-y", "--package=@conarium-ai/core", "conarium", "--config", "/path/to/your/conarium.config.json"]
7
+ }
8
+ }
9
+ }
@@ -1,10 +1,10 @@
1
- {
2
- "_comment": "Add this to your Cursor MCP settings (~/.cursor/mcp.json or project .cursorrules)",
3
- "mcpServers": {
4
- "conarium": {
5
- "command": "npx",
6
- "args": ["-y", "--package=@conarium-ai/core", "conarium", "--config", "/path/to/your/conarium.config.json"],
7
- "description": "Conarium — company-aware AI context"
8
- }
9
- }
10
- }
1
+ {
2
+ "_comment": "Add this to your Cursor MCP settings (~/.cursor/mcp.json or project .cursorrules)",
3
+ "mcpServers": {
4
+ "conarium": {
5
+ "command": "npx",
6
+ "args": ["-y", "--package=@conarium-ai/core", "conarium", "--config", "/path/to/your/conarium.config.json"],
7
+ "description": "Conarium — company-aware AI context"
8
+ }
9
+ }
10
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@conarium-ai/core",
3
- "version": "0.2.12",
3
+ "version": "0.2.13",
4
4
  "//files-artefakt": "examples/ altindaki uretilmis dosyalar (ozel anahtar, makbuz/denetim JSONL) ELENIR. .gitignore npm'i baglamaz: izin listesinde 'examples' oldugu icin demoyu kosturmus bir makinede 'npm publish' _keys/audit-ed25519.pem'i (OZEL ANAHTAR) ve makbuzlari yayinliyordu. test/pack_artefakt.mjs bunu kilitler. Elemeler examples/ ile SINIRLI: test-vectors/ altindaki receipts.jsonl ve .pub.pem YAYINLANMAK ZORUNDA, yoksa ucuncu taraf konformans vektorlerini kosturamaz.",
5
5
  "//files": "Pakete NE gireceginin izin listesi. Liste olmadan npm her seyi gonderiyordu: 296 dosya / 1.5 MB — CI workflowlari, gitleaks ayari, 137 KB pazarlama gorseli, sitenin api/chat.js dosyasi. Bir bankanin guvenlik ekibi tarball'i acip bunlari gorur. scripts/ BILEREK var: conarium-reconcile calisirken scripts/pg-snapshot.sql'e atif yapiyor, olmazsa kullanici destek maili yazar.",
6
6
  "files": [
@@ -54,6 +54,13 @@
54
54
  "codex"
55
55
  ],
56
56
  "homepage": "https://github.com/dogrucanemek-alt/conarium",
57
+ "repository": {
58
+ "type": "git",
59
+ "url": "git+https://github.com/dogrucanemek-alt/conarium.git"
60
+ },
61
+ "bugs": {
62
+ "url": "https://github.com/dogrucanemek-alt/conarium/issues"
63
+ },
57
64
  "license": "MIT",
58
65
  "type": "module",
59
66
  "main": "./dist/index.js",