@conarium-ai/core 0.2.7 → 0.2.9

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 (73) hide show
  1. package/CHANGELOG.md +23 -1
  2. package/README.md +63 -0
  3. package/assets/conarium-mark-512.png +0 -0
  4. package/assets/conarium-mark.icns +0 -0
  5. package/assets/conarium-mark.ico +0 -0
  6. package/assets/conarium-mark.svg +4 -0
  7. package/assets/hero/eye-base.webp +0 -0
  8. package/assets/hero/iris.webp +0 -0
  9. package/bin/conarium-console.mjs +89 -4
  10. package/dist/audit.d.ts +3 -1
  11. package/dist/audit.d.ts.map +1 -1
  12. package/dist/audit.js +7 -1
  13. package/dist/audit.js.map +1 -1
  14. package/dist/config.d.ts +68 -0
  15. package/dist/config.d.ts.map +1 -1
  16. package/dist/config.js +38 -1
  17. package/dist/config.js.map +1 -1
  18. package/dist/console-handoff.d.ts +24 -0
  19. package/dist/console-handoff.d.ts.map +1 -0
  20. package/dist/console-handoff.js +49 -0
  21. package/dist/console-handoff.js.map +1 -0
  22. package/dist/console-notify.d.ts +6 -0
  23. package/dist/console-notify.d.ts.map +1 -0
  24. package/dist/console-notify.js +41 -0
  25. package/dist/console-notify.js.map +1 -0
  26. package/dist/console-ready.d.ts +5 -0
  27. package/dist/console-ready.d.ts.map +1 -0
  28. package/dist/console-ready.js +27 -0
  29. package/dist/console-ready.js.map +1 -0
  30. package/dist/console-receipts.d.ts +30 -0
  31. package/dist/console-receipts.d.ts.map +1 -0
  32. package/dist/console-receipts.js +137 -0
  33. package/dist/console-receipts.js.map +1 -0
  34. package/dist/console-shortcut.d.ts +57 -0
  35. package/dist/console-shortcut.d.ts.map +1 -0
  36. package/dist/console-shortcut.js +210 -0
  37. package/dist/console-shortcut.js.map +1 -0
  38. package/dist/console.d.ts +4 -0
  39. package/dist/console.d.ts.map +1 -1
  40. package/dist/console.js +131 -18
  41. package/dist/console.js.map +1 -1
  42. package/dist/custom_patterns.d.ts +42 -0
  43. package/dist/custom_patterns.d.ts.map +1 -0
  44. package/dist/custom_patterns.js +164 -0
  45. package/dist/custom_patterns.js.map +1 -0
  46. package/dist/governance.d.ts +7 -1
  47. package/dist/governance.d.ts.map +1 -1
  48. package/dist/governance.js +38 -13
  49. package/dist/governance.js.map +1 -1
  50. package/dist/http.d.ts.map +1 -1
  51. package/dist/http.js +9 -0
  52. package/dist/http.js.map +1 -1
  53. package/dist/receipt-view.d.ts +90 -0
  54. package/dist/receipt-view.d.ts.map +1 -0
  55. package/dist/receipt-view.js +338 -0
  56. package/dist/receipt-view.js.map +1 -0
  57. package/dist/receipt.d.ts +14 -0
  58. package/dist/receipt.d.ts.map +1 -1
  59. package/dist/receipt.js +39 -0
  60. package/dist/receipt.js.map +1 -1
  61. package/dist/server.d.ts.map +1 -1
  62. package/dist/server.js +1 -0
  63. package/dist/server.js.map +1 -1
  64. package/dist/types.d.ts +20 -0
  65. package/dist/types.d.ts.map +1 -1
  66. package/docs/specs/2026-08-14-oracle-mssql-dialect-design.md +232 -0
  67. package/package.json +3 -2
  68. package/public/app.js +103 -14
  69. package/public/index.html +30 -1
  70. package/public/receipts-panel.js +87 -0
  71. package/public/style.css +18 -4
  72. package/scripts/render-conarium-mark.py +70 -0
  73. package/scripts/start-mcp-c1.mjs +23 -0
