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.
Files changed (197) hide show
  1. package/.claude-plugin/plugin.json +36 -0
  2. package/.codex-plugin/mcp.json +19 -0
  3. package/.codex-plugin/plugin.json +38 -0
  4. package/.zcode-plugin/plugin.json +42 -0
  5. package/LICENSE +21 -0
  6. package/README.md +171 -2
  7. package/THIRD-PARTY-NOTICES.md +443 -0
  8. package/dist/bundle-manifest.json +39 -0
  9. package/dist/cli.d.ts +3 -0
  10. package/dist/cli.js +253 -0
  11. package/dist/doctor.d.ts +13 -0
  12. package/dist/doctor.js +507 -0
  13. package/dist/index.d.ts +10 -0
  14. package/dist/index.js +10 -0
  15. package/dist/mcp-server.mjs +288477 -0
  16. package/dist/mcp-server.mjs.LEGAL.txt +17 -0
  17. package/dist/node_modules/better-sqlite3/LICENSE +21 -0
  18. package/dist/node_modules/better-sqlite3/lib/binding.js +62 -0
  19. package/dist/node_modules/better-sqlite3/lib/darwin-arm64.js +3 -0
  20. package/dist/node_modules/better-sqlite3/lib/darwin-x64.js +3 -0
  21. package/dist/node_modules/better-sqlite3/lib/database.js +109 -0
  22. package/dist/node_modules/better-sqlite3/lib/index.js +3 -0
  23. package/dist/node_modules/better-sqlite3/lib/linux-arm64.js +3 -0
  24. package/dist/node_modules/better-sqlite3/lib/linux-x64.js +3 -0
  25. package/dist/node_modules/better-sqlite3/lib/linuxmusl-arm64.js +4 -0
  26. package/dist/node_modules/better-sqlite3/lib/linuxmusl-x64.js +4 -0
  27. package/dist/node_modules/better-sqlite3/lib/methods/aggregate.js +43 -0
  28. package/dist/node_modules/better-sqlite3/lib/methods/backup.js +67 -0
  29. package/dist/node_modules/better-sqlite3/lib/methods/explain.js +9 -0
  30. package/dist/node_modules/better-sqlite3/lib/methods/function.js +31 -0
  31. package/dist/node_modules/better-sqlite3/lib/methods/inspect.js +7 -0
  32. package/dist/node_modules/better-sqlite3/lib/methods/pragma.js +12 -0
  33. package/dist/node_modules/better-sqlite3/lib/methods/serialize.js +16 -0
  34. package/dist/node_modules/better-sqlite3/lib/methods/table.js +195 -0
  35. package/dist/node_modules/better-sqlite3/lib/methods/transaction.js +78 -0
  36. package/dist/node_modules/better-sqlite3/lib/methods/wrappers.js +54 -0
  37. package/dist/node_modules/better-sqlite3/lib/sqlite-error.js +25 -0
  38. package/dist/node_modules/better-sqlite3/lib/util.js +12 -0
  39. package/dist/node_modules/better-sqlite3/lib/win32-arm64.js +3 -0
  40. package/dist/node_modules/better-sqlite3/lib/win32-x64.js +3 -0
  41. package/dist/node_modules/better-sqlite3/package.json +67 -0
  42. package/dist/node_modules/better-sqlite3/prebuilds/darwin-arm64.node +0 -0
  43. package/dist/node_modules/better-sqlite3/prebuilds/darwin-x64.node +0 -0
  44. package/dist/node_modules/better-sqlite3/prebuilds/linux-arm64.node +0 -0
  45. package/dist/node_modules/better-sqlite3/prebuilds/linux-x64.node +0 -0
  46. package/dist/node_modules/better-sqlite3/prebuilds/linuxmusl-arm64.node +0 -0
  47. package/dist/node_modules/better-sqlite3/prebuilds/linuxmusl-x64.node +0 -0
  48. package/dist/node_modules/better-sqlite3/prebuilds/win32-arm64.node +0 -0
  49. package/dist/node_modules/better-sqlite3/prebuilds/win32-x64.node +0 -0
  50. package/dist/runtime-stage.d.ts +8 -0
  51. package/dist/runtime-stage.js +159 -0
  52. package/dist/setup.d.ts +15 -0
  53. package/dist/setup.js +735 -0
  54. package/dist/toml-patch.d.ts +10 -0
  55. package/dist/toml-patch.js +587 -0
  56. package/dist/types.d.ts +144 -0
  57. package/dist/types.js +35 -0
  58. package/dist/typescript-lib/lib.d.ts +22 -0
  59. package/dist/typescript-lib/lib.decorators.d.ts +384 -0
  60. package/dist/typescript-lib/lib.decorators.legacy.d.ts +22 -0
  61. package/dist/typescript-lib/lib.dom.asynciterable.d.ts +41 -0
  62. package/dist/typescript-lib/lib.dom.d.ts +39429 -0
  63. package/dist/typescript-lib/lib.dom.iterable.d.ts +571 -0
  64. package/dist/typescript-lib/lib.es2015.collection.d.ts +147 -0
  65. package/dist/typescript-lib/lib.es2015.core.d.ts +597 -0
  66. package/dist/typescript-lib/lib.es2015.d.ts +28 -0
  67. package/dist/typescript-lib/lib.es2015.generator.d.ts +77 -0
  68. package/dist/typescript-lib/lib.es2015.iterable.d.ts +605 -0
  69. package/dist/typescript-lib/lib.es2015.promise.d.ts +81 -0
  70. package/dist/typescript-lib/lib.es2015.proxy.d.ts +128 -0
  71. package/dist/typescript-lib/lib.es2015.reflect.d.ts +144 -0
  72. package/dist/typescript-lib/lib.es2015.symbol.d.ts +46 -0
  73. package/dist/typescript-lib/lib.es2015.symbol.wellknown.d.ts +326 -0
  74. package/dist/typescript-lib/lib.es2016.array.include.d.ts +116 -0
  75. package/dist/typescript-lib/lib.es2016.d.ts +21 -0
  76. package/dist/typescript-lib/lib.es2016.full.d.ts +23 -0
  77. package/dist/typescript-lib/lib.es2016.intl.d.ts +31 -0
  78. package/dist/typescript-lib/lib.es2017.arraybuffer.d.ts +21 -0
  79. package/dist/typescript-lib/lib.es2017.d.ts +26 -0
  80. package/dist/typescript-lib/lib.es2017.date.d.ts +31 -0
  81. package/dist/typescript-lib/lib.es2017.full.d.ts +23 -0
  82. package/dist/typescript-lib/lib.es2017.intl.d.ts +44 -0
  83. package/dist/typescript-lib/lib.es2017.object.d.ts +49 -0
  84. package/dist/typescript-lib/lib.es2017.sharedmemory.d.ts +135 -0
  85. package/dist/typescript-lib/lib.es2017.string.d.ts +45 -0
  86. package/dist/typescript-lib/lib.es2017.typedarrays.d.ts +53 -0
  87. package/dist/typescript-lib/lib.es2018.asyncgenerator.d.ts +77 -0
  88. package/dist/typescript-lib/lib.es2018.asynciterable.d.ts +53 -0
  89. package/dist/typescript-lib/lib.es2018.d.ts +24 -0
  90. package/dist/typescript-lib/lib.es2018.full.d.ts +24 -0
  91. package/dist/typescript-lib/lib.es2018.intl.d.ts +83 -0
  92. package/dist/typescript-lib/lib.es2018.promise.d.ts +30 -0
  93. package/dist/typescript-lib/lib.es2018.regexp.d.ts +37 -0
  94. package/dist/typescript-lib/lib.es2019.array.d.ts +79 -0
  95. package/dist/typescript-lib/lib.es2019.d.ts +24 -0
  96. package/dist/typescript-lib/lib.es2019.full.d.ts +24 -0
  97. package/dist/typescript-lib/lib.es2019.intl.d.ts +23 -0
  98. package/dist/typescript-lib/lib.es2019.object.d.ts +33 -0
  99. package/dist/typescript-lib/lib.es2019.string.d.ts +37 -0
  100. package/dist/typescript-lib/lib.es2019.symbol.d.ts +24 -0
  101. package/dist/typescript-lib/lib.es2020.bigint.d.ts +765 -0
  102. package/dist/typescript-lib/lib.es2020.d.ts +27 -0
  103. package/dist/typescript-lib/lib.es2020.date.d.ts +42 -0
  104. package/dist/typescript-lib/lib.es2020.full.d.ts +24 -0
  105. package/dist/typescript-lib/lib.es2020.intl.d.ts +474 -0
  106. package/dist/typescript-lib/lib.es2020.number.d.ts +28 -0
  107. package/dist/typescript-lib/lib.es2020.promise.d.ts +47 -0
  108. package/dist/typescript-lib/lib.es2020.sharedmemory.d.ts +99 -0
  109. package/dist/typescript-lib/lib.es2020.string.d.ts +44 -0
  110. package/dist/typescript-lib/lib.es2020.symbol.wellknown.d.ts +41 -0
  111. package/dist/typescript-lib/lib.es2021.d.ts +23 -0
  112. package/dist/typescript-lib/lib.es2021.full.d.ts +24 -0
  113. package/dist/typescript-lib/lib.es2021.intl.d.ts +166 -0
  114. package/dist/typescript-lib/lib.es2021.promise.d.ts +48 -0
  115. package/dist/typescript-lib/lib.es2021.string.d.ts +33 -0
  116. package/dist/typescript-lib/lib.es2021.weakref.d.ts +78 -0
  117. package/dist/typescript-lib/lib.es2022.array.d.ts +121 -0
  118. package/dist/typescript-lib/lib.es2022.d.ts +25 -0
  119. package/dist/typescript-lib/lib.es2022.error.d.ts +75 -0
  120. package/dist/typescript-lib/lib.es2022.full.d.ts +24 -0
  121. package/dist/typescript-lib/lib.es2022.intl.d.ts +145 -0
  122. package/dist/typescript-lib/lib.es2022.object.d.ts +26 -0
  123. package/dist/typescript-lib/lib.es2022.regexp.d.ts +39 -0
  124. package/dist/typescript-lib/lib.es2022.string.d.ts +25 -0
  125. package/dist/typescript-lib/lib.es2023.array.d.ts +924 -0
  126. package/dist/typescript-lib/lib.es2023.collection.d.ts +21 -0
  127. package/dist/typescript-lib/lib.es2023.d.ts +22 -0
  128. package/dist/typescript-lib/lib.es2023.full.d.ts +24 -0
  129. package/dist/typescript-lib/lib.es2023.intl.d.ts +56 -0
  130. package/dist/typescript-lib/lib.es2024.arraybuffer.d.ts +65 -0
  131. package/dist/typescript-lib/lib.es2024.collection.d.ts +29 -0
  132. package/dist/typescript-lib/lib.es2024.d.ts +26 -0
  133. package/dist/typescript-lib/lib.es2024.full.d.ts +24 -0
  134. package/dist/typescript-lib/lib.es2024.object.d.ts +29 -0
  135. package/dist/typescript-lib/lib.es2024.promise.d.ts +35 -0
  136. package/dist/typescript-lib/lib.es2024.regexp.d.ts +25 -0
  137. package/dist/typescript-lib/lib.es2024.sharedmemory.d.ts +68 -0
  138. package/dist/typescript-lib/lib.es2024.string.d.ts +29 -0
  139. package/dist/typescript-lib/lib.es5.d.ts +4601 -0
  140. package/dist/typescript-lib/lib.es6.d.ts +23 -0
  141. package/dist/typescript-lib/lib.esnext.array.d.ts +35 -0
  142. package/dist/typescript-lib/lib.esnext.collection.d.ts +96 -0
  143. package/dist/typescript-lib/lib.esnext.d.ts +29 -0
  144. package/dist/typescript-lib/lib.esnext.decorators.d.ts +28 -0
  145. package/dist/typescript-lib/lib.esnext.disposable.d.ts +193 -0
  146. package/dist/typescript-lib/lib.esnext.error.d.ts +24 -0
  147. package/dist/typescript-lib/lib.esnext.float16.d.ts +445 -0
  148. package/dist/typescript-lib/lib.esnext.full.d.ts +24 -0
  149. package/dist/typescript-lib/lib.esnext.intl.d.ts +21 -0
  150. package/dist/typescript-lib/lib.esnext.iterator.d.ts +148 -0
  151. package/dist/typescript-lib/lib.esnext.promise.d.ts +34 -0
  152. package/dist/typescript-lib/lib.esnext.sharedmemory.d.ts +25 -0
  153. package/dist/typescript-lib/lib.scripthost.d.ts +322 -0
  154. package/dist/typescript-lib/lib.webworker.asynciterable.d.ts +41 -0
  155. package/dist/typescript-lib/lib.webworker.d.ts +13150 -0
  156. package/dist/typescript-lib/lib.webworker.importscripts.d.ts +23 -0
  157. package/dist/typescript-lib/lib.webworker.iterable.d.ts +340 -0
  158. package/licenses/Apache-2.0.txt +55 -0
  159. package/licenses/TypeScript-ThirdPartyNoticeText.txt +193 -0
  160. package/licenses/better-sqlite3-LICENSE.txt +21 -0
  161. package/mcp_config.json +16 -0
  162. package/native/go-worker/PROTOCOL.md +316 -0
  163. package/native/go-worker/cmd/worker/main.go +440 -0
  164. package/native/go-worker/go.mod +3 -0
  165. package/native/go-worker/internal/analyze/analyze.go +820 -0
  166. package/native/go-worker/internal/analyze/model.go +182 -0
  167. package/native/go-worker/internal/analyze/routes.go +181 -0
  168. package/native/python-worker/PROTOCOL.md +342 -0
  169. package/native/python-worker/worker.py +1190 -0
  170. package/native/roslyn-worker/Causoryn.RoslynWorker.csproj +40 -0
  171. package/native/roslyn-worker/Causoryn.RoslynWorker.deps.json +59 -0
  172. package/native/roslyn-worker/Causoryn.RoslynWorker.dll +0 -0
  173. package/native/roslyn-worker/Causoryn.RoslynWorker.runtimeconfig.json +13 -0
  174. package/native/roslyn-worker/Microsoft.CodeAnalysis.CSharp.dll +0 -0
  175. package/native/roslyn-worker/Microsoft.CodeAnalysis.dll +0 -0
  176. package/native/roslyn-worker/PROTOCOL.md +285 -0
  177. package/native/roslyn-worker/Program.cs +249 -0
  178. package/native/roslyn-worker/Protocol.cs +397 -0
  179. package/native/roslyn-worker/ReferenceResolver.cs +235 -0
  180. package/native/roslyn-worker/WorkerAnalyzer.cs +1669 -0
  181. package/native/roslyn-worker/packages.lock.json +30 -0
  182. package/native/rust-worker/Cargo.lock +107 -0
  183. package/native/rust-worker/Cargo.toml +23 -0
  184. package/native/rust-worker/PROTOCOL.md +294 -0
  185. package/native/rust-worker/src/analyzer.rs +1209 -0
  186. package/native/rust-worker/src/main.rs +127 -0
  187. package/native/rust-worker/src/protocol.rs +284 -0
  188. package/native/rust-worker/src/sha256.rs +136 -0
  189. package/package.json +71 -4
  190. package/plugin.json +17 -0
  191. package/scripts/causoryn.mjs +40 -0
  192. package/scripts/lib/node-version-guard.mjs +24 -0
  193. package/scripts/plugin-mcp-launcher.mjs +111 -0
  194. package/skills/causoryn/SKILL.md +53 -0
  195. package/skills/map-system/SKILL.md +69 -0
  196. package/skills/preflight-change/SKILL.md +38 -0
  197. 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ı.