@conarium-ai/core 0.2.42 → 0.2.44
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 +91 -0
- package/bin/conarium-coverage.mjs +5 -5
- package/bin/conarium-reconcile.mjs +10 -10
- package/bin/conarium-stamp.mjs +5 -5
- package/bin/conarium-verify.mjs +2 -2
- package/conformance/README.md +2 -1
- package/docs/RECEIPT-SPEC.md +15 -6
- package/docs/claims/locale-residue.json +7 -0
- package/docs/claims/reviews/0.2.43.md +75 -0
- package/docs/claims/reviews/0.2.44.md +84 -0
- package/package.json +9 -1
- package/scripts/gen-test-vectors.mjs +3 -2
- package/test-vectors/manifest.json +3 -2
- package/docs/audit/2026-08-14-e2e-health.md +0 -69
- package/docs/plans/2026-07-02-redteam-harness.md +0 -416
- package/docs/specs/2026-07-02-redteam-harness-design.md +0 -90
- package/docs/specs/2026-08-14-mssql-bypass-inventory.md +0 -37
- package/docs/specs/2026-08-14-oracle-bypass-inventory.md +0 -28
- package/docs/specs/2026-08-14-oracle-mssql-dialect-design.md +0 -232
- package/docs/superpowers/TODO-gate1-f4.md +0 -23
- package/docs/superpowers/plans/2026-07-29-conarium-receipt-plan.md +0 -200
- package/docs/superpowers/plans/2026-07-29-katman0-kapanis-plan.md +0 -231
- package/docs/superpowers/plans/2026-07-31-per-user-identity.md +0 -667
- package/docs/superpowers/specs/2026-07-29-conarium-receipt-design.md +0 -202
- package/docs/superpowers/specs/2026-07-31-per-user-identity-design.md +0 -144
- package/docs/superpowers/specs/2026-08-01-coverage-proof-design.md +0 -139
- package/docs/superpowers/specs/2026-08-05-receipt-meta-provenance-design.md +0 -116
|
@@ -1,231 +0,0 @@
|
|
|
1
|
-
# Katman 0 Kapanışı — Çıpalama + `/proof/live` (Cursor için)
|
|
2
|
-
|
|
3
|
-
**Bağlam:** `docs/superpowers/specs/2026-07-29-conarium-receipt-design.md` §6 (çıpalama) — önce oku.
|
|
4
|
-
**Uygulayan:** Cursor · **Gate:** Claude · **İki repo:** `conarium-public` (A) ve `nexus` (B)
|
|
5
|
-
**Dallar:** A → `feat/anchor-ots` · B → `feat/proof-live`
|
|
6
|
-
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
## ⛔ Sınırlar (ihlal = gate reddi)
|
|
10
|
-
|
|
11
|
-
1. **`git push` YOK.** Commit serbest, push patronun.
|
|
12
|
-
2. **`src/governance.ts`'e DOKUNMA.** Bu iş çıpalama + kanıt ucu.
|
|
13
|
-
3. **`as any` / tip atlatma YOK.** Testte gerçek assert.
|
|
14
|
-
4. **Makbuza/çıpaya ham veri YAZMA.** Çıpaya giden tek şey **hash**'tir: veri değil, alan adı
|
|
15
|
-
değil, tablo adı değil, IP değil.
|
|
16
|
-
5. 🔴 **`nexus` reposunda yeni kök/api dosyası eklersen `.vercelignore`'a `!<dosya>` satırı
|
|
17
|
-
EKLE.** Allowlist repo; unutursan commit yeşil görünür ve dosya canlıda 404 döner
|
|
18
|
-
(29 Tem'de tam bunu yedik).
|
|
19
|
-
6. Belirsizse **uydurma, sor.**
|
|
20
|
-
|
|
21
|
-
---
|
|
22
|
-
|
|
23
|
-
# BÖLÜM A — Çıpalama (`conarium-public`)
|
|
24
|
-
|
|
25
|
-
## A0 — Karar: OpenTimestamps, Rekor DEĞİL
|
|
26
|
-
|
|
27
|
-
Araştırıldı, gerekçe kayda geçsin ki sonra tekrar tartışılmasın:
|
|
28
|
-
|
|
29
|
-
| Aday | Karar |
|
|
30
|
-
|---|---|
|
|
31
|
-
| **Sigstore Rekor** | ⛔ RED. `hashedrekord` **plain Ed25519'u desteklemiyor** (Ed25519 digest'i kendi içinde hesaplar, orijinal artefakt gerekir); `ed25519ph` sonradan eklendi, bizim imzamız o değil. Alternatif `rekord` tipi **içeriğin kendisini** yüklemek istiyor = yapmayacağımız şey. Ayrıca public instance yazılım tedarik zinciri için. |
|
|
32
|
-
| **OpenTimestamps** | ✅ **SEÇİLDİ.** Hash damgalamak için yapılmış. Bedava, kayıt yok, API anahtarı yok, kullanım sınırı yok. İmza şemasından bağımsız. Doğrulaması **hiçbir üçüncü tarafa güven gerektirmiyor** (Bitcoin). Yerleşik standart → "standart olma" hikâyemizle uyumlu: kendi çıpamızı uydurmuyoruz, var olan standarda bağlanıyoruz. |
|
|
33
|
-
| RFC3161 TSA | ⏸ ERTELENDİ. Kurumsal alıcı (banka/sigorta) buna daha alışkın ve anında doğrulanıyor, ama TSA'ya güven gerektiriyor. `AnchorSink` pluggable kalsın, ikinci uygulama olarak sonra. Dokümana yaz. |
|
|
34
|
-
|
|
35
|
-
**Dürüst bedeli (dokümante edilecek):** OTS proof'u ilk anda **`pending`**'dir (yalnız takvim
|
|
36
|
-
sunucusu tasdiki); Bitcoin bloğuna girmesi **saatler** sürer ve ondan sonra `bitcoin` olur.
|
|
37
|
-
Yani "geriye dönük tarihlenmedi" iddiası anında değil, gecikmeli kesinleşir. Bunu saklamıyoruz.
|
|
38
|
-
|
|
39
|
-
## A1 — `OpenTimestampsSink`
|
|
40
|
-
**Dosya:** `src/anchor.ts` (mevcut `AnchorSink` arayüzünü kullan, arayüzü bozma)
|
|
41
|
-
|
|
42
|
-
Bağımlılık: `javascript-opentimestamps` (Node'da çalışıyor). API:
|
|
43
|
-
|
|
44
|
-
```js
|
|
45
|
-
const detached = OpenTimestamps.DetachedTimestampFile.fromHash(new OpenTimestamps.Ops.OpSHA256(), hashBuffer)
|
|
46
|
-
await OpenTimestamps.stamp(detached) // varsayılan takvimlere gönderir
|
|
47
|
-
const otsBytes = detached.serializeToBytes() // .ots proof
|
|
48
|
-
const changed = await OpenTimestamps.upgrade(detached) // pending -> bitcoin
|
|
49
|
-
await OpenTimestamps.verify(detachedOts, detached, opts)
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
Varsayılan takvimler: `alice.btc.calendar.opentimestamps.org`, `bob.btc...`,
|
|
53
|
-
`finney.calendar.eternitywall.com`.
|
|
54
|
-
|
|
55
|
-
⚠️ Bizim `chain.hash` string'i `sha256:<hex>` önekli. OTS'e giden **ham 32 byte**'tır —
|
|
56
|
-
öneki soy, hex'i Buffer'a çevir. Bu bir tuzak; testi A5'te.
|
|
57
|
-
|
|
58
|
-
## A2 — Çıpa deposu (makbuzun içine gömme)
|
|
59
|
-
**Dosya:** `src/anchor.ts`
|
|
60
|
-
|
|
61
|
-
`.ots` proof'u makbuzun içine yazmıyoruz — çıpa **zincir başı** başına bir kez üretilir ve
|
|
62
|
-
sidecar dosyada durur: `<sink>.anchors.jsonl`, satır başına bir kayıt:
|
|
63
|
-
|
|
64
|
-
```jsonc
|
|
65
|
-
{ "seq": 1042, "hash": "sha256:…", "log": "opentimestamps",
|
|
66
|
-
"ots": "<base64>", "state": "pending", "submittedAt": "…",
|
|
67
|
-
"upgradedAt": null, "bitcoinBlock": null }
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
Makbuzun `anchor` alanı yalnızca **referans** tutar: `{ "log": "opentimestamps", "ref": "sha256:…", "state": "pending" }`.
|
|
71
|
-
|
|
72
|
-
Bu neden çalışıyor: `anchor` içerik hash'inin **dışında** (bkz. `audit-hash.ts` ve
|
|
73
|
-
`receiptHash`), o yüzden imzadan sonra eklenebilir. Saldırgan `anchor`'ı silerse
|
|
74
|
-
`--anchor-check` **eksik** olarak raporlar (çıkış 14); forge edemez, çünkü OTS proof'u
|
|
75
|
-
hash'e kriptografik olarak bağlı.
|
|
76
|
-
|
|
77
|
-
## A3 — Zamanlama ve bloklamama
|
|
78
|
-
- `CONARIUM_ANCHOR_EVERY_N` (varsayılan **100**) veya `CONARIUM_ANCHOR_EVERY_MS`
|
|
79
|
-
(varsayılan **3600000**) — **hangisi önce dolarsa**.
|
|
80
|
-
- `CONARIUM_ANCHOR_SINK=opentimestamps|none` (varsayılan `none` — çıpalama **opt-in**;
|
|
81
|
-
ağ çağrısını kimse istemeden yapmıyoruz).
|
|
82
|
-
- **Asenkron ve BLOKLAMAZ:** çıpa başarısız olursa makbuz üretimi devam eder, `anchor: null` kalır.
|
|
83
|
-
- **Sessiz değil:** ardışık 3 başarısızlıkta `console.error`. Sayaç tut.
|
|
84
|
-
- Zaman aşımı 30sn, tek deneme (kuyruk yok — bir sonraki tetikte yeniden denenir).
|
|
85
|
-
|
|
86
|
-
## A4 — Upgrade işi (pending → bitcoin)
|
|
87
|
-
**Dosya:** `bin/conarium-anchor-upgrade.mjs` (yeni, tek dosya)
|
|
88
|
-
|
|
89
|
-
```
|
|
90
|
-
conarium-anchor-upgrade <anchors.jsonl>
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
`state: "pending"` satırları için `OpenTimestamps.upgrade()` dener; başarılıysa `ots`'u
|
|
94
|
-
tazeler, `state: "bitcoin"`, `bitcoinBlock` ve `upgradedAt` yazar. Değişiklik yoksa dosyayı
|
|
95
|
-
**dokunmadan** bırakır. Cron'a uygun (günde 1-2 kez yeter).
|
|
96
|
-
|
|
97
|
-
## A5 — Doğrulayıcıya `--anchor-check`
|
|
98
|
-
**Dosya:** `bin/conarium-verify.mjs`
|
|
99
|
-
|
|
100
|
-
`--anchor-check` verildiğinde:
|
|
101
|
-
- `anchor` yoksa → **çıkış 14**, "anchor missing" (mevcut davranış korunur)
|
|
102
|
-
- `anchor.ref` ile sidecar'daki kaydı bul; yoksa → çıkış 14
|
|
103
|
-
- OTS proof'unu `OpenTimestamps.verify` ile **zincir başı hash'ine karşı** doğrula
|
|
104
|
-
- `state: "pending"` ise → **çıkış 0 ama stderr'e uyarı**: "anchor pending (calendar only,
|
|
105
|
-
not yet Bitcoin-attested)". Pending'i başarısızlık saymıyoruz ama sessiz de geçmiyoruz.
|
|
106
|
-
- Proof hash'e uymuyorsa → çıkış 14
|
|
107
|
-
|
|
108
|
-
⚠️ Doğrulayıcı `src/`'tan import ETMEMEYE devam etmeli (bağımsızlığı ürünün kozu).
|
|
109
|
-
OTS kütüphanesini import etmesi sorun değil — o dış bir standart, bizim kodumuz değil.
|
|
110
|
-
|
|
111
|
-
## A6 — Testler
|
|
112
|
-
**Dosya:** `src/anchor.test.ts` (mevcut) + `test/anchor-verify.test.mjs` (yeni)
|
|
113
|
-
|
|
114
|
-
| # | Senaryo | Beklenen |
|
|
115
|
-
|---|---|---|
|
|
116
|
-
| A6.1 | `sha256:` önekli hash → OTS'e giden buffer **32 byte ve doğru** | eşit |
|
|
117
|
-
| A6.2 | Sahte `AnchorSink` fırlatıyor → makbuz üretimi devam ediyor, `anchor: null` | üretim OK |
|
|
118
|
-
| A6.3 | 3 ardışık başarısızlık → `console.error` çağrıldı | çağrıldı |
|
|
119
|
-
| A6.4 | `EVERY_N=2` → 2 makbuzda bir çıpa tetikleniyor | 2 çağrı / 4 makbuz |
|
|
120
|
-
| A6.5 | `anchor` silinmiş + `--anchor-check` | çıkış 14 |
|
|
121
|
-
| A6.6 | `state: pending` + `--anchor-check` | çıkış 0 + stderr uyarısı |
|
|
122
|
-
| A6.7 | Sidecar'daki `ots` başka bir hash'e ait | çıkış 14 |
|
|
123
|
-
| A6.8 | `CONARIUM_ANCHOR_SINK=none` → hiç ağ çağrısı yok | 0 çağrı |
|
|
124
|
-
|
|
125
|
-
⚠️ **Gerçek takvim sunucusuna testte gitme** (dış servise bağlı test kırılgan). Sahte sink ile
|
|
126
|
-
test et. Gerçek OTS entegrasyonu **elle bir kez** doğrulanır ve sonucu (submitted hash +
|
|
127
|
-
dönen `.ots` boyutu + sonradan upgrade edilen blok numarası) `docs/RECEIPT-SPEC.md`'ye yazılır.
|
|
128
|
-
|
|
129
|
-
## A7 — Doküman
|
|
130
|
-
- `docs/RECEIPT-SPEC.md`: §Anchoring bölümü — OTS seçimi + **pending/bitcoin iki durumu** +
|
|
131
|
-
Rekor'un neden reddedildiği + RFC3161'in ertelendiği. Known gap #4'e "anchor artık mevcut
|
|
132
|
-
ama pending durumu gecikmeli" notu.
|
|
133
|
-
- `README.md`: `--anchor-check` kullanımı. **İddia metnini GENİŞLETME.**
|
|
134
|
-
- `CHANGELOG`.
|
|
135
|
-
|
|
136
|
-
---
|
|
137
|
-
|
|
138
|
-
# BÖLÜM B — `/proof/live` (`nexus` reposu)
|
|
139
|
-
|
|
140
|
-
Amaç: bir LLM'in **çekip alıntılayabildiği** canlı kanıt. Kategoride tek doğrulanabilir iddia
|
|
141
|
-
biz olacağız — herkes "PII'yi maskeliyoruz" diyor, kimse kontrol edilebilir bir yere koymuyor.
|
|
142
|
-
|
|
143
|
-
## B1 — Hetzner demo sunucusuna `/proof` route
|
|
144
|
-
**Dosya:** Hetzner `conarium-demo` servisi (port 8793)
|
|
145
|
-
|
|
146
|
-
⚠️ **Bu prod sunucu değişikliği. Kodu yaz, DEPLOY ETME** — Claude gate'ler, patron onaylar.
|
|
147
|
-
|
|
148
|
-
`GET /proof` → JSON. Gerçek motordan **üç işlem** koşar (sentetik demo şeması, gerçek veri YOK):
|
|
149
|
-
1. izinli sorgu → cevap döner
|
|
150
|
-
2. maskelenen sorgu → `[MASKED_PII]` döner
|
|
151
|
-
3. kapalı tablo → politika ile reddedilir
|
|
152
|
-
|
|
153
|
-
Dönen gövde:
|
|
154
|
-
|
|
155
|
-
```jsonc
|
|
156
|
-
{
|
|
157
|
-
"generatedAt": "2026-07-29T09:14:02.113Z",
|
|
158
|
-
"engine": { "name": "conarium", "version": "0.1.0" },
|
|
159
|
-
"operations": [
|
|
160
|
-
{ "request": "revenue by month", "policy": "allow", "rowsReturned": 12, "maskedCount": 0 },
|
|
161
|
-
{ "request": "customer list", "policy": "partial","rowsReturned": 5, "maskedCount": 15,
|
|
162
|
-
"sample": "[MASKED_PII]" },
|
|
163
|
-
{ "request": "closed table", "policy": "deny", "reason": "not permitted by policy" }
|
|
164
|
-
],
|
|
165
|
-
"chain": { "seq": 1042, "head": "sha256:…", "entries": 1042 },
|
|
166
|
-
"signature": { "alg": "Ed25519", "keyId": "cnr-demo", "value": "base64…" },
|
|
167
|
-
"publicKey": "-----BEGIN PUBLIC KEY-----…",
|
|
168
|
-
"anchor": { "log": "opentimestamps", "state": "pending", "ref": "sha256:…" },
|
|
169
|
-
"verify": "npx conarium-verify <chain.jsonl> --pubkey <key.pem> --anchor-check",
|
|
170
|
-
"claim": "These records have not been altered, deleted, reordered or backdated after creation. This does NOT prove they were correct at creation time.",
|
|
171
|
-
"limitations": [
|
|
172
|
-
"Synthetic demo data, not real customer data.",
|
|
173
|
-
"actor is a service identity, not a natural person.",
|
|
174
|
-
"Anchor may be 'pending' — Bitcoin attestation takes hours."
|
|
175
|
-
]
|
|
176
|
-
}
|
|
177
|
-
```
|
|
178
|
-
|
|
179
|
-
`claim` ve `limitations` alanları **bilinçli**: bir LLM bu ucu okuyup alıntı yaptığında
|
|
180
|
-
sınırları da beraber alsın. Kendi kısıtlarımızı makine-okunur yapmak, atıfın doğru olmasını
|
|
181
|
-
sağlar.
|
|
182
|
-
|
|
183
|
-
- Rate limit: mevcut desene uy (demo ucu 40/dk). Ek olarak **60sn cache** — her istekte
|
|
184
|
-
motoru koşturmayalım.
|
|
185
|
-
- Ham veri, tablo adı, iç sistem adı **yok**. (17 Tem'de demoda "ZION mirror (Codes sync)"
|
|
186
|
-
sızıntısı yaşandı; regresyon testi var, bozmayın.)
|
|
187
|
-
|
|
188
|
-
## B2 — Vercel fonksiyonu + yönlendirme
|
|
189
|
-
**Dosyalar:** `api/proof.js` (yeni) · `vercel.json` (rewrite) · **`.vercelignore` (!satırları)**
|
|
190
|
-
|
|
191
|
-
- `api/proof.js`: `api/chat.js` desenini birebir takip et (origin allowlist, rate limit,
|
|
192
|
-
upstream key, 30sn timeout, **502'yi 200'e yamamak YOK**).
|
|
193
|
-
- `vercel.json`: `"rewrites": [{ "source": "/proof/live", "destination": "/api/proof" }]`
|
|
194
|
-
- 🔴 `.vercelignore`: `!api/proof.js` **ekle**. Unutursan canlıda 404.
|
|
195
|
-
- `Cache-Control: public, max-age=60` — LLM'ler ve tarayıcılar için makul.
|
|
196
|
-
|
|
197
|
-
## B3 — `llms.txt`'e ekle
|
|
198
|
-
`llms.txt` içindeki Links bölümüne: canlı kanıt ucu + tek satır açıklama. Bu, ucun bulunmasının
|
|
199
|
-
asıl yolu.
|
|
200
|
-
|
|
201
|
-
## B4 — Testler
|
|
202
|
-
| # | Senaryo | Beklenen |
|
|
203
|
-
|---|---|---|
|
|
204
|
-
| B4.1 | `/proof/live` 200 + şema geçerli | geçer |
|
|
205
|
-
| B4.2 | Gövdede ham PII / tablo adı / iç sistem adı araması | 0 eşleşme |
|
|
206
|
-
| B4.3 | Upstream ölü → **502**, 200 değil | 502 |
|
|
207
|
-
| B4.4 | `claim` ve `limitations` alanları dolu | dolu |
|
|
208
|
-
| B4.5 | İkinci istek cache'ten (60sn içinde `generatedAt` aynı) | aynı |
|
|
209
|
-
|
|
210
|
-
---
|
|
211
|
-
|
|
212
|
-
## Sıra ve gate noktaları
|
|
213
|
-
|
|
214
|
-
```
|
|
215
|
-
A1─A2─A3─A4─A5─A6 ══GATE A══▶ A7 ┐
|
|
216
|
-
(Claude) ├══GATE B══▶ push (patron onayı) ─▶ Hetzner deploy (patron)
|
|
217
|
-
B1─B2─B3─B4 ══════════════════┘ (Claude)
|
|
218
|
-
```
|
|
219
|
-
|
|
220
|
-
**GATE A:** hash öneki doğru soyulmuş mu (A6.1) · çıpa başarısızlığı gerçekten bloklamıyor mu ·
|
|
221
|
-
pending sessizce 0 dönmüyor mu · doğrulayıcı `src/`'tan import etmemeye devam ediyor mu ·
|
|
222
|
-
testler gerçek takvim sunucusuna gitmiyor mu.
|
|
223
|
-
|
|
224
|
-
**GATE B:** `/proof` gövdesinde ham veri/iç isim var mı · 502 yamanmış mı · `.vercelignore`'a
|
|
225
|
-
`!api/proof.js` eklenmiş mi · `claim` metni genişletilmiş mi.
|
|
226
|
-
|
|
227
|
-
---
|
|
228
|
-
|
|
229
|
-
## Kapsam dışı (bilinçli)
|
|
230
|
-
RFC3161 sink · kişi bazlı kimlik · rıza bağlama · kapsama/olumsuz kanıt · maruziyet skoru ·
|
|
231
|
-
MCP tehdit tespiti · `/proof` için insan-okunur HTML sayfa (JSON yeter, sonra).
|