@conarium-ai/core 0.2.12 → 0.2.14

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 (107) hide show
  1. package/CHANGELOG.md +170 -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 +126 -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-shortcut.d.ts.map +1 -1
  30. package/dist/console-shortcut.js +5 -1
  31. package/dist/console-shortcut.js.map +1 -1
  32. package/dist/console.d.ts.map +1 -1
  33. package/dist/console.js +15 -4
  34. package/dist/console.js.map +1 -1
  35. package/dist/coverage.d.ts +17 -1
  36. package/dist/coverage.d.ts.map +1 -1
  37. package/dist/coverage.js +30 -3
  38. package/dist/coverage.js.map +1 -1
  39. package/dist/digit_pii.d.ts.map +1 -1
  40. package/dist/digit_pii.js +64 -12
  41. package/dist/digit_pii.js.map +1 -1
  42. package/dist/governance.d.ts +2 -0
  43. package/dist/governance.d.ts.map +1 -1
  44. package/dist/governance.js +23 -8
  45. package/dist/governance.js.map +1 -1
  46. package/dist/http.d.ts +11 -1
  47. package/dist/http.d.ts.map +1 -1
  48. package/dist/http.js +87 -7
  49. package/dist/http.js.map +1 -1
  50. package/dist/iban.d.ts.map +1 -1
  51. package/dist/iban.js +6 -3
  52. package/dist/iban.js.map +1 -1
  53. package/dist/index.js +1 -0
  54. package/dist/index.js.map +1 -1
  55. package/dist/keys.d.ts +5 -0
  56. package/dist/keys.d.ts.map +1 -1
  57. package/dist/keys.js +22 -7
  58. package/dist/keys.js.map +1 -1
  59. package/dist/mask-text.d.ts +11 -0
  60. package/dist/mask-text.d.ts.map +1 -0
  61. package/dist/mask-text.js +42 -0
  62. package/dist/mask-text.js.map +1 -0
  63. package/dist/receipt-view.d.ts +13 -0
  64. package/dist/receipt-view.d.ts.map +1 -1
  65. package/dist/receipt-view.js +28 -5
  66. package/dist/receipt-view.js.map +1 -1
  67. package/dist/server.d.ts.map +1 -1
  68. package/dist/server.js +31 -15
  69. package/dist/server.js.map +1 -1
  70. package/dist/sql-gate/mssql.d.ts.map +1 -1
  71. package/dist/sql-gate/mssql.js +36 -2
  72. package/dist/sql-gate/mssql.js.map +1 -1
  73. package/dist/sql-gate/oracle.d.ts.map +1 -1
  74. package/dist/sql-gate/oracle.js +24 -3
  75. package/dist/sql-gate/oracle.js.map +1 -1
  76. package/dist/sql-gate/rules.d.ts +19 -1
  77. package/dist/sql-gate/rules.d.ts.map +1 -1
  78. package/dist/sql-gate/rules.js +116 -7
  79. package/dist/sql-gate/rules.js.map +1 -1
  80. package/dist/types.d.ts +6 -0
  81. package/dist/types.d.ts.map +1 -1
  82. package/docs/API-STABILITY.md +2 -2
  83. package/docs/ARCHITECTURE.md +42 -42
  84. package/docs/RECEIPT-SPEC.md +17 -11
  85. package/docs/plans/2026-07-02-redteam-harness.md +416 -416
  86. package/docs/specs/2026-07-02-redteam-harness-design.md +90 -90
  87. package/docs/superpowers/TODO-gate1-f4.md +23 -23
  88. package/docs/superpowers/plans/2026-07-29-conarium-receipt-plan.md +200 -200
  89. package/docs/superpowers/specs/2026-07-29-conarium-receipt-design.md +202 -202
  90. package/examples/claude-desktop-config.json +9 -9
  91. package/examples/cursor-mcp-settings.json +10 -10
  92. package/examples/proof-service/README.md +50 -0
  93. package/package.json +9 -2
  94. package/public/app.js +378 -378
  95. package/public/index.html +160 -160
  96. package/public/style.css +504 -504
  97. package/scripts/conarium_sabah_brief.mjs +107 -107
  98. package/scripts/start-mcp-c1.mjs +93 -93
  99. package/test-vectors/sql-gate/LAST-RUN.json +1 -2
  100. package/test-vectors/sql-gate/README.md +3 -1
  101. package/test-vectors/sql-gate/vectors.json +28 -0
  102. package/dist/openapi_connector.d.ts +0 -6
  103. package/dist/openapi_connector.d.ts.map +0 -1
  104. package/dist/openapi_connector.js +0 -145
  105. package/dist/openapi_connector.js.map +0 -1
  106. package/docs/audit/2026-08-14-security-scan.md +0 -48
  107. 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