@@ -0,0 +1,232 @@
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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@conarium-ai/core",
3
- "version": "0.2.7",
3
+ "version": "0.2.9",
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": [
@@ -9,6 +9,7 @@
9
9
  "scripts",
10
10
  "docs",
11
11
  "public",
12
+ "assets",
12
13
  "examples",
13
14
  "!examples/**/_keys",
14
15
  "!examples/**/*.jsonl",
@@ -70,7 +71,7 @@
70
71
  "build": "tsc",
71
72
  "test": "vitest run",
72
73
  "test:anchor-verify": "npm run build && node test/anchor_verify.mjs",
73
- "test:checks": "npm run build && node test/doctor.mjs && node test/console_cli.mjs && node test/console_policy.mjs && node test/init.mjs && node test/demo_bank_seed.mjs && node test/pack_artefakt.mjs && node test/connectors.mjs && node test/governance_lineage_adversarial.mjs && node test/governance_security_regression.mjs && node test/security_hardening_14.mjs && node test/anchor_verify.mjs && node test/spec_exitcode_drift.mjs && node test/encoding_evasion_mask.mjs && node test/verify_tail_pin.mjs && node test/partial_mask_root.mjs && node test/pii_regression_matrix.mjs && node test/scanner_perf.mjs && node test/vectors_run.mjs && node test/http_gateway.e2e.mjs && node test/suggest_policy.mjs && node test/mint_token_mode.mjs",
74
+ "test:checks": "npm run build && node test/doctor.mjs && node test/console_cli.mjs && node test/console_policy.mjs && node test/console_handoff.mjs && node test/console_receipts.mjs && node test/console_receipts_tab.mjs && node test/mark_assets.mjs && node test/c1_receipt_sink.mjs && node test/init.mjs && node test/demo_bank_seed.mjs && node test/pack_artefakt.mjs && node test/connectors.mjs && node test/governance_lineage_adversarial.mjs && node test/governance_security_regression.mjs && node test/security_hardening_14.mjs && node test/anchor_verify.mjs && node test/spec_exitcode_drift.mjs && node test/encoding_evasion_mask.mjs && node test/verify_tail_pin.mjs && node test/partial_mask_root.mjs && node test/pii_regression_matrix.mjs && node test/scanner_perf.mjs && node test/vectors_run.mjs && node test/http_gateway.e2e.mjs && node test/suggest_policy.mjs && node test/mint_token_mode.mjs",
74
75
  "test:all": "npm run lint && npm run test && npm run test:checks",
75
76
  "dev": "tsx watch src/index.ts",
76
77
  "start": "node dist/index.js",
