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,30 @@
1
+ {
2
+ "version": 1,
3
+ "dependencies": {
4
+ "net10.0": {
5
+ "Microsoft.CodeAnalysis.CSharp": {
6
+ "type": "Direct",
7
+ "requested": "[5.12.0, )",
8
+ "resolved": "5.12.0",
9
+ "contentHash": "6W6vBcpQFjlxog+KUGNM2fFy+XA2StC1PtnkEkechk68vFy3a28tGjEdnoA7NrxhMdr8a+zh/AmiUtBAmdkQPg==",
10
+ "dependencies": {
11
+ "Microsoft.CodeAnalysis.Analyzers": "5.9.0",
12
+ "Microsoft.CodeAnalysis.Common": "[5.12.0]"
13
+ }
14
+ },
15
+ "Microsoft.CodeAnalysis.Analyzers": {
16
+ "type": "Transitive",
17
+ "resolved": "5.9.0",
18
+ "contentHash": "jMNOo+uoBGiWbZ6Wx0dqU93r5WD4P5WnIRZdoz67RP5N09OUetHgAbo4L7hihOH1NHdD2TgW5/l+SP4gQukwww=="
19
+ },
20
+ "Microsoft.CodeAnalysis.Common": {
21
+ "type": "Transitive",
22
+ "resolved": "5.12.0",
23
+ "contentHash": "0C7o9ys497xp0kZ64sL7C6nY/5WPQlxia28VlezdonBmjxbC6mIovAYs8mBoh/QooxBBZQCo/wMuZnV1kNk9GA==",
24
+ "dependencies": {
25
+ "Microsoft.CodeAnalysis.Analyzers": "5.9.0"
26
+ }
27
+ }
28
+ }
29
+ }
30
+ }
@@ -0,0 +1,107 @@
1
+ # This file is automatically @generated by Cargo.
2
+ # It is not intended for manual editing.
3
+ version = 4
4
+
5
+ [[package]]
6
+ name = "causoryn-rust-worker"
7
+ version = "0.1.0"
8
+ dependencies = [
9
+ "proc-macro2",
10
+ "serde_json",
11
+ "syn",
12
+ ]
13
+
14
+ [[package]]
15
+ name = "itoa"
16
+ version = "1.0.19"
17
+ source = "registry+https://github.com/rust-lang/crates.io-index"
18
+ checksum = "3bd1574e617a9a6c1f8f8181bd7e841e1f20e4277607ef28945765188d6284d4"
19
+
20
+ [[package]]
21
+ name = "memchr"
22
+ version = "2.8.3"
23
+ source = "registry+https://github.com/rust-lang/crates.io-index"
24
+ checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98"
25
+
26
+ [[package]]
27
+ name = "proc-macro2"
28
+ version = "1.0.107"
29
+ source = "registry+https://github.com/rust-lang/crates.io-index"
30
+ checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
31
+ dependencies = [
32
+ "unicode-ident",
33
+ ]
34
+
35
+ [[package]]
36
+ name = "quote"
37
+ version = "1.0.47"
38
+ source = "registry+https://github.com/rust-lang/crates.io-index"
39
+ checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
40
+ dependencies = [
41
+ "proc-macro2",
42
+ ]
43
+
44
+ [[package]]
45
+ name = "serde"
46
+ version = "1.0.229"
47
+ source = "registry+https://github.com/rust-lang/crates.io-index"
48
+ checksum = "4148590afebada386688f18773da617792bf2ef03ffc1e4cbd2b1d45b023e0ba"
49
+ dependencies = [
50
+ "serde_core",
51
+ ]
52
+
53
+ [[package]]
54
+ name = "serde_core"
55
+ version = "1.0.229"
56
+ source = "registry+https://github.com/rust-lang/crates.io-index"
57
+ checksum = "67dca2c9c51e58a4791a4b1ed58308b39c64224d349a935ab5039aa360942a48"
58
+ dependencies = [
59
+ "serde_derive",
60
+ ]
61
+
62
+ [[package]]
63
+ name = "serde_derive"
64
+ version = "1.0.229"
65
+ source = "registry+https://github.com/rust-lang/crates.io-index"
66
+ checksum = "e7a5d71263a5a7d47b41f6b3f06ba276f10cc18b0931f1799f710578e2309348"
67
+ dependencies = [
68
+ "proc-macro2",
69
+ "quote",
70
+ "syn",
71
+ ]
72
+
73
+ [[package]]
74
+ name = "serde_json"
75
+ version = "1.0.154"
76
+ source = "registry+https://github.com/rust-lang/crates.io-index"
77
+ checksum = "e7e9cc8b1b85264074fbcc02a88680c4096b1e47df8f739dceb03bf482f04bd6"
78
+ dependencies = [
79
+ "itoa",
80
+ "memchr",
81
+ "serde",
82
+ "serde_core",
83
+ "zmij",
84
+ ]
85
+
86
+ [[package]]
87
+ name = "syn"
88
+ version = "3.0.10"
89
+ source = "registry+https://github.com/rust-lang/crates.io-index"
90
+ checksum = "4ae9ccbea3a7b0b09443036490c8f34a8b1b760fd345e5c0dae0aac718faea79"
91
+ dependencies = [
92
+ "proc-macro2",
93
+ "quote",
94
+ "unicode-ident",
95
+ ]
96
+
97
+ [[package]]
98
+ name = "unicode-ident"
99
+ version = "1.0.27"
100
+ source = "registry+https://github.com/rust-lang/crates.io-index"
101
+ checksum = "a2c754d6c33795a1c324727428e5a7dedb5b06195f9890bdbcba760d3e246563"
102
+
103
+ [[package]]
104
+ name = "zmij"
105
+ version = "1.0.23"
106
+ source = "registry+https://github.com/rust-lang/crates.io-index"
107
+ checksum = "29666d0abbfad1e3dc4dcf6144730dd3a3ab225bbbdac83319345b1b44ccfc1b"
@@ -0,0 +1,23 @@
1
+ [package]
2
+ name = "causoryn-rust-worker"
3
+ # Internal analyzer protocol version (locked to protocol::ANALYZER_VERSION & SQLite analyzerFingerprint; independent of causoryn package release version).
4
+ version = "0.1.0"
5
+ edition = "2021"
6
+ license = "MIT"
7
+ description = "Causoryn Rust sidecar worker — syn 2 tabanlı yerel ve deterministik analiz (TŞ v2.1 §7; M1-Rust)."
8
+
9
+ # Bağımlılık sözleşmesi (M1-Rust): yalnızca syn 2 (AST) + serde_json (JSON).
10
+ # crates.io fetch, Roslyn worker'ın NuGet örüntüsünün karşılığıdır (SERBEST);
11
+ # NPM kuralı NPM'e özgüdür — burada uygulanmaz. Başka hiçbir bağımlılık
12
+ # (sha2, quote, clap vb.) eklenmez; SHA-256 src/sha256.rs'te bağımlılıksız
13
+ # uygulanır ve kabul testleri Node crypto özetiyle birebir doğrular.
14
+ # proc-macro2, syn'in KENDİ bağımlılığıdır — burada yalnızca "span-locations"
15
+ # feature'u açılır (Span::start()/end() → evidence satır numaraları için
16
+ # zorunlu; feature kapalıyken LineColumn bilgisi üretilmez).
17
+ [dependencies]
18
+ serde_json = "1"
19
+ syn = { version = "3", features = ["full", "visit", "printing", "parsing", "extra-traits"] }
20
+ proc-macro2 = { version = "1", features = ["span-locations"] }
21
+
22
+ # debug profili adapter'ın beklenen binary konumudur:
23
+ # native/rust-worker/target/debug/causoryn-rust-worker(.exe)
@@ -0,0 +1,294 @@
1
+ # Rust Worker stdin/stdout Protokolü — v1
2
+
3
+ > Kanıt: TŞ v2.1 §7 (dil sidecar worker'ları), §8 (Unified Evidence &
4
+ > Knowledge Graph sözleşmesi), §23 (Faz G/M1-Rust dil planı). Alan adları,
5
+ > `packages/domain/src/snapshot.ts`'teki createSnapshot GİRDİ sözleşmesiyle
6
+ > (SnapshotNodeInput / SnapshotEdgeInput / SnapshotEvidenceInput — NodeRef
7
+ > uçlu, ID'siz) birebir hizalıdır. Roslyn worker
8
+ > (native/roslyn-worker/PROTOCOL.md) ile aynı kablolama desenidir; fark,
9
+ > çözümleyicinin syn 2 (crates.io) olması ve aşağıdaki DÜRÜST ÇÖZÜM
10
+ > SINIRLARIDIR.
11
+
12
+ **Causoryn Rust sidecar worker** — LLM çalıştırmayan, yerel ve
13
+ deterministik Rust çözümleyicisi. Süreç stdin'den satır satır istek okur,
14
+ her isteğe tek satır JSON yanıt döner ve analiz boyunca kullanıcı
15
+ workspace'ine HİÇBİR YAZMA yapmaz (ADR-008; analiz tamamen bellek-içindedir).
16
+
17
+ - **Taşıma:** yerel stdio; satır-bazlı JSON (her mesaj birebir tek satır).
18
+ - **Kodlama:** BOM'suz UTF-8; JSON içi yeni satırlar `\n` kaçış dizisidir,
19
+ bu yüzden framing bozulmaz.
20
+ - **stdout disiplini (kırmızı çizgi):** stdout'ta YALNIZCA protokol
21
+ satırları taşınır; tüm loglar `stderr`'e yazılır (`[rust-worker] `
22
+ öneki ile).
23
+ - **Kodlama kuralı:** JSON anahtarları domain'deki alan adlarıyla aynıdır
24
+ (camelCase); opsiyonel alanlar `null` yerine YOK olarak yazılır — tek
25
+ istisna `id` alanıdır (hata yanıtlarında açıkça `null` taşınır).
26
+ - **Bağımlılık sözleşmesi:** yalnızca `syn 2` (AST; `full`+`visit`
27
+ features) ve `serde_json` (JSON). SHA-256 bağımlılıksız uygulanır
28
+ (`src/sha256.rs`) ve Node `crypto` özetiyle kabul testlerinde
29
+ doğrulanır.
30
+
31
+ ## 1. Mesaj çerçeveleme
32
+
33
+ ```
34
+ stdout ← {"id":...,"status":"ready",...}\n (istek başına tam olarak bir satır)
35
+ stderr ← [rust-worker] ... (loglar; protokolün parçası değil)
36
+ ```
37
+
38
+ - İstemci, worker sürecini başlatır ve stdin'e istek satırları yazar.
39
+ - Her boş olmayan satır bir istektir; boş satırlar sessizce atlanır.
40
+ - Worker süreci istemci stdin'i kapattığında (EOF) `0` çıkış kodu ile biter.
41
+ Yalnızca stdio kablosu kırılırsa `1` ile biter.
42
+ - Süreç, 256 MB stack'li ayrı thread'de koşar: derin iç içe AST'lerde syn
43
+ parse/visit recursion StackOverflow'a düşmeden ya PARSE_ERROR tanısına ya
44
+ da başarıyla tamamlanmış analize dönüşür (roslyn worker'daki iki katmanlı
45
+ savunmanın karşılığı).
46
+
47
+ ## 2. İstek — `type: "analyze"`
48
+
49
+ ```json
50
+ {
51
+ "id": "fixture-rust-1",
52
+ "type": "analyze",
53
+ "protocolVersion": "1",
54
+ "files": [
55
+ { "path": "main.rs", "content": "... kaynak kod ..." }
56
+ ]
57
+ }
58
+ ```
59
+
60
+ | Alan | Tür | Kural |
61
+ |---|---|---|
62
+ | `id` | string \| sayı | **Zorunlu.** Yanıtta birebir echo edilir. |
63
+ | `type` | string | **Zorunlu.** Yalnızca `"analyze"` desteklenir. |
64
+ | `protocolVersion` | string | Opsiyonel. Varsa `"1"` olmalıdır. |
65
+ | `maxNodes` | tam sayı | Opsiyonel. Yanıt node bütçesi; `1..MaxResponseNodes` aralığında olmalı, dışı `INVALID_ARGUMENT`. Verilmezse `MaxResponseNodes` uygulanır. (bool kabul edilmez — JSON true/false sayı değildir.) |
66
+ | `files` | dizi | **Zorunlu, en az 1.** Bellek-içi kaynak çantası. |
67
+ | `files[].path` | string | **Zorunlu.** Workspace-relative POSIX yolu. Mutlak yol, `""`/`.`/`..` segmentleri reddedilir. Aynı yol iki kez verilemez. |
68
+ | `files[].content` | string | **Zorunlu.** Tam kaynak kod. |
69
+
70
+ İstek nesnesinde bilinmeyen alan → `INVALID_ARGUMENT` (kesin şema reddi,
71
+ Zod strictObject disipliniyle aynı); `files[]` girdisinde bilinmeyen alan
72
+ aynı şekilde reddedilir.
73
+
74
+ ### Kaynak sınırları (TŞ §9 resource budget; K-010: yalnızca boyut limitleri)
75
+
76
+ | Sınır | Değer | Aşım davranışı |
77
+ |---|---|---|
78
+ | `MaxRequestLineBytes` | 64.000.000 bayt (UTF-8'de kötümser üst sınır) | Satır newline'a kadar DISCARD edilir; `id: null` + `LIMIT_EXCEEDED` yanıtı yazılır, döngü devam eder. |
79
+ | `MaxFileCount` | 5.000 dosya/istek | İstek reddedilir: `LIMIT_EXCEEDED`. |
80
+ | `MaxFileContentBytes` | 2.000.000 bayt/dosya (TŞ §20 `maxFileBytes` ile uyumlu) | İstek reddedilir: `LIMIT_EXCEEDED`. |
81
+ | `MaxResponseNodes` | 250.000 node/yanıt (`maxNodes` ile altına çekilebilir) | 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. |
82
+
83
+ Sınırlar sabittir (protokol v1'de istekte yapılandırılamaz) ve aynı
84
+ girdiye deterministik davranışı korur.
85
+
86
+ ## 3. Yanıt — `status: "ready" | "partial"`
87
+
88
+ Analiz tamamlandığında:
89
+
90
+ ```json
91
+ {
92
+ "id": "fixture-rust-1",
93
+ "protocolVersion": "1",
94
+ "status": "ready",
95
+ "worker": { "analyzerId": "rust-worker", "analyzerVersion": "0.1.0" },
96
+ "capabilities": {
97
+ "astParse": true, "symbolResolution": true, "containsEdges": true,
98
+ "callEdges": true, "importEdges": false,
99
+ "routeDetection": "rust-attribute-macro-route-pattern",
100
+ "frameworkLinkers": false
101
+ },
102
+ "coverageRatio": 1.0,
103
+ "unsupportedConstructs": [...],
104
+ "warnings": [],
105
+ "diagnostics": [{ "relativePath": "...", "code": "PARSE_ERROR", "message": "...", "line": 3 }],
106
+ "nodes": [...], "edges": [...], "evidence": [...]
107
+ }
108
+ ```
109
+
110
+ - `status: "ready"` → tanı yok; `"partial"` → en az bir tanı var (TŞ §7:
111
+ "Parser başarısızsa yalnızca kanıtlanabilen bilgi sunulur"). Tanı kodları
112
+ worker-analiz düzeyidir: `PARSE_ERROR` (syn parse hatası),
113
+ `IMPL_UNKNOWN_TYPE` (bildirimi sette olmayan tipin impl'i modellenmez),
114
+ `MACRO_ITEM_SKIPPED` (makro ile tanımlı üst-düzey öğe atlanır),
115
+ `RESPONSE_TRUNCATED` (yanıt node bütçesi aşıldı — `maxNodes`/MaxResponseNodes;
116
+ uçları yayınlanmayan kenarlar düşer, dangling yok). `line` 1 tabanlıdır,
117
+ bilinmiyorsa 0.
118
+ - `coverageRatio` = verified kenar / toplam kenar (4 ondalık; TS adapter
119
+ kuralı). Kenar yoksa 0.
120
+ - `evidence` = kenarların taşıdığı kanıtların küme içinde tekil (dedupe)
121
+ listesi. Kenarın kendisi `evidence` alanında aynı kayıtları taşır.
122
+
123
+ ### Node alanları (domain GraphNode karşılığı — ID'siz)
124
+
125
+ ```json
126
+ {
127
+ "kind": "Class",
128
+ "qualifiedName": "crate::services::OrdersService",
129
+ "language": "rust",
130
+ "relativePath": "services.rs",
131
+ "attributes": { "sourceHash": "..." }
132
+ }
133
+ ```
134
+
135
+ - `kind` — TŞ §8 27-node kataloğuyla sınırlıdır. Kullanılanlar: `File`,
136
+ `Class`, `Interface`, `Function`, `Method`, `Endpoint`, `UnknownExternal`.
137
+ - `qualifiedName` kuralları (deterministik, kaynaktan türetilen):
138
+ - Modül yolu: relativePath → `.rs` son eki atılır → `/` ile
139
+ segmentlere bölünür → öndeki `src` segmenti atılır → sondaki
140
+ `main`/`lib`/`mod` segmenti atılır → kalanlar `::` ile birleşir ve
141
+ `crate::` öneki alınır (segment kalmadıysa `crate`).
142
+ Örnek: `services.rs` → `crate::services`; `main.rs` → `crate`.
143
+ - Serbest `fn` → `Function`: `<modül>::<fn>`.
144
+ - `struct` ve `enum` → `Class`: `<modül>::<Ad>` (TŞ §8 C# eşlemesinin
145
+ karşılığı; ask sözleşmesi: "struct/enum → Class").
146
+ - `trait` → `Interface`: `<modül>::<Trait>`.
147
+ - impl içindeki `fn` → `Method`: `<modül>::<Tip>::<fn>`; trait içindeki
148
+ metot bildirimi → `Method`: `<modül>::<Trait>::<metot>`.
149
+ - UnknownExternal: çağrı ifadesinin çözümlenen metni (ör.
150
+ `std::env::var`), çözülemeyen metot çağrısında metot adı, yolu
151
+ olmayan çağrıda `(anonim-cağrı)`.
152
+ - Endpoint: `"METHOD PATH"` (ör. `"GET /orders"`); `attributes`:
153
+ `method` + `path` (önde `/` ile).
154
+ - `attributes` — File: `sourceHash` (UTF-8 SHA-256, 64 hex); Endpoint:
155
+ `method` + `path`; diğerleri boş nesne.
156
+
157
+ ### Edge alanları (domain GraphEdge karşılığı — ID'siz)
158
+
159
+ ```json
160
+ {
161
+ "kind": "CALLS",
162
+ "from": { "kind": "Function", "qualifiedName": "crate::list_orders", "relativePath": "main.rs" },
163
+ "to": { "kind": "Method", "qualifiedName": "crate::services::OrdersService::list", "relativePath": "services.rs" },
164
+ "resolution": "heuristic",
165
+ "evidence": [ { "kind": "semantic-symbol", "span": {...}, "analyzerId": "rust-worker", "analyzerVersion": "0.1.0", "rationale": "..." } ],
166
+ "ambiguity": { "candidates": ["..."], "reason": "..." }
167
+ }
168
+ ```
169
+
170
+ - `from`/`to` domain **NodeRef** biçimidir (kind + qualifiedName +
171
+ relativePath); ID alanı YOKTUR — ID'ler TŞ §8 invariant (iii) gereği
172
+ domain normalizer'da (packages/domain `createSnapshot`) deterministik
173
+ üretilir. **Worker KİMLİK ÜRETMEZ** (TŞ §7.1).
174
+ - Worker'ın ürettiği kenar türleri: `CONTAINS`, `CALLS`, `ROUTES_TO`.
175
+ (IMPORTS — `use` → IMPORTS kenarı — bu dilimde üretilmez;
176
+ `capabilities.importEdges: false` açık beyan.)
177
+ - Aynı (kind, from, to, resolution) anahtarlı kenarlar birleştirilir;
178
+ evidence listeleri küme içinde tekilleşir ve sıralanır.
179
+
180
+ ### Evidence alanları (domain Evidence karşılığı — ID'siz)
181
+
182
+ ```json
183
+ {
184
+ "kind": "semantic-symbol",
185
+ "span": { "relativePath": "main.rs", "startLine": 12, "endLine": 12, "sourceHash": "<sha256-hex>" },
186
+ "analyzerId": "rust-worker",
187
+ "analyzerVersion": "0.1.0",
188
+ "rationale": "CALLS: ... (verified; syn AST, semantik çözümleyici yoktur)."
189
+ }
190
+ ```
191
+
192
+ - `span` her zaman mevcuttur; satırlar 1 tabanlıdır ve kaynak dosya
193
+ içeriği ile birebir eşleşir (kabul testleri bunu dosya metninden
194
+ hesaplar). Kanıt türleri: `ast-span` (CONTAINS + unresolved CALLS),
195
+ `semantic-symbol` (çözümlenmiş CALLS), `route-attribute` (ROUTES_TO) —
196
+ TŞ §8 kanıt türleri kümesinden.
197
+ - **Dürüstlük notu:** syn'in SEMANTİK çözümleyicisi yoktur; "semantic-symbol"
198
+ kanıt türü burada yalnızca TŞ §8 kümesindeki karşılık gelen slotu
199
+ taşır. Dayanak her zaman AST + deterministik isim tablosudur ve
200
+ rationale metni bunu açıkça söyler.
201
+
202
+ ### Resolution kuralı (TŞ §8 — rust-worker karşılığı)
203
+
204
+ | resolution | Ne zaman |
205
+ |---|---|
206
+ | `verified` | **(a)** Bare çağrı (`foo()`) AYNI dosyada (modülde) tanımlı `fn` ile eşleşir — ask sözleşmesi. **(b)** Nitelikli yol çağrısı (`a::B::c` / `B::c`) analiz seti isim tablosunda (impl metotları + serbest fn'ler) TEK eşleşme bulur. **(c)** ROUTES_TO: route özniteliği fn'e sözdizimsel olarak bağlıdır. Sınırlama (belgeli): nitelikli çağrının modül önekleri tam doğrulanmaz — eşleşme son iki segment + analiz seti tek adaydır. |
207
+ | `heuristic` | **(a)** Metot çağrısı (`x.foo()`) — alıcı türü çözülemez (trait dispatch bu dilimde yok); tek isim adayı hedef gösterilir, çok aday `ambiguity` ile işaretlenir. **(b)** Bare çağrı başka dosyada tek adaya eşleşir (import kanıtı yok). **(c)** Nitelikli yol çağrısı çok aday bulur — `ambiguity` taşıyarak. |
208
+ | `unresolved` | Hiçbir aday yok (ör. `std::env::var`, `Vec::new`); hedef açık UnknownExternal node'dur, **uydurma hedef üretilmez**. |
209
+
210
+ ### `unsupportedConstructs` (bu dilimde modellenmeyenler)
211
+
212
+ `trait-method-dispatch` (metot çağrısı alıcı türü çözülmez → heuristic),
213
+ `macro-defined-items` (makro gövdeleri/makro öğeleri gezilmez + tanı),
214
+ `use-import-resolution` (IMPORTS yok), `cross-crate-symbol-resolution`
215
+ (set dışı semboller UnknownExternal), `nested-fn-items` (fonksiyon içi
216
+ nested fn/trait/impl gövdeleri gezilmez), `struct-literal-references`
217
+ (`Order { .. }` kenarı üretmez).
218
+
219
+ ## 4. Hata yanıtı — `status: "error"`
220
+
221
+ ```json
222
+ {
223
+ "id": null,
224
+ "protocolVersion": "1",
225
+ "status": "error",
226
+ "error": { "code": "INVALID_ARGUMENT", "message": "..." }
227
+ }
228
+ ```
229
+
230
+ - İstek düzeyi sorunlar (şema ihlali, mutlak yol, `..` kaçışı, duplicate
231
+ yol, bilinmeyen `type`, bilinmeyen `protocolVersion`, bozuk JSON) tüm
232
+ isteği reddeder; döngü DEVAM EDER — sonraki satır işlenir.
233
+ - `id`, satır ayrıştırılabilirse istemcinin gönderdiği değerle echo
234
+ edilir; ayrıştırılamazsa `null`. Bozuk satır döngüyü düşürmez.
235
+ - Kodlar yalnızca TŞ §10.1 + K-008 kümesinden: `INVALID_ARGUMENT`,
236
+ `INTERNAL_ERROR`, `LIMIT_EXCEEDED` (kaynak sınırları — yukarıdaki
237
+ tablo). Worker kendi hata kodu icat etmez.
238
+ - Dosya düzeyi ayrıştırma sorunları HATA DEĞİLDİR → `status:"partial"` +
239
+ `diagnostics` (yukarıda).
240
+
241
+ ## 5. Sürüm alanı
242
+
243
+ - `protocolVersion` istekte opsiyoneldir; mevcutsa `"1"` olmalıdır.
244
+ - Yanıt her zaman `protocolVersion: "1"` taşır; `worker.analyzerVersion`
245
+ Cargo.toml `[package].version` ile senkron tutulur (kabul testi bunu
246
+ manifest'ten okuyarak doğrular) ve `Evidence.analyzerVersion`'a yazılır.
247
+ - Kırılabilir değişiklik (alan adı/anlamsal değişim) → sürüm artışı; yeni
248
+ alan eklemek sürüm artışı gerektirmez.
249
+
250
+ ## 6. Determinizm sözleşmesi (TŞ §8 invariant iv/vi)
251
+
252
+ - Aynı `files` girdisi → birebir aynı yanıt satırı (kabul testi bunu iki
253
+ koşum arasında bayt-bayt doğrular).
254
+ - Kaynaklar relativePath'e göre Ordinal sıralanır; node çıktısı
255
+ (kind, qualifiedName, relativePath) kanonik anahtarla, kenar çıktısı
256
+ (kind, from, to, resolution) kanonik anahtarla sıralanır; saat okunmaz;
257
+ BTreeMap/BTreeSet dışı sıralı olmayan yapı kullanılmaz.
258
+
259
+ ## 7. Kabül koşusu (fixture)
260
+
261
+ `examples/fixture-rust-app/` (3 dosya: main.rs, services.rs,
262
+ repositories.rs) stdin üzerinden gönderilir; kabul testleri
263
+ `tests/rust-worker.test.ts` (`npx vitest run tests/rust-worker.test.ts`).
264
+ Test bootstrap'ı cargo mevcutken derlemeyi HER TURDA koşturur
265
+ (incremental) ve başarısız derlemede suite'i AÇIKÇA fail eder — Rust
266
+ derleme regresyonu sessiz skip/yeşil ile geçiştirilmez; skip yalnızca
267
+ cargo bulunamadığında meşrudur (çalıştırılamadı olarak raporlanır):
268
+
269
+ - **Pozitif:** `GET /orders → list_orders` ve `POST /orders →
270
+ create_order` ROUTES_TO kenarları verified; `list_orders →
271
+ create_audit_entry` (aynı modül) ve `OrdersService::new →
272
+ OrderRepository::new` (nitelikli yol) CALLS verified; metot çağrısı
273
+ (`service.list()`) heuristic; `save` çağrısı trait + impl adaylarıyla
274
+ heuristic + ambiguity; `std::env::var` unresolved + UnknownExternal;
275
+ evidence satırları fixture metniyle eşleşir; node/edge türleri TŞ §8
276
+ kataloğu içinde.
277
+ - **Negatif:** boş `files` / eksik `files` / `..` segmenti / mutlak yol /
278
+ duplicate path / bilinmeyen üst-düzey alan / files[] bilinmeyen alan /
279
+ eksik `id` / bilinmeyen `type` / bilinmeyen `protocolVersion` / bozuk
280
+ JSON / `maxNodes` aralık dışı (0, 250001) ya da tam sayı değil (1.5,
281
+ true) → `INVALID_ARGUMENT` + id echo; bozuk satırdan sonra worker
282
+ yaşamaya devam eder. Sınırlar: 3 MB içerik ve 5001 dosya →
283
+ `LIMIT_EXCEEDED`.
284
+ - **Partial:** sözdizimi hatası → `status:"partial"` + dosya/satır
285
+ taşıyan tanılar; graph yine üretilir.
286
+ - **Node bütçesi:** `maxNodes` aralık/tam-sayı reddiyeleri `INVALID_ARGUMENT`;
287
+ üst sınır (`250000`) kabul edilir; 13 node'lu kümeye `maxNodes: 5` →
288
+ 5 node yayınlanır, uçları yayınlanmayan kenarlar düşer (dangling yok),
289
+ `RESPONSE_TRUNCATED` + `status:"partial"`, evidence yalnızca yayımlanan
290
+ kenarların kanıtlarından oluşur ve kırpılmış yanıt birebir
291
+ tekrarlanır. Sembol-yoğun girdi (8000 ayrı aynı-modül çağrı) tek
292
+ koşumda süre bütçesi içinde tamamlanır (push_edge BTreeMap indeksli —
293
+ O(E²) doğrusal tarama yok).
294
+ - **Determinizm:** aynı istek iki koşuda birebir aynı yanıt satırı.