causoryn 0.0.0-stage → 0.2.0
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/.claude-plugin/plugin.json +36 -0
- package/.codex-plugin/mcp.json +19 -0
- package/.codex-plugin/plugin.json +38 -0
- package/.zcode-plugin/plugin.json +42 -0
- package/LICENSE +21 -0
- package/README.md +171 -2
- package/THIRD-PARTY-NOTICES.md +443 -0
- package/dist/bundle-manifest.json +39 -0
- package/dist/cli.d.ts +3 -0
- package/dist/cli.js +253 -0
- package/dist/doctor.d.ts +13 -0
- package/dist/doctor.js +507 -0
- package/dist/index.d.ts +10 -0
- package/dist/index.js +10 -0
- package/dist/mcp-server.mjs +288477 -0
- package/dist/mcp-server.mjs.LEGAL.txt +17 -0
- package/dist/node_modules/better-sqlite3/LICENSE +21 -0
- package/dist/node_modules/better-sqlite3/lib/binding.js +62 -0
- package/dist/node_modules/better-sqlite3/lib/darwin-arm64.js +3 -0
- package/dist/node_modules/better-sqlite3/lib/darwin-x64.js +3 -0
- package/dist/node_modules/better-sqlite3/lib/database.js +109 -0
- package/dist/node_modules/better-sqlite3/lib/index.js +3 -0
- package/dist/node_modules/better-sqlite3/lib/linux-arm64.js +3 -0
- package/dist/node_modules/better-sqlite3/lib/linux-x64.js +3 -0
- package/dist/node_modules/better-sqlite3/lib/linuxmusl-arm64.js +4 -0
- package/dist/node_modules/better-sqlite3/lib/linuxmusl-x64.js +4 -0
- package/dist/node_modules/better-sqlite3/lib/methods/aggregate.js +43 -0
- package/dist/node_modules/better-sqlite3/lib/methods/backup.js +67 -0
- package/dist/node_modules/better-sqlite3/lib/methods/explain.js +9 -0
- package/dist/node_modules/better-sqlite3/lib/methods/function.js +31 -0
- package/dist/node_modules/better-sqlite3/lib/methods/inspect.js +7 -0
- package/dist/node_modules/better-sqlite3/lib/methods/pragma.js +12 -0
- package/dist/node_modules/better-sqlite3/lib/methods/serialize.js +16 -0
- package/dist/node_modules/better-sqlite3/lib/methods/table.js +195 -0
- package/dist/node_modules/better-sqlite3/lib/methods/transaction.js +78 -0
- package/dist/node_modules/better-sqlite3/lib/methods/wrappers.js +54 -0
- package/dist/node_modules/better-sqlite3/lib/sqlite-error.js +25 -0
- package/dist/node_modules/better-sqlite3/lib/util.js +12 -0
- package/dist/node_modules/better-sqlite3/lib/win32-arm64.js +3 -0
- package/dist/node_modules/better-sqlite3/lib/win32-x64.js +3 -0
- package/dist/node_modules/better-sqlite3/package.json +67 -0
- package/dist/node_modules/better-sqlite3/prebuilds/darwin-arm64.node +0 -0
- package/dist/node_modules/better-sqlite3/prebuilds/darwin-x64.node +0 -0
- package/dist/node_modules/better-sqlite3/prebuilds/linux-arm64.node +0 -0
- package/dist/node_modules/better-sqlite3/prebuilds/linux-x64.node +0 -0
- package/dist/node_modules/better-sqlite3/prebuilds/linuxmusl-arm64.node +0 -0
- package/dist/node_modules/better-sqlite3/prebuilds/linuxmusl-x64.node +0 -0
- package/dist/node_modules/better-sqlite3/prebuilds/win32-arm64.node +0 -0
- package/dist/node_modules/better-sqlite3/prebuilds/win32-x64.node +0 -0
- package/dist/runtime-stage.d.ts +8 -0
- package/dist/runtime-stage.js +159 -0
- package/dist/setup.d.ts +15 -0
- package/dist/setup.js +735 -0
- package/dist/toml-patch.d.ts +10 -0
- package/dist/toml-patch.js +587 -0
- package/dist/types.d.ts +144 -0
- package/dist/types.js +35 -0
- package/dist/typescript-lib/lib.d.ts +22 -0
- package/dist/typescript-lib/lib.decorators.d.ts +384 -0
- package/dist/typescript-lib/lib.decorators.legacy.d.ts +22 -0
- package/dist/typescript-lib/lib.dom.asynciterable.d.ts +41 -0
- package/dist/typescript-lib/lib.dom.d.ts +39429 -0
- package/dist/typescript-lib/lib.dom.iterable.d.ts +571 -0
- package/dist/typescript-lib/lib.es2015.collection.d.ts +147 -0
- package/dist/typescript-lib/lib.es2015.core.d.ts +597 -0
- package/dist/typescript-lib/lib.es2015.d.ts +28 -0
- package/dist/typescript-lib/lib.es2015.generator.d.ts +77 -0
- package/dist/typescript-lib/lib.es2015.iterable.d.ts +605 -0
- package/dist/typescript-lib/lib.es2015.promise.d.ts +81 -0
- package/dist/typescript-lib/lib.es2015.proxy.d.ts +128 -0
- package/dist/typescript-lib/lib.es2015.reflect.d.ts +144 -0
- package/dist/typescript-lib/lib.es2015.symbol.d.ts +46 -0
- package/dist/typescript-lib/lib.es2015.symbol.wellknown.d.ts +326 -0
- package/dist/typescript-lib/lib.es2016.array.include.d.ts +116 -0
- package/dist/typescript-lib/lib.es2016.d.ts +21 -0
- package/dist/typescript-lib/lib.es2016.full.d.ts +23 -0
- package/dist/typescript-lib/lib.es2016.intl.d.ts +31 -0
- package/dist/typescript-lib/lib.es2017.arraybuffer.d.ts +21 -0
- package/dist/typescript-lib/lib.es2017.d.ts +26 -0
- package/dist/typescript-lib/lib.es2017.date.d.ts +31 -0
- package/dist/typescript-lib/lib.es2017.full.d.ts +23 -0
- package/dist/typescript-lib/lib.es2017.intl.d.ts +44 -0
- package/dist/typescript-lib/lib.es2017.object.d.ts +49 -0
- package/dist/typescript-lib/lib.es2017.sharedmemory.d.ts +135 -0
- package/dist/typescript-lib/lib.es2017.string.d.ts +45 -0
- package/dist/typescript-lib/lib.es2017.typedarrays.d.ts +53 -0
- package/dist/typescript-lib/lib.es2018.asyncgenerator.d.ts +77 -0
- package/dist/typescript-lib/lib.es2018.asynciterable.d.ts +53 -0
- package/dist/typescript-lib/lib.es2018.d.ts +24 -0
- package/dist/typescript-lib/lib.es2018.full.d.ts +24 -0
- package/dist/typescript-lib/lib.es2018.intl.d.ts +83 -0
- package/dist/typescript-lib/lib.es2018.promise.d.ts +30 -0
- package/dist/typescript-lib/lib.es2018.regexp.d.ts +37 -0
- package/dist/typescript-lib/lib.es2019.array.d.ts +79 -0
- package/dist/typescript-lib/lib.es2019.d.ts +24 -0
- package/dist/typescript-lib/lib.es2019.full.d.ts +24 -0
- package/dist/typescript-lib/lib.es2019.intl.d.ts +23 -0
- package/dist/typescript-lib/lib.es2019.object.d.ts +33 -0
- package/dist/typescript-lib/lib.es2019.string.d.ts +37 -0
- package/dist/typescript-lib/lib.es2019.symbol.d.ts +24 -0
- package/dist/typescript-lib/lib.es2020.bigint.d.ts +765 -0
- package/dist/typescript-lib/lib.es2020.d.ts +27 -0
- package/dist/typescript-lib/lib.es2020.date.d.ts +42 -0
- package/dist/typescript-lib/lib.es2020.full.d.ts +24 -0
- package/dist/typescript-lib/lib.es2020.intl.d.ts +474 -0
- package/dist/typescript-lib/lib.es2020.number.d.ts +28 -0
- package/dist/typescript-lib/lib.es2020.promise.d.ts +47 -0
- package/dist/typescript-lib/lib.es2020.sharedmemory.d.ts +99 -0
- package/dist/typescript-lib/lib.es2020.string.d.ts +44 -0
- package/dist/typescript-lib/lib.es2020.symbol.wellknown.d.ts +41 -0
- package/dist/typescript-lib/lib.es2021.d.ts +23 -0
- package/dist/typescript-lib/lib.es2021.full.d.ts +24 -0
- package/dist/typescript-lib/lib.es2021.intl.d.ts +166 -0
- package/dist/typescript-lib/lib.es2021.promise.d.ts +48 -0
- package/dist/typescript-lib/lib.es2021.string.d.ts +33 -0
- package/dist/typescript-lib/lib.es2021.weakref.d.ts +78 -0
- package/dist/typescript-lib/lib.es2022.array.d.ts +121 -0
- package/dist/typescript-lib/lib.es2022.d.ts +25 -0
- package/dist/typescript-lib/lib.es2022.error.d.ts +75 -0
- package/dist/typescript-lib/lib.es2022.full.d.ts +24 -0
- package/dist/typescript-lib/lib.es2022.intl.d.ts +145 -0
- package/dist/typescript-lib/lib.es2022.object.d.ts +26 -0
- package/dist/typescript-lib/lib.es2022.regexp.d.ts +39 -0
- package/dist/typescript-lib/lib.es2022.string.d.ts +25 -0
- package/dist/typescript-lib/lib.es2023.array.d.ts +924 -0
- package/dist/typescript-lib/lib.es2023.collection.d.ts +21 -0
- package/dist/typescript-lib/lib.es2023.d.ts +22 -0
- package/dist/typescript-lib/lib.es2023.full.d.ts +24 -0
- package/dist/typescript-lib/lib.es2023.intl.d.ts +56 -0
- package/dist/typescript-lib/lib.es2024.arraybuffer.d.ts +65 -0
- package/dist/typescript-lib/lib.es2024.collection.d.ts +29 -0
- package/dist/typescript-lib/lib.es2024.d.ts +26 -0
- package/dist/typescript-lib/lib.es2024.full.d.ts +24 -0
- package/dist/typescript-lib/lib.es2024.object.d.ts +29 -0
- package/dist/typescript-lib/lib.es2024.promise.d.ts +35 -0
- package/dist/typescript-lib/lib.es2024.regexp.d.ts +25 -0
- package/dist/typescript-lib/lib.es2024.sharedmemory.d.ts +68 -0
- package/dist/typescript-lib/lib.es2024.string.d.ts +29 -0
- package/dist/typescript-lib/lib.es5.d.ts +4601 -0
- package/dist/typescript-lib/lib.es6.d.ts +23 -0
- package/dist/typescript-lib/lib.esnext.array.d.ts +35 -0
- package/dist/typescript-lib/lib.esnext.collection.d.ts +96 -0
- package/dist/typescript-lib/lib.esnext.d.ts +29 -0
- package/dist/typescript-lib/lib.esnext.decorators.d.ts +28 -0
- package/dist/typescript-lib/lib.esnext.disposable.d.ts +193 -0
- package/dist/typescript-lib/lib.esnext.error.d.ts +24 -0
- package/dist/typescript-lib/lib.esnext.float16.d.ts +445 -0
- package/dist/typescript-lib/lib.esnext.full.d.ts +24 -0
- package/dist/typescript-lib/lib.esnext.intl.d.ts +21 -0
- package/dist/typescript-lib/lib.esnext.iterator.d.ts +148 -0
- package/dist/typescript-lib/lib.esnext.promise.d.ts +34 -0
- package/dist/typescript-lib/lib.esnext.sharedmemory.d.ts +25 -0
- package/dist/typescript-lib/lib.scripthost.d.ts +322 -0
- package/dist/typescript-lib/lib.webworker.asynciterable.d.ts +41 -0
- package/dist/typescript-lib/lib.webworker.d.ts +13150 -0
- package/dist/typescript-lib/lib.webworker.importscripts.d.ts +23 -0
- package/dist/typescript-lib/lib.webworker.iterable.d.ts +340 -0
- package/licenses/Apache-2.0.txt +55 -0
- package/licenses/TypeScript-ThirdPartyNoticeText.txt +193 -0
- package/licenses/better-sqlite3-LICENSE.txt +21 -0
- package/mcp_config.json +16 -0
- package/native/go-worker/PROTOCOL.md +316 -0
- package/native/go-worker/cmd/worker/main.go +440 -0
- package/native/go-worker/go.mod +3 -0
- package/native/go-worker/internal/analyze/analyze.go +820 -0
- package/native/go-worker/internal/analyze/model.go +182 -0
- package/native/go-worker/internal/analyze/routes.go +181 -0
- package/native/python-worker/PROTOCOL.md +342 -0
- package/native/python-worker/worker.py +1190 -0
- package/native/roslyn-worker/Causoryn.RoslynWorker.csproj +40 -0
- package/native/roslyn-worker/Causoryn.RoslynWorker.deps.json +59 -0
- package/native/roslyn-worker/Causoryn.RoslynWorker.dll +0 -0
- package/native/roslyn-worker/Causoryn.RoslynWorker.runtimeconfig.json +13 -0
- package/native/roslyn-worker/Microsoft.CodeAnalysis.CSharp.dll +0 -0
- package/native/roslyn-worker/Microsoft.CodeAnalysis.dll +0 -0
- package/native/roslyn-worker/PROTOCOL.md +285 -0
- package/native/roslyn-worker/Program.cs +249 -0
- package/native/roslyn-worker/Protocol.cs +397 -0
- package/native/roslyn-worker/ReferenceResolver.cs +235 -0
- package/native/roslyn-worker/WorkerAnalyzer.cs +1669 -0
- package/native/roslyn-worker/packages.lock.json +30 -0
- package/native/rust-worker/Cargo.lock +107 -0
- package/native/rust-worker/Cargo.toml +23 -0
- package/native/rust-worker/PROTOCOL.md +294 -0
- package/native/rust-worker/src/analyzer.rs +1209 -0
- package/native/rust-worker/src/main.rs +127 -0
- package/native/rust-worker/src/protocol.rs +284 -0
- package/native/rust-worker/src/sha256.rs +136 -0
- package/package.json +71 -4
- package/plugin.json +17 -0
- package/scripts/causoryn.mjs +40 -0
- package/scripts/lib/node-version-guard.mjs +24 -0
- package/scripts/plugin-mcp-launcher.mjs +111 -0
- package/skills/causoryn/SKILL.md +53 -0
- package/skills/map-system/SKILL.md +69 -0
- package/skills/preflight-change/SKILL.md +38 -0
- package/skills/verify-change/SKILL.md +31 -0
|
@@ -0,0 +1,342 @@
|
|
|
1
|
+
# Python Worker stdin/stdout Protokolü — v1
|
|
2
|
+
|
|
3
|
+
> Kanıt: TŞ v2.1 §7 (Python FastAPI/Django — "Python AST + framework
|
|
4
|
+
> rules", "L1/L2, seçili L3"), §8 (Unified Evidence & Knowledge Graph
|
|
5
|
+
> sözleşmesi), §22 ("Python selected route; unresolved dynamic import;
|
|
6
|
+
> deterministic export" golden testleri), §23 (DoD: positive/negative/
|
|
7
|
+
> partial fixture + evidence). Desen kaynağı: `native/roslyn-worker/
|
|
8
|
+
> PROTOCOL.md` v1. Alan adları, `packages/domain/src/snapshot.ts`'teki
|
|
9
|
+
> createSnapshot GİRDİ sözleşmesiyle (SnapshotNodeInput /
|
|
10
|
+
> SnapshotEdgeInput / SnapshotEvidenceInput — NodeRef uçlu, ID'siz)
|
|
11
|
+
> birebir hizalıdır.
|
|
12
|
+
|
|
13
|
+
**Causoryn Python sidecar worker** — LLM çalıştırmayan, yerel ve
|
|
14
|
+
deterministik Python çözümleyicisi. Yalnızca Python stdlib kullanır
|
|
15
|
+
(`ast` + `hashlib` + `json` + `sys` — sıfır dış bağımlılık). Süreç
|
|
16
|
+
stdin'den satır satır istek okur, her isteğe tek satır JSON yanıt döner
|
|
17
|
+
ve analiz boyunca kullanıcı workspace'ine HİÇBİR YAZMA yapmaz (ADR-008;
|
|
18
|
+
analiz tamamen bellek-içindedir).
|
|
19
|
+
|
|
20
|
+
- **Taşıma:** yerel stdio; satır-bazlı JSON (her mesaj birebir tek satır).
|
|
21
|
+
- **Kodlama:** BOM'suz UTF-8; worker binary buffer (`sys.stdin.buffer` /
|
|
22
|
+
`sys.stdout.buffer`) ile çalışır — Windows konsol kod sayfasından
|
|
23
|
+
bağımsızdır. JSON içi yeni satırlar `\n` kaçış dizisidir, framing
|
|
24
|
+
bozulmaz. Adapter env allowlist'i `PYTHONIOENCODING`'i BİLBLİÇLI
|
|
25
|
+
TAŞIMAZ — değer, allowlist dışında parent'tan bağımsız her zaman
|
|
26
|
+
`"utf-8"` olarak sabitlenir (aşağıdaki log kanalı maddesi);
|
|
27
|
+
`PYTHONPATH` de bilinçli taşınmaz (worker saf stdlib'tir).
|
|
28
|
+
- **stdout disiplini (kırmızı çizgi):** stdout'ta YALNIZCA protokol
|
|
29
|
+
satırları taşınır; tüm loglar `stderr`'e yazılır (`[python-worker] `
|
|
30
|
+
öneki ile). **Log kanalı UTF-8'dir:** worker kendi stderr'ini
|
|
31
|
+
`reconfigure(encoding="utf-8")` ile sabitler ve adapter spawn env'inde
|
|
32
|
+
`PYTHONIOENCODING=utf-8` değerini parent'tan bağımsız sabitler — piped
|
|
33
|
+
stderr locale kod sayfasına (Windows ANSI) düşemez (takım denetimi
|
|
34
|
+
bulgusu; kabul testi: "stderr UTF-8 kodlanır — PYTHONIOENCODING olmasa
|
|
35
|
+
bile").
|
|
36
|
+
- **Kodlama kuralı:** JSON anahtarları domain'deki alan adlarıyla aynıdır
|
|
37
|
+
(camelCase); opsiyonel alanlar `null` yerine YOK olarak yazılır — tek
|
|
38
|
+
istisna `id` alanıdır (hata yanıtlarında açıkça `null` taşınır).
|
|
39
|
+
- **Bytecode disiplini:** adapter worker'ı `python -B` ile başlatır;
|
|
40
|
+
worker hiçbir dosyaya yazmaz (`__pycache__` dahil).
|
|
41
|
+
|
|
42
|
+
## 1. Mesaj çerçeveleme
|
|
43
|
+
|
|
44
|
+
```
|
|
45
|
+
stdout ← {"id":...,"status":"ready",...}\n (istek başına tam olarak bir satır)
|
|
46
|
+
stderr ← [python-worker] ... (loglar; protokolün parçası değil)
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
- İstemci, worker sürecini başlatır ve stdin'e istek satırları yazar.
|
|
50
|
+
- Her boş olmayan satır bir istektir; boş satırlar sessizce atlanır.
|
|
51
|
+
- Worker süreci istemci stdin'i kapattığında (EOF) `0` çıkış kodu ile biter.
|
|
52
|
+
Yalnızca stdio kabuğu kırılırsa (`BrokenPipeError`/`OSError`) `1` ile biter.
|
|
53
|
+
|
|
54
|
+
## 2. İstek — `type: "analyze"`
|
|
55
|
+
|
|
56
|
+
```json
|
|
57
|
+
{
|
|
58
|
+
"id": "fixture-orders-1",
|
|
59
|
+
"type": "analyze",
|
|
60
|
+
"protocolVersion": "1",
|
|
61
|
+
"files": [
|
|
62
|
+
{ "path": "services/orders_service.py", "content": "... kaynak kod ..." }
|
|
63
|
+
]
|
|
64
|
+
}
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
| Alan | Tür | Kural |
|
|
68
|
+
|---|---|---|
|
|
69
|
+
| `id` | string \| sayı | **Zorunlu.** Yanıtta birebir echo edilir (bool kabul edilmez). |
|
|
70
|
+
| `type` | string | **Zorunlu.** Yalnızca `"analyze"` desteklenir. |
|
|
71
|
+
| `protocolVersion` | string | Opsiyonel. Varsa `"1"` olmalıdır. |
|
|
72
|
+
| `files` | dizi | **Zorunlu, en az 1.** Bellek-içi kaynak çantası. |
|
|
73
|
+
| `files[].path` | string | **Zorunlu.** Workspace-relative POSIX yolu. Mutlak yol, sürücü harfi, `\` karakteri, `""`/`.`/`..` segmentleri reddedilir. Aynı yol iki kez verilemez. |
|
|
74
|
+
| `files[].content` | string | **Zorunlu.** Tam kaynak kod. |
|
|
75
|
+
| `maxNodes` | tam sayı | Opsiyonel (güvenlik bulgusu 4 deseni). Yanıt node bütçesi; `1..250000` aralığında olmalı, dışı `INVALID_ARGUMENT`. Verilmezse `MAX_RESPONSE_NODES` uygulanır. |
|
|
76
|
+
|
|
77
|
+
İstek nesnesinde bilinmeyen alan → `INVALID_ARGUMENT` (kesin şema reddi);
|
|
78
|
+
`files[]` öğesinde bilinmeyen alan → aynı davranış.
|
|
79
|
+
|
|
80
|
+
### Kaynak sınırları (TŞ §9 resource budget; K-010: yalnızca boyut limitleri)
|
|
81
|
+
|
|
82
|
+
| Sınır | Değer | Aşım davranışı |
|
|
83
|
+
|---|---|---|
|
|
84
|
+
| `MAX_REQUEST_LINE_BYTES` | 64.000.000 bayt | Satır newline'a kadar DISCARD edilir; `id: null` + `LIMIT_EXCEEDED` yanıtı yazılır, döngü devam eder. |
|
|
85
|
+
| `MAX_FILE_COUNT` | 5.000 dosya/istek | İstek reddedilir: `LIMIT_EXCEEDED`. |
|
|
86
|
+
| `MAX_FILE_CONTENT_BYTES` | 2.000.000 bayt/dosya (TŞ §20 `maxFileBytes` ile uyumlu) | İstek reddedilir: `LIMIT_EXCEEDED`. |
|
|
87
|
+
| `MAX_RESPONSE_NODES` | 250.000 node/yanıt | Sert tavan ya da istek bütçesi dolunca aşan node'lar YAYINLANMAZ; uçları yayınlanmayan kenarlar da düşer (dangling yok). Yanıta `RESPONSE_TRUNCATED` tanısı düşer ve `status: "partial"` olur — sessiz kesim yoktur. |
|
|
88
|
+
|
|
89
|
+
Sınırlar sabittir (protokol v1'de istekte yapılandırılamaz) ve aynı
|
|
90
|
+
girdiye deterministik davranışı korur.
|
|
91
|
+
|
|
92
|
+
**Derinlik savunması (takım denetimi netleştirmesi):** birincil savunma
|
|
93
|
+
CPython parser'ının yapısal sınırlarıdır — aşırı derin iç içe yapılar
|
|
94
|
+
`ast.parse` aşamasında `SyntaxError` ("too many levels of indentation" /
|
|
95
|
+
"too many nested parentheses") ile reddedilir → dosya başına `SyntaxError`
|
|
96
|
+
tanısı + yalnızca File node (L0), analiz `partial` sürer ve süreç yaşamaya
|
|
97
|
+
devam eder (kabul testi: tests/python-worker.test.ts "aşırı derin iç içe
|
|
98
|
+
yapı"). İkincil katman olarak AST gezinme derinliği 1000'i aşan alt
|
|
99
|
+
ağaçlar atlanır ve dosya başına bir kez `ADAPTER_INTERNAL` tanısı yazılır;
|
|
100
|
+
bu sayaç tipik koşumda tetiklenmez (parser sınırı daha önce devreye girer).
|
|
101
|
+
|
|
102
|
+
**Süreç yaşamlılığının gerçek mekanizması (takım denetimi tur-2
|
|
103
|
+
netleştirmesi):** bildirim/çağrı gezinmesi REKÜRSİFTİR (`_declare` /
|
|
104
|
+
`_walk_calls`) — beklenmedik derinlik `RecursionError` üretebilir ve
|
|
105
|
+
geziniğin kendisi "iteratif" değildir. Süreç bununla ölmez çünkü
|
|
106
|
+
`handle_line`'ın analiz gövdesini saran `except Exception` savunması her
|
|
107
|
+
beklenmeyen istisnayı istek-başına hata yanıtına çevirir ve döngüyü ayakta
|
|
108
|
+
tutar. Aynı şekilde derin iç içe JSON satırının `json.loads`'unun
|
|
109
|
+
fırlattığı `RecursionError` açıkça yakalanır → `INVALID_ARGUMENT` yanıtı,
|
|
110
|
+
döngü devam eder (kabul testi: "derin iç içe JSON satırı").
|
|
111
|
+
|
|
112
|
+
## 3. Yanıt — `status: "ready" | "partial"`
|
|
113
|
+
|
|
114
|
+
Analiz tamamlandığında:
|
|
115
|
+
|
|
116
|
+
```json
|
|
117
|
+
{
|
|
118
|
+
"id": "fixture-orders-1",
|
|
119
|
+
"protocolVersion": "1",
|
|
120
|
+
"status": "ready",
|
|
121
|
+
"worker": { "analyzerId": "python-worker", "analyzerVersion": "0.1.0" },
|
|
122
|
+
"capabilities": {
|
|
123
|
+
"astParse": true, "symbolResolution": true, "containsEdges": true,
|
|
124
|
+
"callEdges": true, "importEdges": false,
|
|
125
|
+
"routeDetection": "python-decorator-route-pattern",
|
|
126
|
+
"frameworkLinkers": false
|
|
127
|
+
},
|
|
128
|
+
"coverageRatio": 0.64,
|
|
129
|
+
"unsupportedConstructs": [...],
|
|
130
|
+
"warnings": ["app.py: 'flask_app.get' dekoratör yolu literal string değil; ..."],
|
|
131
|
+
"diagnostics": [{ "relativePath": "broken.py", "code": "SyntaxError", "message": "...", "line": 1 }],
|
|
132
|
+
"nodes": [...], "edges": [...], "evidence": [...]
|
|
133
|
+
}
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
- `status: "ready"` → tanı yok; `"partial"` → en az bir tanı var
|
|
137
|
+
(TŞ §7: "Parser başarısızsa yalnızca kanıtlanabilen bilgi sunulur").
|
|
138
|
+
Tanı kaynakları: dosya başına `SyntaxError` (satır 1 tabanlı; bilinmiyorsa
|
|
139
|
+
0), `ADAPTER_INTERNAL` (derinlik/parse savunması, line 0),
|
|
140
|
+
`RESPONSE_TRUNCATED` (node bütçesi, line 0, relativePath "").
|
|
141
|
+
- `coverageRatio` = verified kenar / toplam kenar (4 ondalık; TS adapter
|
|
142
|
+
kuralı). Kenar yoksa 1.0.
|
|
143
|
+
- `evidence` = yayımlanan kenarların taşıdığı kanıtların küme içinde tekil
|
|
144
|
+
(dedupe) listesi. Kenarın kendisi `evidence` alanında aynı kayıtları taşır.
|
|
145
|
+
|
|
146
|
+
### Node alanları (domain GraphNode karşılığı — ID'siz)
|
|
147
|
+
|
|
148
|
+
```json
|
|
149
|
+
{
|
|
150
|
+
"kind": "Function",
|
|
151
|
+
"qualifiedName": "services.orders_service.create_order",
|
|
152
|
+
"language": "python",
|
|
153
|
+
"relativePath": "services/orders_service.py",
|
|
154
|
+
"attributes": { "sourceHash": "...", "method": "POST", "path": "/orders" }
|
|
155
|
+
}
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
- `kind` — TŞ §8 27-node kataloğuyla sınırlıdır; worker liste dışı kind
|
|
159
|
+
üretemez (çıkış anında sert doğrulama). Kullanılanlar: `File`,
|
|
160
|
+
`Function`, `Method`, `Class`, `Endpoint`, `UnknownExternal`.
|
|
161
|
+
- `qualifiedName` kuralları:
|
|
162
|
+
- **File:** relativePath'in kendisi (roslyn kuralıyla aynı).
|
|
163
|
+
- **Modül adı türetme:** `app.py` → `app`; `services/orders_service.py` →
|
|
164
|
+
`services.orders_service`; `pkg/__init__.py` → `pkg`.
|
|
165
|
+
- **Modül düzeyi fonksiyon:** `<modül>.<ad>` (ör. `app.get_orders`).
|
|
166
|
+
- **Sınıf:** `<modül>.<Sınıf>`; **metot:** `<modül>.<Sınıf>.<ad>`;
|
|
167
|
+
iç içe sınıf noktayla birleşir.
|
|
168
|
+
- **İç içe fonksiyon** (fonksiyon gövdesinde def): `<sarmalayan qn>.<ad>`
|
|
169
|
+
— sınıf üyesi sayılmaz (`Function` kind).
|
|
170
|
+
- **Endpoint:** `"{VERB} {path}"` (ör. `"GET /orders"`) — roslyn Endpoint
|
|
171
|
+
kuralıyla aynı.
|
|
172
|
+
- **UnknownExternal:** çağrı ifadesinin kaynak metni; noktalı zincir
|
|
173
|
+
çözülebiliyorsa zincir (ör. `logger.info`, `_ORDERS.values`), yoksa
|
|
174
|
+
`ast.unparse` çıktısı. **Dil bilgisi olmayan sembol uydurulmaz.**
|
|
175
|
+
- `attributes` — File: `sourceHash` (UTF-8 SHA-256, 64 hex); Endpoint:
|
|
176
|
+
`method` + `path` (önde `/` ile). Diğer kind'lerde `{}`.
|
|
177
|
+
- `language` — tüm node'larda `"python"` (UnknownExternal dahil; çağrı
|
|
178
|
+
noktası Python kaynağıdır).
|
|
179
|
+
|
|
180
|
+
### Edge alanları (domain GraphEdge karşılığı — ID'siz)
|
|
181
|
+
|
|
182
|
+
```json
|
|
183
|
+
{
|
|
184
|
+
"kind": "CALLS",
|
|
185
|
+
"from": { "kind": "Function", "qualifiedName": "app.add_order", "relativePath": "app.py" },
|
|
186
|
+
"to": { "kind": "Function", "qualifiedName": "services.orders_service.create_order",
|
|
187
|
+
"relativePath": "services/orders_service.py" },
|
|
188
|
+
"resolution": "heuristic",
|
|
189
|
+
"evidence": [ { "kind": "ast-span", "span": {...}, "analyzerId": "python-worker",
|
|
190
|
+
"analyzerVersion": "0.1.0", "rationale": "CALLS: ... (heuristic; ...)." } ],
|
|
191
|
+
"ambiguity": { "candidates": ["services.orders_service.create_order"],
|
|
192
|
+
"reason": "import edilen modül sembolü; Python ad bağlamı dinamiktir, ..." }
|
|
193
|
+
}
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
- `from`/`to` domain **NodeRef** biçimidir (kind + qualifiedName +
|
|
197
|
+
relativePath); ID alanı YOKTUR — ID'ler TŞ §8 invariant (iii) gereği
|
|
198
|
+
domain normalizer'da deterministik üretilir. **Worker KİMLİK ÜRETMEZ.**
|
|
199
|
+
- UnknownExternal uçlar relativePath TAŞIMAZ (analiz seti dışı sembol;
|
|
200
|
+
roslyn EnsureExternal kuralı).
|
|
201
|
+
- Worker'ın ürettiği kenar türleri: `CONTAINS`, `CALLS`, `ROUTES_TO`.
|
|
202
|
+
(IMPORTS kenarı bu dilimde üretilmez — `capabilities.importEdges: false`
|
|
203
|
+
açık beyan; import tablosu yalnızca CALLS çözümlemesi için tutulur.)
|
|
204
|
+
- TŞ §8 invariant (ii): dangling edge yok — UnknownExternal hedef, kenar
|
|
205
|
+
eklenirken açık node olarak node kümesine girer.
|
|
206
|
+
|
|
207
|
+
### Evidence alanları (domain Evidence karşılığı — ID'siz)
|
|
208
|
+
|
|
209
|
+
```json
|
|
210
|
+
{
|
|
211
|
+
"kind": "ast-span",
|
|
212
|
+
"span": { "relativePath": "...", "startLine": 19, "endLine": 19, "sourceHash": "<sha256-hex>" },
|
|
213
|
+
"analyzerId": "python-worker",
|
|
214
|
+
"analyzerVersion": "0.1.0",
|
|
215
|
+
"rationale": "CALLS: app.add_order → ... (heuristic; tam type inference yok)."
|
|
216
|
+
}
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
- `span` her zaman mevcuttur; satırlar 1 tabanlıdır ve istekteki dosya
|
|
220
|
+
içeriği ile birebir eşleşir (kabul koşusu bunu dosya metninden hesaplar).
|
|
221
|
+
- Kanıt türleri: `ast-span` (CONTAINS + CALLS), `route-attribute`
|
|
222
|
+
(ROUTES_TO) — TŞ §8 kanıt türleri kümesinden. Python'da semantik model
|
|
223
|
+
motoru YOKTUR; "semantic-symbol" kanıtı BU worker'da ÜRETİLMEZ (dürüst
|
|
224
|
+
etiket kuralı: AST isim bağlamı semantik çözümleme değildir).
|
|
225
|
+
|
|
226
|
+
### Resolution kuralı (TŞ §8 — dürüstlük tablosu)
|
|
227
|
+
|
|
228
|
+
| resolution | Ne zaman |
|
|
229
|
+
|---|---|
|
|
230
|
+
| `verified` | Hedef AYNI modülde tanımlı: modül düzeyi ad (def/class), `self.<m>` (sarmalayan sınıfın üye tablosu), `AynıModülSınıfı.<m>`. Decorator-handler ilişkisi (ROUTES_TO) her zaman verified'dır — dekoratör handler'ın kendisine sözdizimsel bağlıdır. |
|
|
231
|
+
| `heuristic` | Hedef IMPORT EDİLEN modül sembolü (analiz setinde ya da dışında). Kenar `ambiguity` taşır. **Tam type inference YOK — dürüst sınırlama (TŞ §7 Python satırı: monkey-patching, runtime DI).** |
|
|
232
|
+
| `unresolved` | Çözülemeyen çağrılar: yerel değişken/parametre üzerinden çağrı, built-in'ler (`list`, `isinstance`), tanımsız adlar. Hedef açık UnknownExternal node'dur; **uydurma hedef/kenar üretilmez**. |
|
|
233
|
+
|
|
234
|
+
Örnek zincir (fixture): `POST /orders → app.add_order` (ROUTES_TO,
|
|
235
|
+
verified) → `services.orders_service.create_order` (heuristic; import) →
|
|
236
|
+
`repositories.order_repository.save` (heuristic; import) ve
|
|
237
|
+
`create_order → _validate_order` (verified; aynı modül).
|
|
238
|
+
|
|
239
|
+
### Route kuralları (seçili L3 — "python-decorator-route-pattern")
|
|
240
|
+
|
|
241
|
+
- `@carrier.get("/path")` / `post` / `put` / `patch` / `delete` / `head` /
|
|
242
|
+
`options` / `trace` → Endpoint `{VERB} {path}`. Taşıyıcı adına (`app`,
|
|
243
|
+
`router`, `api`, `bp`...) kısıt konmaz; dekoratör kullanımında bu adlar
|
|
244
|
+
fiilen rota kaydı içindir (bilinen-ad kuralı).
|
|
245
|
+
- `@carrier.route("/path")` / `@carrier.api_route("/path")` → Flask tarzı:
|
|
246
|
+
`methods=["GET","POST"]` kwarg'ındaki her method için bir Endpoint;
|
|
247
|
+
belirtilmezse Flask varsayılanı **GET**.
|
|
248
|
+
- **Taşıyıcı basit ad DEĞİLSE** (ör. `@routers["main"].get("/x")`,
|
|
249
|
+
subscript/nitelik zincirli taşıyıcı): endpoint ÜRETİLMEZ ve `warnings`'e
|
|
250
|
+
açık not yazılır — "sessiz kesim yoktur" disiplini (takım denetimi
|
|
251
|
+
bulgusu). HTTP-verb/route adlı attr içermeyen dekoratörler rota adayı
|
|
252
|
+
olmadığından sessiz atlanır.
|
|
253
|
+
- Endpoint yolu LİTERAL string sabiti OLMALIDIR (`ast.Constant`); değişken
|
|
254
|
+
/ ifadesel yol → endpoint ÜRETİLMEZ + `warnings`'e açık not (sessiz kesim
|
|
255
|
+
yoktur).
|
|
256
|
+
- Modül düzeyi çağrılar (`app = FastAPI()` vb.) caller'sızdır → CALLS
|
|
257
|
+
üretilmez (`unsupportedConstructs: "module-level-calls"`).
|
|
258
|
+
|
|
259
|
+
### `unsupportedConstructs` (bu dilimde modellenmeyenler)
|
|
260
|
+
|
|
261
|
+
`monkey-patching`, `runtime-dependency-injection`,
|
|
262
|
+
`dynamic-import (importlib/__import__)`, `local-variable-type-inference`
|
|
263
|
+
(yerel değişkene atanan nesnenin metot çağrısı çözülmez),
|
|
264
|
+
`module-level-calls (caller'sız)`, `decorator-arg-non-literal-path`,
|
|
265
|
+
`function-level-imports (yalnızca modül düzeyi import tablosu)`.
|
|
266
|
+
|
|
267
|
+
## 4. Hata yanıtı — `status: "error"`
|
|
268
|
+
|
|
269
|
+
```json
|
|
270
|
+
{
|
|
271
|
+
"id": null,
|
|
272
|
+
"protocolVersion": "1",
|
|
273
|
+
"status": "error",
|
|
274
|
+
"error": { "code": "INVALID_ARGUMENT", "message": "..." }
|
|
275
|
+
}
|
|
276
|
+
```
|
|
277
|
+
|
|
278
|
+
- İstek düzeyi sorunlar (şema ihlali, mutlak yol, `..` kaçışı, duplicate
|
|
279
|
+
yol, bilinmeyen `type`, bilinmeyen `protocolVersion`, bozuk JSON —
|
|
280
|
+
derin iç içe JSON'un `RecursionError`'u dahil — ve UTF-8 bozuk satır)
|
|
281
|
+
tüm isteği reddeder; döngü DEVAM EDER — sonraki satır işlenir.
|
|
282
|
+
- `id`, satır ayrıştırılabilirse istemcinin gönderdiği değerle echo
|
|
283
|
+
edilir; ayrıştırılamazsa/geçersizse `null`. Bozuk satır döngüyü düşürmez.
|
|
284
|
+
- Kodlar yalnızca TŞ §10.1 + K-008 kümesinden: `INVALID_ARGUMENT`,
|
|
285
|
+
`INTERNAL_ERROR`, `LIMIT_EXCEEDED` (kaynak sınırları — yukarıdaki
|
|
286
|
+
tablo). Worker kendi hata kodu icat etmez.
|
|
287
|
+
- Dosya düzeyi ayrıştırma sorunları HATA DEĞİLDİR → `status:"partial"` +
|
|
288
|
+
`diagnostics`; bozuk dosyadan yalnızca File node (sourceHash'li) yayımlanır,
|
|
289
|
+
sağlam dosyaların grafiği üretilmeye devam eder.
|
|
290
|
+
|
|
291
|
+
## 5. Sürüm alanı
|
|
292
|
+
|
|
293
|
+
- `protocolVersion` istekte opsiyoneldir; mevcutsa `"1"` olmalıdır.
|
|
294
|
+
Desteklenmeyen sürüm `INVALID_ARGUMENT` döner.
|
|
295
|
+
- Yanıt her zaman `protocolVersion: "1"` taşır; `worker.analyzerVersion`
|
|
296
|
+
worker.py `ANALYZER_VERSION` (0.1.0) ile senkron tutulur ve
|
|
297
|
+
`Evidence.analyzerVersion`'a yazılır. TS adapter sabiti
|
|
298
|
+
(`PYTHON_WORKER_ADAPTER_VERSION`) aynı değeri taşır.
|
|
299
|
+
- Kırılabilir değişiklik (alan adı/anlamsal değişim) → sürüm artışı; yeni
|
|
300
|
+
alan eklemek sürüm artışı gerektirmez.
|
|
301
|
+
|
|
302
|
+
## 6. Determinizm sözleşmesi (TŞ §8 invariant iv/vi)
|
|
303
|
+
|
|
304
|
+
- Aynı `files` girdisi → birebir aynı yanıt satırı (kabul koşusu bunu iki
|
|
305
|
+
koşum arasında bayt-bayt doğrular — `tests/python-worker.test.ts`).
|
|
306
|
+
- Kaynaklar relativePath sırasıyla işlenmez; node/edge/evidence çıktısı
|
|
307
|
+
kanonik anahtarla sıralanır (node: kind+qualifiedName+relativePath;
|
|
308
|
+
edge: kind+uçlar+resolution; evidence: canonical JSON). Saat okunmaz;
|
|
309
|
+
ortam okunmaz (stdlib dışı import yok).
|
|
310
|
+
- `ast.parse` deterministiktir; `ast.unparse` (UnknownExternal kaynak
|
|
311
|
+
metni için) aynı sürümde deterministiktir. Çıktı `ensure_ascii=False`,
|
|
312
|
+
kompakt ayraçlarla UTF-8 yazılır.
|
|
313
|
+
|
|
314
|
+
## 7. Kabül koşusu (fixture)
|
|
315
|
+
|
|
316
|
+
`examples/fixture-python-app/` (3 dosya: app.py, services/
|
|
317
|
+
orders_service.py, repositories/order_repository.py) stdin üzerinden
|
|
318
|
+
gönderilir; kabul testleri `tests/python-worker.test.ts` ve
|
|
319
|
+
`adapters/python/test/python-adapter.test.ts` (`npx vitest run <dosya>`,
|
|
320
|
+
kökten). Test bootstrap'ı python'ı HER TURDA yoklar; worker script yoksa
|
|
321
|
+
suite AÇIKÇA fail eder — eksik teslimat sessiz skip/yeşil ile
|
|
322
|
+
geçiştirilmez; skip yalnızca python bulunamadığında meşrudur
|
|
323
|
+
(çalıştırılamadı olarak raporlanır):
|
|
324
|
+
|
|
325
|
+
- **Pozitif:** `POST /orders → app.add_order →
|
|
326
|
+
services.orders_service.create_order →
|
|
327
|
+
repositories.order_repository.save` zinciri; `create_order →
|
|
328
|
+
_validate_order`, `self._stamp`, modül fonksiyonu `save` verified CALLS;
|
|
329
|
+
`GET /orders`, `POST /orders` ROUTES_TO verified (route-attribute);
|
|
330
|
+
her verified kenar ≥1 evidence ve span satırı/hash'i fixture metniyle
|
|
331
|
+
eşleşir; node/edge türleri TŞ §8 kataloğu içinde.
|
|
332
|
+
- **Negatif:** boş/eksik `files`, eksik `content`, bilinmeyen alanlar,
|
|
333
|
+
`..` segmenti, mutlak yol, sürücü harfi, backslash, boş segment,
|
|
334
|
+
duplicate path, eksik/geçersiz `id`, bilinmeyen `type`,
|
|
335
|
+
bilinmeyen `protocolVersion`, maxNodes aralık dışı → `INVALID_ARGUMENT`
|
|
336
|
+
+ id echo; bozuk JSON satırından (5000 katman derin JSON dahil —
|
|
337
|
+
RecursionError catch'i) sonra worker yaşamaya devam eder.
|
|
338
|
+
Sınırlar: 2 MB içerik ve 5001 dosya → `LIMIT_EXCEEDED`.
|
|
339
|
+
- **Partial:** sözdizimi hatası → `status:"partial"` + dosya+satır taşıyan
|
|
340
|
+
tanı; bozuk dosyadan uydurma bildirim yok; sağlam dosyanın grafiği
|
|
341
|
+
üretilir. `maxNodes` bütçesi → `RESPONSE_TRUNCATED` + dangling yok.
|
|
342
|
+
- **Determinizm:** aynı istek iki koşuda birebir aynı yanıt satırı.
|