@conarium-ai/core 0.2.8 → 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 (49) hide show
  1. package/CHANGELOG.md +11 -0
  2. package/README.md +31 -2
  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 +3 -0
  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-shortcut.d.ts +9 -1
  19. package/dist/console-shortcut.d.ts.map +1 -1
  20. package/dist/console-shortcut.js +47 -13
  21. package/dist/console-shortcut.js.map +1 -1
  22. package/dist/console.d.ts.map +1 -1
  23. package/dist/console.js +12 -2
  24. package/dist/console.js.map +1 -1
  25. package/dist/custom_patterns.d.ts +42 -0
  26. package/dist/custom_patterns.d.ts.map +1 -0
  27. package/dist/custom_patterns.js +164 -0
  28. package/dist/custom_patterns.js.map +1 -0
  29. package/dist/governance.d.ts +7 -1
  30. package/dist/governance.d.ts.map +1 -1
  31. package/dist/governance.js +38 -13
  32. package/dist/governance.js.map +1 -1
  33. package/dist/receipt-view.d.ts +1 -0
  34. package/dist/receipt-view.d.ts.map +1 -1
  35. package/dist/receipt-view.js +25 -4
  36. package/dist/receipt-view.js.map +1 -1
  37. package/dist/server.d.ts.map +1 -1
  38. package/dist/server.js +1 -0
  39. package/dist/server.js.map +1 -1
  40. package/dist/types.d.ts +20 -0
  41. package/dist/types.d.ts.map +1 -1
  42. package/docs/specs/2026-08-14-oracle-mssql-dialect-design.md +232 -0
  43. package/package.json +3 -2
  44. package/public/app.js +43 -66
  45. package/public/index.html +2 -1
  46. package/public/receipts-panel.js +87 -0
  47. package/public/style.css +2 -4
  48. package/scripts/render-conarium-mark.py +70 -0
  49. 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.8",
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/console_handoff.mjs && node test/console_receipts.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,16 +4,38 @@ 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
 
