@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.
- package/CHANGELOG.md +170 -1
- package/LICENSE +21 -21
- package/LIMITATIONS.md +23 -2
- package/LIMITATIONS.tr.md +13 -2
- package/bin/conarium-coverage.mjs +89 -6
- package/bin/conarium-doctor.mjs +44 -0
- package/bin/conarium-verify.mjs +110 -51
- package/dist/anchor.d.ts +11 -0
- package/dist/anchor.d.ts.map +1 -1
- package/dist/anchor.js +27 -0
- package/dist/anchor.js.map +1 -1
- package/dist/audit.d.ts +4 -0
- package/dist/audit.d.ts.map +1 -1
- package/dist/audit.js +126 -30
- package/dist/audit.js.map +1 -1
- package/dist/config.d.ts +14 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +35 -0
- package/dist/config.js.map +1 -1
- package/dist/connectors/openapi.d.ts +14 -1
- package/dist/connectors/openapi.d.ts.map +1 -1
- package/dist/connectors/openapi.js +78 -5
- package/dist/connectors/openapi.js.map +1 -1
- package/dist/connectors/postgres.js +8 -8
- package/dist/console-receipts.d.ts +12 -1
- package/dist/console-receipts.d.ts.map +1 -1
- package/dist/console-receipts.js +14 -2
- package/dist/console-receipts.js.map +1 -1
- package/dist/console-shortcut.d.ts.map +1 -1
- package/dist/console-shortcut.js +5 -1
- package/dist/console-shortcut.js.map +1 -1
- package/dist/console.d.ts.map +1 -1
- package/dist/console.js +15 -4
- package/dist/console.js.map +1 -1
- package/dist/coverage.d.ts +17 -1
- package/dist/coverage.d.ts.map +1 -1
- package/dist/coverage.js +30 -3
- package/dist/coverage.js.map +1 -1
- package/dist/digit_pii.d.ts.map +1 -1
- package/dist/digit_pii.js +64 -12
- package/dist/digit_pii.js.map +1 -1
- package/dist/governance.d.ts +2 -0
- package/dist/governance.d.ts.map +1 -1
- package/dist/governance.js +23 -8
- package/dist/governance.js.map +1 -1
- package/dist/http.d.ts +11 -1
- package/dist/http.d.ts.map +1 -1
- package/dist/http.js +87 -7
- package/dist/http.js.map +1 -1
- package/dist/iban.d.ts.map +1 -1
- package/dist/iban.js +6 -3
- package/dist/iban.js.map +1 -1
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/dist/keys.d.ts +5 -0
- package/dist/keys.d.ts.map +1 -1
- package/dist/keys.js +22 -7
- package/dist/keys.js.map +1 -1
- package/dist/mask-text.d.ts +11 -0
- package/dist/mask-text.d.ts.map +1 -0
- package/dist/mask-text.js +42 -0
- package/dist/mask-text.js.map +1 -0
- package/dist/receipt-view.d.ts +13 -0
- package/dist/receipt-view.d.ts.map +1 -1
- package/dist/receipt-view.js +28 -5
- package/dist/receipt-view.js.map +1 -1
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +31 -15
- package/dist/server.js.map +1 -1
- package/dist/sql-gate/mssql.d.ts.map +1 -1
- package/dist/sql-gate/mssql.js +36 -2
- package/dist/sql-gate/mssql.js.map +1 -1
- package/dist/sql-gate/oracle.d.ts.map +1 -1
- package/dist/sql-gate/oracle.js +24 -3
- package/dist/sql-gate/oracle.js.map +1 -1
- package/dist/sql-gate/rules.d.ts +19 -1
- package/dist/sql-gate/rules.d.ts.map +1 -1
- package/dist/sql-gate/rules.js +116 -7
- package/dist/sql-gate/rules.js.map +1 -1
- package/dist/types.d.ts +6 -0
- package/dist/types.d.ts.map +1 -1
- package/docs/API-STABILITY.md +2 -2
- package/docs/ARCHITECTURE.md +42 -42
- package/docs/RECEIPT-SPEC.md +17 -11
- package/docs/plans/2026-07-02-redteam-harness.md +416 -416
- package/docs/specs/2026-07-02-redteam-harness-design.md +90 -90
- package/docs/superpowers/TODO-gate1-f4.md +23 -23
- package/docs/superpowers/plans/2026-07-29-conarium-receipt-plan.md +200 -200
- package/docs/superpowers/specs/2026-07-29-conarium-receipt-design.md +202 -202
- package/examples/claude-desktop-config.json +9 -9
- package/examples/cursor-mcp-settings.json +10 -10
- package/examples/proof-service/README.md +50 -0
- package/package.json +9 -2
- package/public/app.js +378 -378
- package/public/index.html +160 -160
- package/public/style.css +504 -504
- package/scripts/conarium_sabah_brief.mjs +107 -107
- package/scripts/start-mcp-c1.mjs +93 -93
- package/test-vectors/sql-gate/LAST-RUN.json +1 -2
- package/test-vectors/sql-gate/README.md +3 -1
- package/test-vectors/sql-gate/vectors.json +28 -0
- package/dist/openapi_connector.d.ts +0 -6
- package/dist/openapi_connector.d.ts.map +0 -1
- package/dist/openapi_connector.js +0 -145
- package/dist/openapi_connector.js.map +0 -1
- package/docs/audit/2026-08-14-security-scan.md +0 -48
- package/docs/audit/2026-08-14-surface-sync.md +0 -34
|
@@ -1,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.
|
|
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": "^
|
|
107
|
+
"vitest": "^4.1.10"
|
|
101
108
|
},
|
|
102
109
|
"engines": {
|
|
103
110
|
"node": ">=18"
|