package/public/app.js CHANGED
@@ -4,19 +4,46 @@ document.addEventListener('DOMContentLoaded', () => {
4
4
  const tabs = document.querySelectorAll('.nav-item');
5
5
  const contents = document.querySelectorAll('.tab-content');
6
6
 
7
+ function receiptUi() {
8
+ return {
9
+ chain: document.getElementById('receipt-chain'),
10
+ empty: document.getElementById('receipt-empty'),
11
+ table: document.getElementById('receipt-table'),
12
+ tbody: document.getElementById('receipt-body'),
13
+ detail: document.getElementById('receipt-detail'),
14
+ }
15
+ }
16
+
17
+ function activateTab(name) {
18
+ tabs.forEach(t => t.classList.toggle('active', t.dataset.tab === name))
19
+ contents.forEach(c => c.classList.toggle('active', c.id === 'tab-' + name))
20
+ const panel = document.getElementById('tab-' + name)
21
+ if (!panel) {
22
+ const empty = document.getElementById('receipt-empty')
23
+ if (empty && name === 'receipts') {
24
+ empty.hidden = false
25
+ empty.textContent = 'Makbuzlar alanı bulunamadı.'
26
+ }
27
+ }
28
+ }
29
+
7
30
  tabs.forEach(tab => {
8
31
  tab.addEventListener('click', (e) => {
9
32
  e.preventDefault();
10
- const targetId = `tab-${tab.dataset.tab}`;
11
-
12
- tabs.forEach(t => t.classList.remove('active'));
13
- contents.forEach(c => c.classList.remove('active'));
14
-
15
- tab.classList.add('active');
16
- document.getElementById(targetId).classList.add('active');
33
+ const name = tab.dataset.tab
34
+ activateTab(name)
35
+ if (name === 'receipts') {
36
+ ConariumReceiptsPanel.showLoading(receiptUi())
37
+ loadReceipts()
38
+ }
17
39
  });
18
40
  });
19
41
 
42
+ function csrfFromCookie() {
43
+ const m = document.cookie.match(/(?:^|; )conarium_console_csrf=([^;]*)/)
44
+ return m ? decodeURIComponent(m[1]) : ''
45
+ }
46
+
20
47
  function authHeaders(extra) {
21
48
  const params = new URLSearchParams(location.search)
22
49
  let token = params.get('token') || sessionStorage.getItem('conarium-console-token') || ''
@@ -25,10 +52,17 @@ document.addEventListener('DOMContentLoaded', () => {
25
52
  if (token) {
26
53
  headers['Authorization'] = 'Bearer ' + token
27
54
  headers['x-csrf-token'] = token
55
+ } else {
56
+ const csrf = csrfFromCookie()
57
+ if (csrf) headers['x-csrf-token'] = csrf
28
58
  }
29
59
  return headers
30
60
  }
31
61
 
62
+ function apiFetch(url, init) {
63
+ return fetch(url, { credentials: 'same-origin', ...init, headers: { ...authHeaders(init && init.headers) } })
64
+ }
65
+
32
66
  function policyOf(data) {
33
67
  if (data && typeof data.policy === 'object' && data.policy) return data.policy
34
68
  return data || {}
@@ -55,7 +89,7 @@ document.addEventListener('DOMContentLoaded', () => {
55
89
  // Load Config
56
90
  async function loadConfig() {
57
91
  try {
58
- const res = await fetch('/api/config', { headers: authHeaders() })
92
+ const res = await apiFetch('/api/config')
59
93
  if (!res.ok) {
60
94
  showToast('Could not load policy (' + res.status + '). Pass ?token=…')
61
95
  return
@@ -92,9 +126,9 @@ document.addEventListener('DOMContentLoaded', () => {
92
126
  setAllowTablesWarn(body.allowTables.length === 0)
93
127
 
94
128
  try {
95
- const res = await fetch('/api/config', {
129
+ const res = await apiFetch('/api/config', {
96
130
  method: 'POST',
97
- headers: authHeaders({ 'Content-Type': 'application/json' }),
131
+ headers: { 'Content-Type': 'application/json' },
98
132
  body: JSON.stringify(body)
99
133
  })
100
134
  if (res.ok) {
@@ -112,7 +146,7 @@ document.addEventListener('DOMContentLoaded', () => {
112
146
  // Load Audit Logs
113
147
  async function loadAudit() {
114
148
  try {
115
- const res = await fetch('/api/audit', { headers: authHeaders() });
149
+ const res = await apiFetch('/api/audit');
116
150
  const data = await res.json();
117
151
 
118
152
  const tbody = document.getElementById('audit-body');
@@ -184,10 +218,62 @@ document.addEventListener('DOMContentLoaded', () => {
184
218
 
185
219
  document.getElementById('refresh-audit').addEventListener('click', loadAudit);
186
220
 
221
+ async function loadReceipts() {
222
+ const ui = receiptUi()
223
+ try {
224
+ const res = await apiFetch('/api/receipts')
225
+ if (!res.ok) {
226
+ ConariumReceiptsPanel.showError(ui, 'Makbuz listesi alınamadı (' + res.status + ').')
227
+ return
228
+ }
229
+ const data = await res.json()
230
+ ConariumReceiptsPanel.render(ui, data, {
231
+ tr: function () { return document.createElement('tr') },
232
+ td: function () { return document.createElement('td') },
233
+ span: function () { return document.createElement('span') },
234
+ formatTime: function (ts) { return new Date(ts).toLocaleString() },
235
+ onRow: function (tr, row) {
236
+ tr.addEventListener('click', function () { openReceipt(row.id, tr) })
237
+ },
238
+ })
239
+ } catch (e) {
240
+ ConariumReceiptsPanel.showError(ui, 'Makbuz listesi alınamadı.')
241
+ }
242
+ }
243
+
244
+ async function openReceipt(id, rowEl) {
245
+ const detail = document.getElementById('receipt-detail')
246
+ document.querySelectorAll('.receipt-table-row').forEach(function (r) { r.classList.remove('selected') })
247
+ if (rowEl) rowEl.classList.add('selected')
248
+ try {
249
+ const res = await apiFetch('/api/receipts/' + encodeURIComponent(id))
250
+ if (!res.ok) {
251
+ detail.hidden = false
252
+ detail.textContent = 'Makbuz okunamadı (' + res.status + ').'
253
+ return
254
+ }
255
+ const data = await res.json()
256
+ detail.hidden = false
257
+ detail.innerHTML = data.html || ''
258
+ if (data.html && /BEGIN PRIVATE KEY|BEGIN.*PRIVATE/.test(data.html)) {
259
+ detail.textContent = 'özel anahtar panele düştü — gösterilmedi'
260
+ }
261
+ } catch (e) {
262
+ detail.hidden = false
263
+ detail.textContent = 'Makbuz okunamadı.'
264
+ }
265
+ }
266
+
267
+ const refreshReceipts = document.getElementById('refresh-receipts')
268
+ if (refreshReceipts) refreshReceipts.addEventListener('click', function () {
269
+ ConariumReceiptsPanel.showLoading(receiptUi())
270
+ loadReceipts()
271
+ })
272
+
187
273
  // Load Connectors
188
274
  async function loadConnectors() {
189
275
  try {
190
- const res = await fetch('/api/connectors', { headers: authHeaders() });
276
+ const res = await apiFetch('/api/connectors');
191
277
  const data = await res.json();
192
278
 
193
279
  const list = document.getElementById('connector-list');
@@ -238,8 +324,8 @@ document.addEventListener('DOMContentLoaded', () => {
238
324
  const out = document.getElementById('pg-result');
239
325
  out.innerHTML = '<div class="loader">Running through Conarium…</div>';
240
326
  try {
241
- const res = await fetch('/api/playground', {
242
- method: 'POST', headers: authHeaders({ 'Content-Type': 'application/json' }),
327
+ const res = await apiFetch('/api/playground', {
328
+ method: 'POST', headers: { 'Content-Type': 'application/json' },
243
329
  body: JSON.stringify({ query })
244
330
  });
245
331
  const d = await res.json();
@@ -286,4 +372,7 @@ document.addEventListener('DOMContentLoaded', () => {
286
372
  loadConfig();
287
373
  loadAudit();
288
374
  loadConnectors();
375
+ loadReceipts();
376
+ setInterval(() => { apiFetch('/api/presence').catch(() => {}) }, 2000)
377
+ window.addEventListener('pagehide', () => { apiFetch('/api/presence').catch(() => {}) })
289
378
  });
package/public/index.html CHANGED
@@ -12,7 +12,7 @@
12
12
  <!-- Sidebar -->
13
13
  <aside class="sidebar glass-panel">
14
14
  <div class="logo">
15
- <div class="logo-icon"></div>
15
+ <img class="logo-mark" src="/assets/conarium-mark.svg" width="32" height="32" alt="">
16
16
  <h2>Conarium</h2>
17
17
  </div>
18
18
  <nav>
@@ -20,6 +20,7 @@
20
20
  <a href="#" class="nav-item" data-tab="playground">Playground</a>
21
21
  <a href="#" class="nav-item" data-tab="governance">Governance</a>
22
22
  <a href="#" class="nav-item" data-tab="audit">Audit Logs</a>
23
+ <a href="#" class="nav-item" data-tab="receipts">Makbuzlar</a>
23
24
  </nav>
24
25
  </aside>
25
26
 
@@ -93,6 +94,33 @@
93
94
  </div>
94
95
  </div>
95
96
 
97
+ <div class="tab-content" id="tab-receipts">
98
+ <div class="card glass-panel">
99
+ <div class="card-header">
100
+ <h3>Makbuzlar</h3>
101
+ <button class="btn secondary-btn" id="refresh-receipts">Yenile</button>
102
+ </div>
103
+ <p id="receipt-chain" class="receipt-chain" hidden></p>
104
+ <p id="receipt-empty" class="receipt-empty" hidden></p>
105
+ <div class="table-container">
106
+ <table class="audit-table" id="receipt-table" hidden>
107
+ <thead>
108
+ <tr>
109
+ <th>Zaman</th>
110
+ <th>Aktör</th>
111
+ <th>Araç</th>
112
+ <th>Karar</th>
113
+ <th>Maske</th>
114
+ <th>seq</th>
115
+ </tr>
116
+ </thead>
117
+ <tbody id="receipt-body"></tbody>
118
+ </table>
119
+ </div>
120
+ <div id="receipt-detail" class="receipt-detail" hidden></div>
121
+ </div>
122
+ </div>
123
+
96
124
  <div class="tab-content" id="tab-audit">
97
125
  <div class="card glass-panel">
98
126
  <div class="card-header">
@@ -126,6 +154,7 @@
126
154
  <!-- Notification Toast -->
127
155
  <div id="toast" class="toast">Saved successfully</div>
128
156
 
157
+ <script src="receipts-panel.js"></script>
129
158
  <script src="app.js"></script>
130
159
  </body>
131
160
  </html>
@@ -0,0 +1,87 @@
1
+ /**
2
+ * Makbuzlar tab view-state. Fetch'ten ÖNCE çağrılır — aksi halde ilk tık
3
+ * boş (hepsi hidden) kalır ve ikinci tıkta dolu görünür.
4
+ */
5
+ (function (root) {
6
+ function showLoading(ui) {
7
+ ui.chain.hidden = true
8
+ ui.table.hidden = true
9
+ ui.detail.hidden = true
10
+ ui.empty.hidden = false
11
+ ui.empty.textContent = 'Yükleniyor…'
12
+ }
13
+
14
+ function showError(ui, message) {
15
+ ui.chain.hidden = true
16
+ ui.table.hidden = true
17
+ ui.detail.hidden = true
18
+ ui.empty.hidden = false
19
+ ui.empty.textContent = message
20
+ }
21
+
22
+ function showEmpty(ui, message) {
23
+ ui.chain.hidden = true
24
+ ui.table.hidden = true
25
+ ui.detail.hidden = true
26
+ ui.empty.hidden = false
27
+ ui.empty.textContent = message || 'henüz makbuz yok'
28
+ }
29
+
30
+ function showList(ui, data, make) {
31
+ const items = Array.isArray(data.items) ? data.items : []
32
+ const chain = data.chain || {}
33
+ ui.empty.hidden = true
34
+ ui.table.hidden = false
35
+ ui.tbody.textContent = ''
36
+ if (chain.ok === false) {
37
+ ui.chain.hidden = false
38
+ ui.chain.className = 'receipt-chain broken'
39
+ ui.chain.textContent = 'kırık (satır ' + chain.brokenAt + ')'
40
+ } else {
41
+ ui.chain.hidden = false
42
+ ui.chain.className = 'receipt-chain ok'
43
+ ui.chain.textContent = 'zincir sağlam'
44
+ }
45
+ items.forEach(function (row) {
46
+ const tr = make.tr()
47
+ tr.className = 'receipt-table-row'
48
+ tr.dataset.id = row.id
49
+ function td(v) {
50
+ const cell = make.td()
51
+ cell.textContent = v == null ? '' : String(v)
52
+ return cell
53
+ }
54
+ tr.appendChild(td(row.ts ? make.formatTime(row.ts) : ''))
55
+ tr.appendChild(td(row.actor || 'unknown'))
56
+ tr.appendChild(td(row.tool || ''))
57
+ const dec = make.td()
58
+ const badge = make.span()
59
+ badge.className =
60
+ 'status-badge-sm ' +
61
+ (row.decision === 'deny' ? 'status-rejected' : row.decision === 'partial' ? 'status-partial' : 'status-success')
62
+ badge.textContent = row.decision || ''
63
+ dec.appendChild(badge)
64
+ tr.appendChild(dec)
65
+ tr.appendChild(td(row.maskedCount == null ? '' : String(row.maskedCount)))
66
+ tr.appendChild(td(row.seq == null ? '' : String(row.seq)))
67
+ if (make.onRow) make.onRow(tr, row)
68
+ ui.tbody.appendChild(tr)
69
+ })
70
+ }
71
+
72
+ function render(ui, data, make) {
73
+ if (!data || data.error) {
74
+ showError(ui, (data && data.error) || 'Makbuz listesi alınamadı.')
75
+ return 'error'
76
+ }
77
+ const items = Array.isArray(data.items) ? data.items : []
78
+ if (items.length === 0) {
79
+ showEmpty(ui, data.empty)
80
+ return 'empty'
81
+ }
82
+ showList(ui, data, make)
83
+ return 'list'
84
+ }
85
+
86
+ root.ConariumReceiptsPanel = { showLoading, showError, showEmpty, showList, render }
87
+ })(typeof window !== 'undefined' ? window : globalThis)
package/public/style.css CHANGED
@@ -57,12 +57,10 @@ body {
57
57
  gap: 1rem;
58
58
  }
59
59
 
60
- .logo-icon {
60
+ .logo-mark {
61
61
  width: 32px;
62
62
  height: 32px;
63
- background: linear-gradient(135deg, #3b82f6, #8b5cf6);
64
- border-radius: 8px;
65
- box-shadow: 0 0 15px rgba(59, 130, 246, 0.5);
63
+ display: block;
66
64
  }
67
65
 
68
66
  .sidebar nav {
@@ -351,6 +349,7 @@ input:checked + .slider:before {
351
349
  font-weight: 600;
352
350
  }
353
351
  .status-success { background: rgba(16, 185, 129, 0.1); color: var(--success); }
352
+ .status-partial { background: rgba(230, 195, 92, 0.12); color: #e6c35c; }
354
353
  .status-rejected { background: rgba(239, 68, 68, 0.1); color: var(--danger); }
355
354
 
356
355
  /* Connectors */
@@ -488,3 +487,18 @@ input:checked + .slider:before {
488
487
  margin: 0.5rem 0;
489
488
  }
490
489
  }
490
+
491
+ .receipt-chain {
492
+ margin: 0 0 1rem;
493
+ font-weight: 650;
494
+ }
495
+ .receipt-chain.ok { color: var(--success); }
496
+ .receipt-chain.broken { color: var(--danger); }
497
+ .receipt-empty {
498
+ color: var(--text-secondary);
499
+ margin: 0 0 1rem;
500
+ }
501
+ .receipt-table-row { cursor: pointer; }
502
+ .receipt-table-row:hover { background: rgba(255, 255, 255, 0.04); }
503
+ .receipt-table-row.selected { background: rgba(59, 130, 246, 0.12); }
504
+ .receipt-detail { margin-top: 1.5rem; }