@@ -197,68 +219,25 @@ document.addEventListener('DOMContentLoaded', () => {
197
219
  document.getElementById('refresh-audit').addEventListener('click', loadAudit);
198
220
 
199
221
  async function loadReceipts() {
200
- const chainEl = document.getElementById('receipt-chain')
201
- const emptyEl = document.getElementById('receipt-empty')
202
- const table = document.getElementById('receipt-table')
203
- const tbody = document.getElementById('receipt-body')
204
- const detail = document.getElementById('receipt-detail')
222
+ const ui = receiptUi()
205
223
  try {
206
224
  const res = await apiFetch('/api/receipts')
207
225
  if (!res.ok) {
208
- emptyEl.hidden = false
209
- emptyEl.textContent = 'Makbuz listesi alınamadı (' + res.status + ').'
210
- chainEl.hidden = true
211
- table.hidden = true
226
+ ConariumReceiptsPanel.showError(ui, 'Makbuz listesi alınamadı (' + res.status + ').')
212
227
  return
213
228
  }
214
229
  const data = await res.json()
215
- tbody.textContent = ''
216
- const items = Array.isArray(data.items) ? data.items : []
217
- const chain = data.chain || {}
218
- if (items.length === 0) {
219
- chainEl.hidden = true
220
- table.hidden = true
221
- detail.hidden = true
222
- emptyEl.hidden = false
223
- emptyEl.textContent = data.empty || 'henüz makbuz yok'
224
- return
225
- }
226
- emptyEl.hidden = true
227
- table.hidden = false
228
- if (chain.ok === false) {
229
- chainEl.hidden = false
230
- chainEl.className = 'receipt-chain broken'
231
- chainEl.textContent = 'kırık (satır ' + chain.brokenAt + ')'
232
- } else {
233
- chainEl.hidden = false
234
- chainEl.className = 'receipt-chain ok'
235
- chainEl.textContent = 'zincir sağlam'
236
- }
237
- items.forEach(function (row) {
238
- const tr = document.createElement('tr')
239
- tr.className = 'receipt-table-row'
240
- tr.dataset.id = row.id
241
- function td(v) {
242
- const cell = document.createElement('td')
243
- cell.textContent = v == null ? '' : String(v)
244
- return cell
245
- }
246
- tr.appendChild(td(row.ts ? new Date(row.ts).toLocaleString() : ''))
247
- tr.appendChild(td(row.actor || 'unknown'))
248
- tr.appendChild(td(row.tool || ''))
249
- const dec = document.createElement('td')
250
- const badge = document.createElement('span')
251
- badge.className = 'status-badge-sm ' + (row.decision === 'deny' ? 'status-rejected' : row.decision === 'partial' ? 'status-partial' : 'status-success')
252
- badge.textContent = row.decision || ''
253
- dec.appendChild(badge)
254
- tr.appendChild(dec)
255
- tr.appendChild(td(row.maskedCount == null ? '' : String(row.maskedCount)))
256
- tr.appendChild(td(row.seq == null ? '' : String(row.seq)))
257
- tr.addEventListener('click', function () { openReceipt(row.id, tr) })
258
- tbody.appendChild(tr)
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
+ },
259
238
  })
260
239
  } catch (e) {
261
- console.error('Failed to load receipts', e)
240
+ ConariumReceiptsPanel.showError(ui, 'Makbuz listesi alınamadı.')
262
241
  }
263
242
  }
264
243
 
@@ -286,11 +265,9 @@ document.addEventListener('DOMContentLoaded', () => {
286
265
  }
287
266
 
288
267
  const refreshReceipts = document.getElementById('refresh-receipts')
289
- if (refreshReceipts) refreshReceipts.addEventListener('click', loadReceipts)
290
- document.querySelectorAll('.nav-item').forEach(function (tab) {
291
- tab.addEventListener('click', function () {
292
- if (tab.dataset.tab === 'receipts') loadReceipts()
293
- })
268
+ if (refreshReceipts) refreshReceipts.addEventListener('click', function () {
269
+ ConariumReceiptsPanel.showLoading(receiptUi())
270
+ loadReceipts()
294
271
  })
295
272
 
296
273
  // Load Connectors
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>
@@ -154,6 +154,7 @@
154
154
  <!-- Notification Toast -->
155
155
  <div id="toast" class="toast">Saved successfully</div>
156
156
 
157
+ <script src="receipts-panel.js"></script>
157
158
  <script src="app.js"></script>
158
159
  </body>
159
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 {
@@ -0,0 +1,70 @@
1
+ """Rasterize assets/conarium-mark.svg geometry. No redesign — same circles, same #fff."""
2
+ from __future__ import annotations
3
+
4
+ import struct
5
+ from io import BytesIO
6
+ from pathlib import Path
7
+
8
+ from PIL import Image, ImageDraw
9
+
10
+ ROOT = Path(__file__).resolve().parents[1]
11
+ ASSETS = ROOT / "assets"
12
+ # viewBox 0 0 32 32 — exact numbers from the extracted mark
13
+ CX, CY, R_RING, STROKE, R_DOT = 16.0, 16.0, 9.0, 1.7, 3.4
14
+ FILL = (255, 255, 255, 255)
15
+
16
+
17
+ def render(size: int) -> Image.Image:
18
+ img = Image.new("RGBA", (size, size), (0, 0, 0, 0))
19
+ draw = ImageDraw.Draw(img)
20
+ s = size / 32.0
21
+ cx, cy = CX * s, CY * s
22
+ r = R_RING * s
23
+ sw = max(STROKE * s, 1.0)
24
+ # Pillow ellipse outline is centered on the path; match SVG stroke.
25
+ outer = (cx - r - sw / 2, cy - r - sw / 2, cx + r + sw / 2, cy + r + sw / 2)
26
+ inner = (cx - r + sw / 2, cy - r + sw / 2, cx + r - sw / 2, cy + r - sw / 2)
27
+ draw.ellipse(outer, fill=FILL)
28
+ draw.ellipse(inner, fill=(0, 0, 0, 0))
29
+ rd = R_DOT * s
30
+ draw.ellipse((cx - rd, cy - rd, cx + rd, cy + rd), fill=FILL)
31
+ return img
32
+
33
+
34
+ def png_bytes(img: Image.Image) -> bytes:
35
+ buf = BytesIO()
36
+ img.save(buf, format="PNG")
37
+ return buf.getvalue()
38
+
39
+
40
+ def write_icns(path: Path, pngs: dict[bytes, bytes]) -> None:
41
+ """Minimal ICNS with PNG media (icp5/icp6/ic07/ic08/ic09)."""
42
+ chunks = b""
43
+ for typ, data in pngs.items():
44
+ chunks += typ + struct.pack(">I", 8 + len(data)) + data
45
+ path.write_bytes(b"icns" + struct.pack(">I", 8 + len(chunks)) + chunks)
46
+
47
+
48
+ def main() -> None:
49
+ ASSETS.mkdir(exist_ok=True)
50
+ sizes = (16, 32, 48, 64, 128, 256, 512)
51
+ rasters = {n: render(n) for n in sizes}
52
+ rasters[512].save(ASSETS / "conarium-mark-512.png")
53
+ rasters[256].save(ASSETS / "conarium-mark.ico", format="ICO", sizes=[(n, n) for n in (16, 32, 48, 64, 128, 256)])
54
+ write_icns(
55
+ ASSETS / "conarium-mark.icns",
56
+ {
57
+ b"icp5": png_bytes(rasters[32]),
58
+ b"icp6": png_bytes(rasters[64]),
59
+ b"ic07": png_bytes(rasters[128]),
60
+ b"ic08": png_bytes(rasters[256]),
61
+ b"ic09": png_bytes(rasters[512]),
62
+ },
63
+ )
64
+ print("wrote", ASSETS / "conarium-mark-512.png")
65
+ print("wrote", ASSETS / "conarium-mark.ico")
66
+ print("wrote", ASSETS / "conarium-mark.icns")
67
+
68
+
69
+ if __name__ == "__main__":
70
+ main()
@@ -3,6 +3,7 @@
3
3
  * Loads Supabase URL/key from jarvis-web .env.local, never prints secrets.
4
4
  */
5
5
  import { readFileSync, existsSync } from 'fs'
6
+ import { homedir } from 'os'
6
7
  import { pathToFileURL } from 'url'
7
8
  import { dirname, join } from 'path'
8
9
  import { fileURLToPath } from 'url'
@@ -51,6 +52,28 @@ if (!url || !key) {
51
52
  process.env.CONARIUM_SUPABASE_URL = url
52
53
  process.env.CONARIUM_SUPABASE_KEY = key
53
54
 
55
+ // receiptSink in c1 config requires Ed25519 at boot. Cursor mcp.json does not
56
+ // set CONARIUM_AUDIT_SIGNING_KEY — that is why receipts-c1.jsonl never appeared
57
+ // after the sink was added. Do not create an empty sink; the first governed
58
+ // access writes the first line.
59
+ if (!process.env.CONARIUM_AUDIT_SIGNING_KEY?.trim()) {
60
+ let receiptSink = ''
61
+ try {
62
+ receiptSink = JSON.parse(readFileSync(configPath, 'utf8'))?.audit?.receiptSink || ''
63
+ } catch { /* probe below still runs */ }
64
+ if (receiptSink) {
65
+ const fallback = join(homedir(), '.conarium', 'audit-ed25519.pem')
66
+ if (!existsSync(fallback)) {
67
+ console.error('[conarium-c1] receiptSink is set but CONARIUM_AUDIT_SIGNING_KEY is missing')
68
+ console.error(`[conarium-c1] expected signing key at ${fallback}`)
69
+ process.exit(1)
70
+ }
71
+ process.env.CONARIUM_AUDIT_SIGNING_KEY = fallback
72
+ console.error(`[conarium-c1] signing key=${fallback}`)
73
+ console.error('[conarium-c1] receipt file is created on the first governed access, not at start')
74
+ }
75
+ }
76
+
54
77
  // Ensure dist/index.js sees --config (it reads process.argv)
55
78
  process.argv = [process.argv[0], dist, '--config', configPath]
56
79