+ }
@@ -0,0 +1,50 @@
1
+ # The `/proof` service, as a consumer of this package
2
+
3
+ `demo.conarium.dev/proof` renders a signed receipt as HTML. That service is
4
+ **not in this repository and does not belong here** — its sources live in the
5
+ private site repo (`nexus`: `src/proof.ts`, `src/load-receipt-view.ts`,
6
+ `deploy/hetzner-proof-route.mjs`, `start.mjs`). The box directory
7
+ `/opt/conarium-proof` is a deploy artifact of that repo, not a separate
8
+ codebase.
9
+
10
+ This note exists for the other direction: the service is a **consumer of this
11
+ package**, and two of the ways it consumes are things a release here can break.
12
+
13
+ ⛔ Do not copy the service's files into this tree. A second copy is the drift
14
+ this page is warning about.
15
+
16
+ ## What it takes from this package
17
+
18
+ | It needs | How it gets it |
19
+ |---|---|
20
+ | Receipt HTML (`src/receipt-view.ts`) | Resolved at runtime from `CONARIUM_ROOT`, never copied |
21
+ | `governance.js`, `audit-hash.js` | **Copied** into its own `dist/` on the box |
22
+
23
+ `load-receipt-view.js` refuses to keep a second HTML renderer and loads the
24
+ function from the install `CONARIUM_ROOT` points at. That is the pattern to
25
+ follow.
26
+
27
+ The other two are snapshots. A release here that changes masking or the audit
28
+ hasher does **not** reach `/proof` until someone recopies them, so the page can
29
+ describe behaviour the engine no longer has. Fixing that belongs in the site
30
+ repo, not this one.
31
+
32
+ ## What that means when releasing this package
33
+
34
+ `CONARIUM_ROOT` on the box points at the gateway install. After an upgrade the
35
+ proof process keeps the previously imported module in memory, so it renders the
36
+ old HTML until it is restarted. A release is not visible on `/proof` until the
37
+ process restarts — `pm2 status` saying `online` does not mean it re-read
38
+ anything. Probe the page.
39
+
40
+ ## Could the copies become an import?
41
+
42
+ **Possible, not free.** `@conarium-ai/core` ships `dist/` in the tarball, so a
43
+ deep import (`@conarium-ai/core/dist/governance.js`) compiles today. But the
44
+ package `main` is the MCP stdio entry, not a library API, and there is no
45
+ documented subpath export for `Governance` or `computeEntryHash`. Pinning a
46
+ deep `dist/` path breaks the first time the tarball layout changes.
47
+
48
+ Resolving both from `CONARIUM_ROOT`, the way the receipt view already is, keeps
49
+ `/proof` and the gateway on one copy without inventing an API surface. Adding a
50
+ real `exports` map here is a separate, documented change.
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.14",
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",
@@ -97,7 +104,7 @@
97
104
  "supertest": "^7.2.2",
98
105
  "tsx": "^4.16.0",
99
106
  "typescript": "^5.5.0",
100
- "vitest": "^2.0.0"
107
+ "vitest": "^4.1.10"
101
108
  },
102
109
  "engines": {
103
110
  "node": ">=18"