@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,232 +0,0 @@
|
|
|
1
|
-
# Oracle / MS SQL Server — lehçe tasarımı
|
|
2
|
-
|
|
3
|
-
**Tarih:** 2026-08-14
|
|
4
|
-
**Durum:** tasarım (kod yok). Desteklenmiyor.
|
|
5
|
-
**Neden:** TEB Arf. Banka sorusu: *"Oracle veya MS SQL Server connector yol haritanızda var mı?"*
|
|
6
|
-
**Bu belgenin iddiası:** yol haritası *nasıl* kurulur. İddia etmediği: lehçe hazır, connector yazılabilir, tarih var.
|
|
7
|
-
|
|
8
|
-
Bugün güvenlik `pgsql-ast-parser` üstünde duruyor (`Governance.guardQuery` + `PostgresConnector.assertReadOnlySql`). Deny listesi, PII soyağacı, satır tavanı, salt-okunur zorlaması, fail-closed parse — hepsi Postgres AST’sine bağlı. Yeni bir lehçe eklemek “konnektör yazmak” değil; ayrıştırıcı katmanını ikinci kez kurmak. Yanlış yapılırsa güvenlik sessizce delinir.
|
|
9
|
-
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## 1. Ayrıştırıcı stratejisi
|
|
13
|
-
|
|
14
|
-
Üç seçenek. Kör “hepsini IR’ye taşıyalım” yok.
|
|
15
|
-
|
|
16
|
-
### A — Lehçe başına ayrı ayrıştırıcı + ayrı guard
|
|
17
|
-
|
|
18
|
-
Her lehçe kendi parser’ı, kendi `guardQuery` / `analyzeRead` / `applyRowCap` kopyası.
|
|
19
|
-
|
|
20
|
-
| | |
|
|
21
|
-
|--|--|
|
|
22
|
-
| maliyet | İlk lehçe: parser seçimi + deny/fonksiyon/satır-tavanı + vektör seti. İkinci lehçe neredeyse aynı eforu tekrarlar. |
|
|
23
|
-
| risk | İki kaynak. Postgres’te kapanan bir delik (UNION satır tavanı, tırnaklı tanımlayıcı) diğerinde açık kalır. |
|
|
24
|
-
| bugünkü kod | Dokunulmaz. Postgres yolu olduğu gibi kalır. |
|
|
25
|
-
|
|
26
|
-
Banka “MSSQL de var mı?” diye sorunca ikinci kopya zaten kaçınılmaz görünür. Asıl maliyet kopya değil, **iki deny listesinin bayatlaması**.
|
|
27
|
-
|
|
28
|
-
### B — Ortak ara temsil (IR), lehçe parser’ları IR üretir
|
|
29
|
-
|
|
30
|
-
```
|
|
31
|
-
SQL metni → lehçe parser → Conarium IR → tek guard / soyağacı / satır tavanı → lehçe yazıcı
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
IR’nin taşıması gerekenler (eksik IR = sessiz delik):
|
|
35
|
-
|
|
36
|
-
- tek ifade (çok ifade IR’ye hiç girmez — reddedilir)
|
|
37
|
-
- okuma kökü (SELECT / CTE / set-op)
|
|
38
|
-
- şema.nesne referansları (tırnak + büyük/küçük harf *korunarak*)
|
|
39
|
-
- çıktı sütunları ve alias
|
|
40
|
-
- çağrılan fonksiyonlar
|
|
41
|
-
- satır sınırı düğümü (LIMIT / FETCH / TOP / ROWNUM — semantik, sözdizimi değil)
|
|
42
|
-
- yazma / kilit / prosedür çağrısı düğümleri (varsa → deny; IR “yok saymaz”)
|
|
43
|
-
|
|
44
|
-
| | |
|
|
45
|
-
|--|--|
|
|
46
|
-
| maliyet | Postgres `analyzeRead` / `inspectFunction` / `applyRowCap` IR üstüne taşınır. İlk lehçe ucuzlaşmaz — *pahalılaşır* (IR + Postgres yeniden yazım + yeni parser). İkinci lehçe ucuzlar. |
|
|
47
|
-
| risk | IR kaybı. Parser’ın görüp IR’ye koymadığı bir `OPENROWSET` / `DBMS_XMLGEN` “yok” sayılır ve geçer. Fail-closed kuralı: IR’ye oturmayan her düğüm **deny**. “Bilmediğim = izin” yok. |
|
|
48
|
-
| bugünkü kod | Taşınabilir, ama bugünkü `Statement` tipi `pgsql-ast-parser`’a yapışık. IR’siz “biraz soyutla” yetmez. |
|
|
49
|
-
|
|
50
|
-
### C — Hibrit (önerilen)
|
|
51
|
-
|
|
52
|
-
1. **Postgres yolu olduğu gibi kalır.** Canlı 0.2.8 yüzeyi ve mevcut vektörler bozulmaz.
|
|
53
|
-
2. Yeni lehçe **kendi parser’ı** ile girer. Guard mantığı (allow/deny tablo, maske soyağacı, fonksiyon allow-list, satır tavanı, tek ifade, salt okuma) paylaşılan *kurallar* olarak çıkarılır; AST tipi paylaşılmaz.
|
|
54
|
-
3. IR, ikinci lehçe *gerçekten* istendiğinde kurulur — ilk lehçenin vektörleri yeşil olduktan sonra. İlk günde IR yok.
|
|
55
|
-
|
|
56
|
-
Neden C: bugünkü koruma Postgres’te ölçülmüş. Onu IR’ye taşımak, bankaya “Oracle var” demeden önce kendi ürünümüzü yeniden doğrulamak demek. Hibrit, o riski ilk lehçenin kapısına koymaz.
|
|
57
|
-
|
|
58
|
-
**Karar (tasarım):** C. A yasak değil ama deny listesi kopyalanmasın diye paylaşılan kural tabloları (yazma token’ları değil — lehçe sözlüğü) şart. B, ikinci lehçeden önce ödenmez.
|
|
59
|
-
|
|
60
|
-
---
|
|
61
|
-
|
|
62
|
-
## 2. Lehçe farkları envanteri
|
|
63
|
-
|
|
64
|
-
Her satır: fark → bugünkü korumanın o lehçede nasıl atlatılacağı. “Atlatılır” = parser Postgres varsayımıyla çalışırsa. Yeni lehçe kendi parser’ı olmadan bağlanırsa bu sütun gerçektir.
|
|
65
|
-
|
|
66
|
-
### 2.1 Tanımlayıcı tırnaklama ve büyük/küçük harf
|
|
67
|
-
|
|
68
|
-
| | Postgres (bugün) | Oracle | MS SQL |
|
|
69
|
-
|--|--|--|--|
|
|
70
|
-
| tırnak | `"Customers"` ≠ `customers` | `"Customers"` ≠ `CUSTOMERS` (unquoted → UPPER) | `[Customers]` / `"Customers"`; unquoted collation’a bağlı |
|
|
71
|
-
| bugünkü kod | tırnaklı mixed-case **deny** (`governance.ts` quoted-ident). Unquoted fold lowercase. | | |
|
|
72
|
-
|
|
73
|
-
**Atlatma.** Oracle unquoted `CUSTOMERS` = `CUSTOMERS`. Allow-list `public.customers` ile eşleşmez diye düşünülür; aslında Oracle’da `HR.CUSTOMERS` ile `hr.customers` aynı nesnedir. Fold yanlış yöndeyse allow-list’e *ait olmayan* tablo biner. Ters hata: meşru tablo deny. Fail-closed tercih: emin değilse deny.
|
|
74
|
-
|
|
75
|
-
MSSQL `[dbo].[Customers]` ile `dbo.customers` eşleşmesi collation + bracket. Postgres tırnak kuralını MSSQL’e taşımak `] ]` kaçışını görmez: `[secret]]]; DROP TABLE` benzeri bir parça, kaba token taramasında yazma sanılıp deny olabilir (güvenli taraf) *veya* parser yoksa string sanılıp geçer.
|
|
76
|
-
|
|
77
|
-
### 2.2 Şema / sahip
|
|
78
|
-
|
|
79
|
-
| | Postgres | Oracle | MS SQL |
|
|
80
|
-
|--|--|--|--|
|
|
81
|
-
| nitelik | `schema.table` (2 parça, zorunlu) | `user.table` — user **=** schema. `schema.package.proc` 3 parça. Synonym. | `server.db.schema.table` 4 parça. Synonym. |
|
|
82
|
-
| bugün | niteliksiz tablo deny. 2 parça beklenir. | | |
|
|
83
|
-
|
|
84
|
-
**Atlatma.** Oracle `CUSTOMERS` (niteliksiz) oturum kullanıcısının şemasına düşer. Bugünkü kural “niteliksiz = deny” Oracle’da da doğru kalmalı — aksi halde allow-list `HR.CUSTOMERS` iken `CUSTOMERS` geçer. Synonym: `PUBLIC.CUSTOMERS` → `HR.PII`. Parser synonym’i çözmezse soyağacı yanlış nesneye bakar; maske yanlış kolona uygulanır, asıl PII ham gider. İlk sürümde synonym **deny**.
|
|
85
|
-
|
|
86
|
-
MSSQL 4 parçalı ad: `linked.db.dbo.secrets`. Bugünkü 2-parça normalizasyon `dbo.secrets` görür, linked server’ı düşürür. Linked / 3–4 parça **deny**.
|
|
87
|
-
|
|
88
|
-
### 2.3 Satır sınırı
|
|
89
|
-
|
|
90
|
-
| | Postgres | Oracle | MS SQL |
|
|
91
|
-
|--|--|--|--|
|
|
92
|
-
| sözdizimi | `LIMIT n` (AST’ye yazılır; UNION dış sarmalayıcı) | `FETCH FIRST n ROWS ONLY` (12c+). Eski: `ROWNUM` *filtre*. | `TOP n`. `OFFSET / FETCH`. |
|
|
93
|
-
| bugün | `applyRowCap` yalnız `select`/`with`. Küme işlemi sarmalanır. | | |
|
|
94
|
-
|
|
95
|
-
**Atlatma — Oracle.** `ROWNUM` bir LIMIT düğümü değil, `WHERE` predicate. `WHERE ROWNUM < 10 OR 1=1` veya `WHERE ROWNUM > 0` tavanı yok eder. Dışarıdan `FETCH FIRST` sarmalamak doğru yaklaşım; içerideki `ROWNUM`’u “tavan uygulandı” sanmak yalan. `rowCapApplied: true` yalnız *bizim* eklediğimiz sarmalayıcı için.
|
|
96
|
-
|
|
97
|
-
**Atlatma — MSSQL.** `TOP 100 PERCENT` tavan değil. `SET ROWCOUNT 0` oturum durumu — tek ifade guard’ı bunu görmez; bağlantı *stateful* ise önceki batch tavanı sıfırlar. İlk sürüm: oturum ayarı yok, tek batch, `ROWCOUNT` / `SET` **deny**. `TOP` ile `FETCH` bir arada hangisinin bağlayıcı olduğu parser’a kalır; emin değilse deny.
|
|
98
|
-
|
|
99
|
-
### 2.4 Tehlikeli yerleşikler
|
|
100
|
-
|
|
101
|
-
Bugün: allow-list (`SAFE_BUILTIN_FUNCTIONS`) + dump yasağı (`array_agg`, `json_agg`, `string_agg`, …). Listede yoksa deny.
|
|
102
|
-
|
|
103
|
-
| lehçe | örnek | atlatma |
|
|
104
|
-
|--|--|--|
|
|
105
|
-
| Oracle | `XMLAGG`, `DBMS_XMLGEN`, `DBMS_LOB.SUBSTR`, `UTL_HTTP`, `CTX_DOC` | Dump / dışarı sızdırma. Postgres listesi bunları tanımaz; “bilinmeyen fonksiyon = deny” korunursa geçerli. Tanıdık *sanılan* isim (`replace`, `substr`) Oracle’da CLOB’un tamamını döndürebilir. |
|
|
106
|
-
| Oracle | `JSON_ARRAYAGG` | `json_agg` yasağının kardeşi. İsim farklıysa allow-list’ten kaçar — bu yüzden allow-list (deny-list değil) şart. |
|
|
107
|
-
| MSSQL | `FOR XML PATH`, `FOR JSON AUTO` | SELECT soneki; fonksiyon değil. `inspectFunction` görmez. Ayrı yasak. |
|
|
108
|
-
| MSSQL | `OPENROWSET`, `OPENDATASOURCE`, `OPENQUERY` | Linked / dosya okuma. Tablo gibi durur. |
|
|
109
|
-
| MSSQL | `STRING_AGG`, `XML PATH` birleşimi | Dump. |
|
|
110
|
-
| ikisi | `EXECUTE` / `EXEC` / `CALL` / `BEGIN DBMS_…` | Yazma token taraması `CALL`/`DO` yakalar (Postgres). Oracle `BEGIN … END;` anonymous block, MSSQL `EXEC` — kaba `\bCALL\b` bunları kaçırır. |
|
|
111
|
-
|
|
112
|
-
Kural: yeni lehçede de **allow-list**. Tanımadığın isim deny. `FOR XML` / `OPENROWSET` gibi fonksiyon-olmayan biçimler ayrı deny.
|
|
113
|
-
|
|
114
|
-
### 2.5 Çok ifade ve toplu iş
|
|
115
|
-
|
|
116
|
-
| | Postgres | Oracle | MS SQL |
|
|
117
|
-
|--|--|--|--|
|
|
118
|
-
| ayırıcı | `;` | `;` + `/` (SQL*Plus) | `;` + `GO` (batch, T-SQL değil) |
|
|
119
|
-
| blok | — | `BEGIN … END;` anonymous | `BEGIN … END`, `GO` |
|
|
120
|
-
|
|
121
|
-
Bugün: `parse()` birden fazla statement → deny. Parser’ın görmediği ayırıcı = tek statement sanılır.
|
|
122
|
-
|
|
123
|
-
**Atlatma — MSSQL.** `SELECT 1 GO DROP TABLE t` — `GO` satır başında, `;` yok. Postgres parser ya patlar (fail-closed, iyi) ya da `GO`’yu alias/ident sanır (kötü). Kural: `GO` / `BEGIN…END` / `/` **parse öncesi** reddedilir; “parser anlasın” denmez.
|
|
124
|
-
|
|
125
|
-
**Atlatma — Oracle.** `SELECT 1 FROM dual; BEGIN DELETE FROM t; END;` — ikinci blok. `;` ile bölünürse `ast.length > 1` yakalar *eğer* parser Oracle `;` + `BEGIN` tanırsa. Tanımazsa tek çöp statement veya parse error. Parse error = deny.
|
|
126
|
-
|
|
127
|
-
### 2.6 Yorum ve string kaçışları
|
|
128
|
-
|
|
129
|
-
| | Postgres | Oracle | MS SQL |
|
|
130
|
-
|--|--|--|--|
|
|
131
|
-
| yorum | `--` `/* */` | aynı + `REM` (SQL*Plus) | aynı + nested `/* /* */ */` (sürüme bağlı) |
|
|
132
|
-
| string | `'` , `E'…'` , `$$` | `'` , `q'[…]'` alternatif kaçış | `'` , `N'` , `'` kaçışı `''` |
|
|
133
|
-
| bracket | — | — | `[…]` tanımlayıcı |
|
|
134
|
-
|
|
135
|
-
Bugün kaba yazma taraması (`WRITE_TOKENS` büyük harf, sözcük sınırı) **yorum/string ayırmaz**. `'DELETE'` bir string içinde `DELETE` token’ı diye deny edebilir (aşırı maske, güvenli taraf). Tersi tehlikeli: `/*` ile kapatılmamış yorum + `*/ SELECT` — parser ve kaba tarama ayrılırsa biri yazar görür biri görmez.
|
|
136
|
-
|
|
137
|
-
**Atlatma.** Oracle `q'!DELETE!'` kaba taramada `DELETE` görür → deny (güvenli, yanlış pozitif). MSSQL `'/*' + '*/; DROP …'` birleşimi: parser yoksa token tarama birleşik string’i görmez. Bu yüzden kaba tarama *yeterli değil*; parser’ın string/yorum düğümü şart. Parser yoksa metin **geçmez**.
|
|
138
|
-
|
|
139
|
-
`$$` Postgres’e özgü. Oracle/MSSQL yoluna `$$` gelirse: o lehçenin parser’ı tanımazsa deny (parse fail).
|
|
140
|
-
|
|
141
|
-
---
|
|
142
|
-
|
|
143
|
-
## 3. Fail-closed ilkesi
|
|
144
|
-
|
|
145
|
-
Ayrıştırılamayan sorgu **reddedilir**, asla geçirilmez.
|
|
146
|
-
|
|
147
|
-
Bu cümle yeni lehçelerde de aynen geçerli. Pazarlık yok.
|
|
148
|
-
|
|
149
|
-
Somut:
|
|
150
|
-
|
|
151
|
-
1. Parser exception → `PolicyError` (“Failed to parse SQL”), connector’a gitmez.
|
|
152
|
-
2. Parse başarılı ama IR / analiz’e oturmayan düğüm → deny, “yok say” yok.
|
|
153
|
-
3. Lehçe belirsiz (Oracle mı MSSQL mı) → deny. Tahmin yok.
|
|
154
|
-
4. Niteliksiz / synonym / linked / 3–4 parça / `GO` / `SET` / `ROWNUM` tavanı iddiası — emin değilse deny.
|
|
155
|
-
5. Connector, guard’dan geçmemiş metni çalıştırmaz. Bugün `PostgresConnector.assertReadOnlySql` ikinci bir parse. Yeni connector da kendi lehçesinde aynı ikinci kapıyı tutar. Tek kapı = tek hata.
|
|
156
|
-
|
|
157
|
-
“Parser kütüphanesi SELECT sandı” yetmez. İkinci kapı (connector) aynı ağacı ister; iki parser ayrılırsa **deny** (fail-closed), “birisi kabul etti” değil.
|
|
158
|
-
|
|
159
|
-
---
|
|
160
|
-
|
|
161
|
-
## 4. Uygunluk vektörleri planı
|
|
162
|
-
|
|
163
|
-
`test-vectors/` makbuz doğrulayıcısı içindir. Lehçe vektörleri aynı ruhta olur: dondurulmuş girdi, beklenen karar, üçüncü tarafın bizi çalıştırmadan kontrol edebileceği manifest. Vektörler olmadan lehçe **desteklenmiş sayılmaz**.
|
|
164
|
-
|
|
165
|
-
Konum önerisi (kod yok; isim rezerv): `test-vectors/dialects/{oracle,mssql}/`.
|
|
166
|
-
|
|
167
|
-
Her vektör: `{ id, dialect, sql, expect: "deny"|"allow", reason, notes }`. `allow` olanlar için ayrıca `{ capApplied, accessedTables, maskedOutputs }`.
|
|
168
|
-
|
|
169
|
-
Zorunlu batarya — her lehçe, hepsi yazılmadan “destekleniyor” denmez:
|
|
170
|
-
|
|
171
|
-
| id sınıfı | neyi dener | beklenen |
|
|
172
|
-
|--|--|--|
|
|
173
|
-
| `parse-fail` | kırık SQL, kapanmamış string, `q'[` kapanmamış | deny |
|
|
174
|
-
| `multi-stmt` | `;` ikinci ifade | deny |
|
|
175
|
-
| `batch-go` | `GO` (MSSQL), `/` (Oracle) | deny |
|
|
176
|
-
| `write-smuggle` | `DELETE`/`UPDATE`/`INSERT`/`MERGE`/`EXEC`/`CALL`/`BEGIN` | deny |
|
|
177
|
-
| `comment-wrap` | `/* DELETE */` meşru SELECT; `'DELETE'` string | deny veya allow — hangisi olduğu *yazılı* ve sabit |
|
|
178
|
-
| `quote-ident` | tırnaklı / bracket’li mixed-case | deny (ilk sürüm) veya eşleşme kuralı belgelenmiş |
|
|
179
|
-
| `unqualified` | `SELECT * FROM CUSTOMERS` | deny |
|
|
180
|
-
| `synonym-or-dblink` | synonym, `OPENQUERY`, `schema.pkg.proc` | deny |
|
|
181
|
-
| `rowcap-union` | `A UNION ALL B` tavanın dışında kalmasın | allow + capApplied |
|
|
182
|
-
| `rowcap-rownum` | `WHERE ROWNUM < 10 OR 1=1` (Oracle) | deny veya dış sarmalayıcı kanıtı |
|
|
183
|
-
| `rowcap-top-percent` | `TOP 100 PERCENT` (MSSQL) | deny veya bizim FETCH sarmalayıcı |
|
|
184
|
-
| `dump-fn` | `XMLAGG` / `FOR XML` / `STRING_AGG` / `JSON_ARRAYAGG` | deny |
|
|
185
|
-
| `unknown-fn` | listede olmayan fonksiyon | deny |
|
|
186
|
-
| `session-state` | `SET ROWCOUNT`, `ALTER SESSION` | deny |
|
|
187
|
-
| `pii-lineage` | maskeli kolon alias / alt sorgu / CTE ile kaçış | allow + maskedOutputs dolu; ham kolon çıktıda yok |
|
|
188
|
-
|
|
189
|
-
Manifest olmadan, yeşil birim test “ben yazdım geçti”dir. Vektör, bankanın güvenlik ekibinin bizi çalıştırmadan koştuğu şeydir.
|
|
190
|
-
|
|
191
|
-
---
|
|
192
|
-
|
|
193
|
-
## 5. Aşamalandırma
|
|
194
|
-
|
|
195
|
-
Tarih yok. Sıra ve büyüklük var.
|
|
196
|
-
|
|
197
|
-
| sıra | ne | neden | efor (büyüklük) |
|
|
198
|
-
|--|--|--|--|
|
|
199
|
-
| 0 | bu belge + vektör iskeleti (boş case listesi bile) | “yol haritasında var”ın kanıtı tasarım + vektör planıdır, connector değil | S |
|
|
200
|
-
| 1 | **MS SQL Server** önce | Banka / kurumsal TR + EU’da SQL Server payı Oracle’dan sık. TDS + `tedious` / `mssql` olgun. `TOP`/`FETCH` satır tavanı `ROWNUM`’dan düz. 4-parça ad ve `GO` erken kesilir. | L (parser + guard kuralları + vektör bataryası + connector). IR yok. |
|
|
201
|
-
| 2 | MSSQL vektörleri yeşil, soyağacı Postgres ile aynı iddiaları taşıyor | İkinci lehçeye geçmeden “MSSQL destekleniyor” denmez | M (asıl iş 1’de) |
|
|
202
|
-
| 3 | **Oracle** | `ROWNUM`, synonym, `q'[…]'`, 3-parça paket, SQL*Plus `/`. Parser seçimi daha zor (`node-oracledb` sürücü; SQL parser olarak olgun bir Node AST yok — burası asıl risk). | L+ (parser belirsizliği 1’den büyük) |
|
|
203
|
-
| 4 | İkinci lehçe yeşil olduktan sonra IR kararı | İki kopya bayatlamaya başladıysa B’ye geç. Tek lehçede IR ödenmez. | L (Postgres yeniden doğrulama dahil) |
|
|
204
|
-
|
|
205
|
-
Neden MSSQL önce: (1) `ROWNUM` semantiği tavan yalanına daha yatkın; (2) Node’da T-SQL parser adayı (yine de zayıf) Oracle AST’den daha az boş; (3) banka sorusu ikisini birden soruyor — birini *dürüstçe* “yok, tasarım bu, sıra bu” diye cevaplamak, ikisini yarım vermekten iyi.
|
|
206
|
-
|
|
207
|
-
Ağır bağımlılık: yeni SQL parser. `pgsql-ast-parser` T-SQL/Oracle konuşmaz. Adaylar tasarımda gerekçelenir, bu turda eklenmez:
|
|
208
|
-
|
|
209
|
-
- MSSQL: olgun bir T-SQL AST paketi yok. Seçenekler: (a) dar bir recursive-descent (yalnız SELECT/CTE/UNION + TOP/FETCH) — bakım bizim, kapsam bilinçli dar; (b) native/WASM parser — ağır, tedarik zinciri; (c) sunucu-yanı `SET PARSEONLY` / `sys.dm_exec_describe_first_result_set` — ağa güvenir, fail-closed’u veritabanına havale eder, **red**.
|
|
210
|
-
- Oracle: aynı (a) dar parser. Resmi SQL AST yok. (c) `EXPLAIN` ile şema çözmek synonym’i *doğru* çözer ama guard’ı DB’ye taşır; ağ düşerse ya açık (yasak) ya kapalı (doğru). Yine **red**.
|
|
211
|
-
|
|
212
|
-
Öneri: ilk lehçede (a) dar parser, allow-list fonksiyon, vektör bataryası. Genel SQL diyalekti “destekliyoruz” iddiası yok.
|
|
213
|
-
|
|
214
|
-
---
|
|
215
|
-
|
|
216
|
-
## 6. Dürüst sınır — bu tasarımla kapanmayanlar
|
|
217
|
-
|
|
218
|
-
- **Synonym / view / linked server ardındaki gerçek nesne.** Parser metni görür, katalog gerçeğini değil. İlk sürüm bunları deny eder; “çözüp maskele” ayrı bir katalog-bağlama işi ve yanlış çözüm sızıntıdır.
|
|
219
|
-
- **Oturum durumu.** `SET`, `ALTER SESSION`, NLS, `ROWCOUNT`, temp table. Tek-ifade + temiz bağlantı varsayımı. Connection pool’da kirli oturum bu belgenin dışında; connector her isteği temiz oturumda açmazsa tavan/maske yalan olur.
|
|
220
|
-
- **Stored procedure / fonksiyon gövdesi.** `SELECT fn()` allow-list’teyse gövde `INSERT` içerebilir. Bugün Postgres’te de var. Yeni lehçede prosedür **deny** (çağrı yok).
|
|
221
|
-
- **PII soyağacı ifade karmaşası.** `CONCAT` / `||` / `FOR XML` ile parçalanmış TCKN bugün de yarım. Yeni lehçe bunu büyütür, kapatmaz.
|
|
222
|
-
- **Parser eksikliği.** Dar parser’ın tanımadığı her sözdizimi deny olur. Banka “bizim rapor SQL’imiz geçmiyor” diyecek. Cevap: genişletme vektörle gelir, “bir kere parse et geçir” ile değil.
|
|
223
|
-
- **Şifre / wallet / TNS / Windows auth.** Connector sırrı. Bu belge lehçe güvenliği; kimlik bilgisi rotasyonu Anayasa kilidi.
|
|
224
|
-
- **“Oracle destekliyoruz” cümlesi.** Bu belge yayınlansa bile ürün Oracle veya MSSQL konuşmaz. README/site bu turda değişmez.
|
|
225
|
-
|
|
226
|
-
---
|
|
227
|
-
|
|
228
|
-
## 7. Bankaya tek cümle
|
|
229
|
-
|
|
230
|
-
> Bugün yalnız Postgres. Oracle ve MS SQL Server birer connector değil, ikinci bir SQL ayrıştırıcı katmanı. Tasarım yazıldı: fail-closed, vektörsüz lehçe desteklenmiş sayılmaz, sıra önce SQL Server (tavan semantiği daha düz), sonra Oracle. Kod yok; tarih yok.
|
|
231
|
-
|
|
232
|
-
Bu cümle yeterli değilse bu belge verilir. “Yol haritasında var”ın kanıtı budur.
|
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
# Receipt v0.1 — GATE 1 deferred work
|
|
2
|
-
|
|
3
|
-
## F4 — gerçek metin (Claude GATE 1)
|
|
4
|
-
|
|
5
|
-
**Status:** done via **F5** (2026-07-29, push-öncesi) · **Source:** Claude GATE 1
|
|
6
|
-
|
|
7
|
-
**F4 / F5 gövdesi (patron onayıyla uygulanan metin):**
|
|
8
|
-
|
|
9
|
-
> `validateChain`'e bitişiklik kuralı (`sig` taşıyan ilk satırdan sonra her
|
|
10
|
-
> satırda `sig` zorunlu; yabancı `keyId` kabul, yokluk red) + çoklu `keyId`
|
|
11
|
-
> trust store + bu senaryonun testi.
|
|
12
|
-
|
|
13
|
-
### Uygulama (F5)
|
|
14
|
-
|
|
15
|
-
| Kural | Davranış |
|
|
16
|
-
|---|---|
|
|
17
|
-
| Bitişiklik | İlk `sig`'li satırdan sonra `sig` yokluğu → corrupt |
|
|
18
|
-
| Yabancı `keyId` | Trust store'da varsa ve crypto geçerse kabul |
|
|
19
|
-
| Trust store | Mevcut signing pubkey + `CONARIUM_AUDIT_TRUST_PUBKEYS` (`,` / `;`) |
|
|
20
|
-
| Bilinmeyen `keyId` | Trust store doluyken fail-closed |
|
|
21
|
-
| Legacy önek | İlk `sig`'den önceki imzasız satırlar hâlâ kabul |
|
|
22
|
-
|
|
23
|
-
Testler: `src/audit.receipt-gate.test.ts`.
|
|
@@ -1,200 +0,0 @@
|
|
|
1
|
-
# Conarium Receipt v0.1 — Uygulama Planı (Cursor için)
|
|
2
|
-
|
|
3
|
-
**Tasarım:** `docs/superpowers/specs/2026-07-29-conarium-receipt-design.md` — **önce onu oku.**
|
|
4
|
-
**Uygulayan:** Cursor · **Gate:** Claude (push öncesi diff incelemesi) · **Dal:** `feat/receipt-v01`
|
|
5
|
-
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
## ⛔ Cursor için sınırlar (ihlal = gate reddi)
|
|
9
|
-
|
|
10
|
-
1. **`git push` YOK, `git commit` serbest.** Push kararı patronun.
|
|
11
|
-
2. **`src/governance.ts` içindeki maskeleme mantığına DOKUNMA.** Bu iş denetim/imza katmanı.
|
|
12
|
-
3. **Mevcut HMAC davranışını BOZMA.** `signature` alanı ve `scripts/audit-chain-check.mjs`
|
|
13
|
-
çalışmaya devam etmeli. Yeni imza ayrı alan (`sig`).
|
|
14
|
-
4. **`as any` / `as string` ile tip atlatma YOK** (repo `AGENTS.md` kuralı).
|
|
15
|
-
5. **Testte gerçek assert.** "Çalıştı, hata vermedi" test değil. Her test bir bozulma senaryosunu
|
|
16
|
-
kanıtlamalı.
|
|
17
|
-
6. **Makbuza ham veri yazma.** Sorgu metni, alan değeri, müşteri adı — hiçbiri. Sadece sayı,
|
|
18
|
-
sınıf adı ve hash. Bu kuralın testi T9'da.
|
|
19
|
-
7. Bir şey belirsizse **uydurma, sor.** Tasarım dokümanında cevabı yoksa dur.
|
|
20
|
-
|
|
21
|
-
---
|
|
22
|
-
|
|
23
|
-
## T1 — Ed25519 anahtar yönetimi
|
|
24
|
-
**Dosya:** `src/keys.ts` (yeni)
|
|
25
|
-
|
|
26
|
-
```ts
|
|
27
|
-
export type KeyId = string // örn "cnr-2026-07"
|
|
28
|
-
export interface SigningKey { keyId: KeyId; privateKey: KeyObject }
|
|
29
|
-
export interface VerifyKey { keyId: KeyId; publicKey: KeyObject }
|
|
30
|
-
|
|
31
|
-
export function generateKeyPair(keyId: KeyId): { privatePem: string; publicPem: string }
|
|
32
|
-
export function loadSigningKey(): SigningKey | null // env/dosyadan, yoksa null
|
|
33
|
-
export function loadVerifyKeys(paths: string[]): VerifyKey[] // rotasyon: çoklu
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
- Node `crypto` (`generateKeyPairSync('ed25519')`). Ek bağımlılık YOK.
|
|
37
|
-
- Özel anahtar yolu: `CONARIUM_AUDIT_SIGNING_KEY` (dosya yolu). Dosya izni 0600 değilse
|
|
38
|
-
**uyarı bas** (Windows'ta izin kontrolünü atla, platform kontrolü koy).
|
|
39
|
-
- `keyId` açık anahtar dosyasının yanında `.keyid` olarak saklanır ya da PEM yorumundan okunur —
|
|
40
|
-
hangisini seçtiysen dokümana yaz.
|
|
41
|
-
|
|
42
|
-
**Kabul:** `generateKeyPair` → `loadVerifyKeys` → imzala/doğrula turu yeşil. Bozuk PEM'de
|
|
43
|
-
anlamlı hata, `throw new Error('...')` mesajı ne olduğunu söylüyor.
|
|
44
|
-
|
|
45
|
-
---
|
|
46
|
-
|
|
47
|
-
## T2 — Makbuz şeması ve üretici
|
|
48
|
-
**Dosya:** `src/receipt.ts` (yeni)
|
|
49
|
-
|
|
50
|
-
Tasarım §4'teki JSON şemasını birebir uygula. `Receipt` tipini export et.
|
|
51
|
-
|
|
52
|
-
```ts
|
|
53
|
-
export function buildReceipt(input: ReceiptInput, chain: ChainState, key: SigningKey | null): Receipt
|
|
54
|
-
export function canonicalize(obj: unknown): string // RFC 8785 (JCS)
|
|
55
|
-
export function receiptHash(r: Omit<Receipt,'hash'|'sig'|'anchor'>): string
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
- `canonicalize`: anahtarlar sıralı, boşluksuz, `undefined` alanlar atlanır. Küçük ve **kendi
|
|
59
|
-
yazdığın** bir fonksiyon olsun (JCS için ağır kütüphane çekme), ama testi sağlam olsun:
|
|
60
|
-
anahtar sırası farklı iki eşdeğer nesne aynı string üretmeli.
|
|
61
|
-
- `hash` = `sha256(canonicalize(receipt \ {hash,sig,anchor}))`, `sha256:` önekli hex.
|
|
62
|
-
- **`seq` zorunlu**, ardışık, boşluksuz. Tasarım §4'teki gerekçe: kapsama kanıtının tek dayanağı.
|
|
63
|
-
- `actor.type` v0.1'de daima `"service"`. `"user"` tipini şemada tanımla ama **üretme** —
|
|
64
|
-
Katman 2 işi.
|
|
65
|
-
- `consentRef` alanı tanımlı ve daima `null`. Şimdi rezerve, mantığı v0.2.
|
|
66
|
-
|
|
67
|
-
**Kabul:** aynı girdi → aynı hash (deterministik). Alan sırası değişince hash değişmiyor.
|
|
68
|
-
|
|
69
|
-
---
|
|
70
|
-
|
|
71
|
-
## T3 — Fail-closed imzalama (mevcut kusurun düzeltmesi)
|
|
72
|
-
**Dosya:** `src/audit.ts`
|
|
73
|
-
|
|
74
|
-
🔴 **Bugünkü kusur:** satır ~121 `if (this.hmacKey) { full.signature = ... }` ve satır ~167'de
|
|
75
|
-
aynı şekilde doğrulama — **anahtar yoksa imzalama VE doğrulama sessizce atlanıyor, hata yok.**
|
|
76
|
-
Bu, `conarium-concierge`'de bulunan yalancı arıza deseninin aynısı.
|
|
77
|
-
|
|
78
|
-
Yeni davranış:
|
|
79
|
-
- Ed25519 anahtarı varsa → `sig` üret
|
|
80
|
-
- HMAC anahtarı varsa → `signature` üret (geriye dönük uyumluluk)
|
|
81
|
-
- **İkisi de yoksa** → `CONARIUM_AUDIT_UNSIGNED=1` açıkça ayarlanmadıkça **`throw`**.
|
|
82
|
-
Ayarlıysa her başlangıçta bir kez `console.warn` bas (sessiz kalma).
|
|
83
|
-
- Doğrulama tarafında da aynı: anahtar yokken "geçti" dönmeyecek, "doğrulanamadı" diyecek.
|
|
84
|
-
|
|
85
|
-
**Kabul:** anahtarsız + env yok → `log()` fırlatıyor, test bunu doğruluyor. Anahtarsız +
|
|
86
|
-
`CONARIUM_AUDIT_UNSIGNED=1` → çalışıyor ama uyarı basılıyor. Mevcut 3 audit testi
|
|
87
|
-
(`audit.chain.test.ts`, `audit.failclosed.test.ts`, `audit-secrets.test.ts`) hâlâ yeşil.
|
|
88
|
-
|
|
89
|
-
---
|
|
90
|
-
|
|
91
|
-
## T4 — Bağımsız doğrulayıcı
|
|
92
|
-
**Dosya:** `bin/conarium-verify.mjs` (yeni, tek dosya, `src/`'a import YOK)
|
|
93
|
-
|
|
94
|
-
Neden kopya mantık: doğrulayıcının değeri **bize bağımlı olmamasında.** Üçüncü taraf `npm i`
|
|
95
|
-
yapmadan, repoyu klonlamadan tek dosyayı çalıştırabilmeli. Kanonikleştirme mantığı burada
|
|
96
|
-
tekrar yazılır — ve T5'te iki uygulamanın aynı hash'i ürettiği test edilir.
|
|
97
|
-
|
|
98
|
-
```
|
|
99
|
-
conarium-verify <dosya|dizin> --pubkey <yol> [--pubkey <yol2> ...] [--anchor-check] [--expect-seq-from N]
|
|
100
|
-
```
|
|
101
|
-
|
|
102
|
-
Çıkış kodları (tasarım §5):
|
|
103
|
-
`0` sağlam · `10` hash uyuşmuyor · `11` prevHash kopuk · `12` seq boşluklu/azalan ·
|
|
104
|
-
`13` imza geçersiz · `14` çıpa doğrulanamadı · `20` şema geçersiz
|
|
105
|
-
|
|
106
|
-
- Her hata: **insan-okunur tek satır stderr + `--json` ile makine-okunur çıktı.**
|
|
107
|
-
- **Fail-closed:** emin olunamayan hiçbir durumda 0 dönmez. Anahtar verilmediyse 13 ile çık,
|
|
108
|
-
"imzalar kontrol edilmedi" deyip 0 dönme.
|
|
109
|
-
- Boş dosya / tek kayıt → 0 ama stderr'e uyarı.
|
|
110
|
-
|
|
111
|
-
**Kabul:** T5'teki 10 senaryonun tamamı beklenen kodu döndürüyor.
|
|
112
|
-
|
|
113
|
-
---
|
|
114
|
-
|
|
115
|
-
## T5 — Testler
|
|
116
|
-
**Dosya:** `src/receipt.test.ts` (yeni) + `test/verify.test.mjs` (yeni)
|
|
117
|
-
|
|
118
|
-
| # | Senaryo | Beklenen |
|
|
119
|
-
|---|---|---|
|
|
120
|
-
| T5.1 | Ortadaki kaydın bir alanını değiştir | 10 |
|
|
121
|
-
| T5.2 | Ortadaki kaydı sil | 11 |
|
|
122
|
-
| T5.3 | İki kaydın yerini değiştir | 11 veya 12 |
|
|
123
|
-
| T5.4 | `seq` atlat (1041→1043) | 12 |
|
|
124
|
-
| T5.5 | Başka anahtarla imzala | 13 |
|
|
125
|
-
| T5.6 | Rotasyon: eski+yeni `keyId` karışık zincir, iki açık anahtar verilmiş | 0 |
|
|
126
|
-
| T5.7 | Boş zincir / tek kayıt | 0 + uyarı |
|
|
127
|
-
| T5.8 | `anchor: null` + `--anchor-check` | 14 |
|
|
128
|
-
| T5.9 | Anahtar hiç yok, env yok | üretim `throw` |
|
|
129
|
-
| T5.10 | `src/receipt.ts` ve `bin/conarium-verify.mjs` aynı makbuz için aynı hash'i üretiyor | eşit |
|
|
130
|
-
|
|
131
|
-
**T5.10 en kritik test.** İki bağımsız kanonikleştirme uygulaması ayrışırsa doğrulayıcı yanlış
|
|
132
|
-
alarm üretir ve tüm iddia çöker.
|
|
133
|
-
|
|
134
|
-
---
|
|
135
|
-
|
|
136
|
-
## T6 — Ham veri sızıntı regresyonu (zorunlu)
|
|
137
|
-
**Dosya:** `src/receipt.leak.test.ts` (yeni)
|
|
138
|
-
|
|
139
|
-
Sentetik ama gerçekçi bir veri kümesinden (e-posta, telefon, TCKN, isim, API anahtarı) makbuz
|
|
140
|
-
üret. Üretilen makbuzun **tam JSON metninde** her ham değeri ara. **0 eşleşme zorunlu.**
|
|
141
|
-
|
|
142
|
-
`argsHash` alanının ham SQL içermediğini ayrıca doğrula (SQL string'i makbuzda geçmemeli).
|
|
143
|
-
|
|
144
|
-
**Kabul:** test yeşil. Bu test kırmızıysa hiçbir şey merge edilmez — makbuz bir sızıntı yüzeyi
|
|
145
|
-
olamaz.
|
|
146
|
-
|
|
147
|
-
---
|
|
148
|
-
|
|
149
|
-
## T7 — Çıpalama (en son, ağ bağımlılığı var)
|
|
150
|
-
**Dosya:** `src/anchor.ts` (yeni)
|
|
151
|
-
|
|
152
|
-
- Zincir başı (`hash` + `seq` + `keyId`) periyodik olarak kamu şeffaflık kütüğüne yazılır.
|
|
153
|
-
Başlangıç hedefi **Sigstore/Rekor**; arayüzü soyut tut (`interface AnchorSink`) ki
|
|
154
|
-
Trillian'a taşımak tek dosya değişikliği olsun.
|
|
155
|
-
- **Yalnızca hash gider.** Alan adı, tablo adı, müşteri adı, IP — hiçbiri.
|
|
156
|
-
- **Asenkron ve bloklamaz:** çıpa başarısız olursa makbuz üretimi devam eder, `anchor: null` kalır.
|
|
157
|
-
- Sıklık: `CONARIUM_ANCHOR_EVERY_N` (varsayılan 100) veya `CONARIUM_ANCHOR_EVERY_MS`
|
|
158
|
-
(varsayılan 3600000) — hangisi önce dolarsa.
|
|
159
|
-
- Çıpa başarısızlığı **sessiz olmayacak**: sayaç tut, N ardışık başarısızlıkta `console.error`.
|
|
160
|
-
|
|
161
|
-
**Kabul:** ağ kapalıyken makbuz üretimi çalışıyor, `anchor: null`, hata loglanıyor. Ağ açıkken
|
|
162
|
-
çıpa girişi oluşuyor ve `--anchor-check` 0 dönüyor.
|
|
163
|
-
|
|
164
|
-
⚠️ Rekor'a gerçek yazma **testte yapılmaz** (dış servise bağlı test kırılgandır). `AnchorSink`
|
|
165
|
-
sahte uygulamayla test edilir; gerçek Rekor entegrasyonu elle bir kez doğrulanır ve sonucu
|
|
166
|
-
buraya yazılır.
|
|
167
|
-
|
|
168
|
-
---
|
|
169
|
-
|
|
170
|
-
## T8 — Dokümantasyon
|
|
171
|
-
- `README.md`: "Verifiable Receipts" bölümü + `conarium-verify` kullanımı + **daraltılmış iddia
|
|
172
|
-
cümlesi birebir** (tasarım §3). İddiayı genişletme.
|
|
173
|
-
- `docs/RECEIPT-SPEC.md` (yeni): şemanın kamuya açık spesifikasyonu, Madde 12/19 eşleme tablosu,
|
|
174
|
-
bilinen boşluklar bölümü (tasarım §7 aynen taşınır — boşlukları saklamıyoruz).
|
|
175
|
-
- `CHANGELOG` girdisi.
|
|
176
|
-
|
|
177
|
-
---
|
|
178
|
-
|
|
179
|
-
## Sıra ve gate noktaları
|
|
180
|
-
|
|
181
|
-
```
|
|
182
|
-
T1 ─▶ T2 ─▶ T3 ─▶ T4 ─▶ T5 ─▶ T6 ══GATE 1══▶ T7 ─▶ T8 ══GATE 2══▶ push (patron onayı)
|
|
183
|
-
(Claude) (Claude)
|
|
184
|
-
```
|
|
185
|
-
|
|
186
|
-
**GATE 1** (T6 sonrası): Claude diff'i inceler. Bakılacaklar: fail-closed gerçekten kapandı mı ·
|
|
187
|
-
T5.10 iki uygulama ayrışmıyor mu · T6 sızıntı testi gerçek mi yoksa göstermelik mi ·
|
|
188
|
-
HMAC geriye dönük uyumluluk bozulmamış mı · `governance.ts`'e dokunulmuş mu.
|
|
189
|
-
|
|
190
|
-
**GATE 2** (T8 sonrası): iddia metni genişletilmiş mi (en sık kaçak burada olur) ·
|
|
191
|
-
README'de kanıtlanamayan cümle var mı.
|
|
192
|
-
|
|
193
|
-
Push öncesi zorunlu: `git log --oneline origin/main..HEAD` ile gate'siz commit kaçmadığını
|
|
194
|
-
doğrula (Cursor paralel commit ekleyebiliyor).
|
|
195
|
-
|
|
196
|
-
---
|
|
197
|
-
|
|
198
|
-
## Kapsam dışı (bilinçli — bu planda YOK)
|
|
199
|
-
Kişi bazlı kimlik/OAuth · rıza bağlama mantığı · kapsama/olumsuz kanıt raporu · maruziyet skoru ·
|
|
200
|
-
donanım tasdiki · `/proof/live` ucu (ayrı iş, bu bittikten sonra) · MCP tehdit tespiti.
|