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,36 @@
1
+ {
2
+ "name": "causoryn",
3
+ "version": "0.2.0",
4
+ "description": "Deterministic, local, LLM-free codebase and change intelligence for Claude Code: read-only workspace graphs, architecture maps, preflight checks, post-change verification, and living wiki.",
5
+ "author": {
6
+ "name": "Causoryn Contributors",
7
+ "url": "https://github.com/MrBekoX/Causoryn"
8
+ },
9
+ "homepage": "https://github.com/MrBekoX/Causoryn#readme",
10
+ "repository": "https://github.com/MrBekoX/Causoryn",
11
+ "license": "MIT",
12
+ "keywords": [
13
+ "mcp",
14
+ "code-analysis",
15
+ "static-analysis",
16
+ "architecture-map",
17
+ "preflight",
18
+ "claude-code"
19
+ ],
20
+ "skills": "./skills",
21
+ "mcpServers": {
22
+ "causoryn": {
23
+ "type": "stdio",
24
+ "command": "node",
25
+ "args": [
26
+ "${CLAUDE_PLUGIN_ROOT}/scripts/plugin-mcp-launcher.mjs",
27
+ "--expected-version",
28
+ "0.2.0",
29
+ "--allow-cwd",
30
+ "--auto-data-dir",
31
+ "--client",
32
+ "claude-code"
33
+ ]
34
+ }
35
+ }
36
+ }
@@ -0,0 +1,19 @@
1
+ {
2
+ "mcpServers": {
3
+ "causoryn": {
4
+ "command": "npx",
5
+ "args": [
6
+ "-y",
7
+ "--package",
8
+ "causoryn@0.2.0",
9
+ "causoryn",
10
+ "mcp",
11
+ "--allow-cwd",
12
+ "--auto-data-dir",
13
+ "--client",
14
+ "codex"
15
+ ],
16
+ "startup_timeout_sec": 30
17
+ }
18
+ }
19
+ }
@@ -0,0 +1,38 @@
1
+ {
2
+ "name": "causoryn",
3
+ "version": "0.2.0",
4
+ "description": "Deterministic, local, LLM-free codebase and change intelligence for Codex: read-only workspace graphs, architecture maps, preflight checks, post-change verification, and living wiki.",
5
+ "author": {
6
+ "name": "Causoryn Contributors",
7
+ "url": "https://github.com/MrBekoX/Causoryn"
8
+ },
9
+ "homepage": "https://github.com/MrBekoX/Causoryn#readme",
10
+ "repository": "https://github.com/MrBekoX/Causoryn",
11
+ "license": "MIT",
12
+ "keywords": [
13
+ "mcp",
14
+ "code-analysis",
15
+ "static-analysis",
16
+ "architecture-map",
17
+ "preflight",
18
+ "codex"
19
+ ],
20
+ "skills": "./skills",
21
+ "mcpServers": "./.codex-plugin/mcp.json",
22
+ "interface": {
23
+ "displayName": "Causoryn",
24
+ "shortDescription": "Local, deterministic codebase and change intelligence via MCP.",
25
+ "developerName": "Causoryn Contributors",
26
+ "category": "Coding",
27
+ "capabilities": [
28
+ "Interactive",
29
+ "Read"
30
+ ],
31
+ "websiteURL": "https://github.com/MrBekoX/Causoryn",
32
+ "defaultPrompt": [
33
+ "Map this workspace and show evidence for critical dependencies",
34
+ "Run a change preflight for the selected endpoint",
35
+ "Verify my working-tree changes against architecture contracts"
36
+ ]
37
+ }
38
+ }
@@ -0,0 +1,42 @@
1
+ {
2
+ "name": "causoryn",
3
+ "version": "0.2.0",
4
+ "description": "Deterministic, local, LLM-free codebase and change intelligence for ZCode (GLM): read-only workspace graphs, architecture maps, preflight checks, post-change verification, and living wiki.",
5
+ "description_i18n": {
6
+ "en": "Deterministic, local, LLM-free codebase and change intelligence for ZCode (GLM): read-only workspace graphs, architecture maps, preflight checks, post-change verification, and living wiki.",
7
+ "tr": "ZCode (GLM) icin deterministik, yerel, LLM-bagimsiz kod tabani ve degisiklik istihbarati: salt-okunur calisma alani grafikleri, mimari haritalama, preflight ve degisiklik dogrulama."
8
+ },
9
+ "author": {
10
+ "name": "Causoryn Contributors",
11
+ "url": "https://github.com/MrBekoX/Causoryn"
12
+ },
13
+ "homepage": "https://github.com/MrBekoX/Causoryn#readme",
14
+ "repository": "https://github.com/MrBekoX/Causoryn",
15
+ "license": "MIT",
16
+ "keywords": [
17
+ "mcp",
18
+ "code-analysis",
19
+ "static-analysis",
20
+ "architecture-map",
21
+ "preflight",
22
+ "zcode",
23
+ "glm"
24
+ ],
25
+ "skills": "skills",
26
+ "mcpServers": {
27
+ "causoryn": {
28
+ "type": "stdio",
29
+ "command": "node",
30
+ "args": [
31
+ "${ZCODE_PLUGIN_ROOT}/scripts/plugin-mcp-launcher.mjs",
32
+ "--expected-version",
33
+ "0.2.0",
34
+ "--allow-cwd",
35
+ "--auto-data-dir",
36
+ "--client",
37
+ "zcode"
38
+ ],
39
+ "cwd": "${ZCODE_PROJECT_DIR}"
40
+ }
41
+ }
42
+ }
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Causoryn Contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,172 @@
1
- # Temporary Holding Version
1
+ # Causoryn (`causoryn` v0.2.0 — Pre-1.0 Public Preview)
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ **Causoryn** is a **local, deterministic, LLM-free** codebase and change intelligence
4
+ engine exposed over the Model Context Protocol (`stdio`). It constructs evidence-backed
5
+ dependency, symbol, route, and contract graphs across your project while enforcing a
6
+ strict **read-only workspace guarantee**: Causoryn never modifies your source tree and
7
+ writes snapshots, Living Wiki SQLite databases, and exports strictly outside the analyzed
8
+ workspace.
9
+
10
+ > **Release status (`ADR-010`):** `0.2.0` is a **Pre-1.0 Public Preview** (not `1.0.0`).
11
+ > Package architecture note: `causoryn` is a multi-file runtime package (`dist/mcp-server.mjs`
12
+ > + vendored N-API v10 `better-sqlite3` prebuild binaries + `dist/typescript-lib/` +
13
+ > `native/` sidecar workers + canonical `skills/`), not a single-file JS bundle.
14
+
15
+ ## Why Causoryn?
16
+
17
+ - **Zero LLM & zero API keys (`ADR-002`):** 100% deterministic static analysis — no embeddings, no token burn, no hallucinated call edges.
18
+ - **Evidence-backed & honest (`ADR-010`):** Every graph edge carries its exact resolution (`verified`, `heuristic`, `unresolved`) and source-span evidence ID.
19
+ - **Strictly read-only workspace (`ADR-008`):** Snapshots, SQLite indexes, and Living Wiki databases live outside your repository.
20
+ - **Fast on warm snapshots (1,000 TS files):** `11.8 ms` `workspace_summary`, `13.0 ms` `get_symbol_context`, `10.7 ms` `map_system` ([benchmarks](https://github.com/MrBekoX/Causoryn/blob/main/docs/en/benchmarks.md)).
21
+
22
+ ## Requirements & Component Runtime Matrix
23
+
24
+ | Component | Runtime Requirement | Compilation | Offline Behavior |
25
+ |---|---|---|---|
26
+ | **Core MCP server & SQLite** (`dist/mcp-server.mjs` + N-API v10 `better-sqlite3` prebuilds) | **Node.js >= 24** | Zero-compile | 100% offline |
27
+ | **TypeScript / JavaScript** (L2 + L3) | In-process TS Compiler API + bundled `dist/typescript-lib/lib*.d.ts` | Zero-compile | 100% offline |
28
+ | **C# / Roslyn** (L2 + L3) | **.NET 10 runtime** (`dotnet exec`) | Prebuilt deterministic Release Roslyn DLL (zero-compile) | 100% offline |
29
+ | **Python** (L2 + L3) | **Python 3.10+** (`python -B`, stdlib `ast`) | Zero-compile | 100% offline |
30
+ | **Go** (L1/heuristic + L3) | **Go 1.22+** (stdlib `go/parser`) | On-demand `go run` (or `CAUSORYN_GO_WORKER_BIN`) | 100% offline |
31
+ | **Rust** (L1/heuristic + L3) | **Rust / Cargo** (`syn` 2 sidecar) | On-demand `cargo build --locked` into `~/.causoryn/cache/rust-worker-target` | Cold build fetches 12 locked crates from `crates.io`; cached builds run offline |
32
+
33
+ If an optional language sidecar toolchain (`dotnet`, `python`, `go`, `cargo`) is unavailable
34
+ on a machine, Causoryn degrades gracefully and honestly to L0/L1 file-level provenance
35
+ (`npx causoryn@0.2.0 doctor` inspects sidecar readiness).
36
+
37
+ ---
38
+
39
+ ## Installation Across All 4 Supported Hosts
40
+
41
+ You can install Causoryn either via the **interactive/scriptable CLI wizard (`npx causoryn setup`)**
42
+ or via **each host's native Plugin Marketplace**.
43
+
44
+ ### Option A: One-Command CLI Setup (`npx causoryn setup`)
45
+
46
+ ```bash
47
+ # Preview planned changes without writing any files
48
+ npx causoryn@0.2.0 setup --all-detected --dry-run
49
+
50
+ # Configure all detected hosts on your machine (creates .causoryn.backup files and stages a persistent ~/.causoryn/runtime copy)
51
+ npx causoryn@0.2.0 setup --all-detected --yes
52
+
53
+ # Or target specific hosts explicitly
54
+ npx causoryn@0.2.0 setup --client antigravity --yes
55
+ npx causoryn@0.2.0 setup --client claude-code --yes
56
+ npx causoryn@0.2.0 setup --client codex --yes
57
+ npx causoryn@0.2.0 setup --client zcode --yes
58
+
59
+ # Verify installation health (read-only)
60
+ npx causoryn@0.2.0 doctor
61
+
62
+ # Cleanly remove Causoryn from a host (cleans up ~/.causoryn/runtime when no remaining host points to it)
63
+ npx causoryn@0.2.0 setup --client claude-code --uninstall --yes
64
+ ```
65
+
66
+ ### Option B: Native Host Plugin Marketplaces
67
+
68
+ 1. **Antigravity** (`agy` / Antigravity IDE):
69
+ - Add the repository (`https://github.com/MrBekoX/Causoryn`) or extracted `causoryn` plugin folder containing `plugin.json` and `mcp_config.json`, or run `npx causoryn@0.2.0 setup --client antigravity --yes` (writes `~/.gemini/config/mcp_config.json`, updates `~/.gemini/antigravity/mcp_config.json` when present, and installs the 4 skills into `~/.gemini/config/skills/`).
70
+ 2. **Claude Code**:
71
+ - In Claude Code, register the GitHub marketplace and install the plugin:
72
+ ```text
73
+ /plugin marketplace add MrBekoX/Causoryn
74
+ /plugin install causoryn@causoryn
75
+ ```
76
+ - Or run `npx causoryn@0.2.0 setup --client claude-code --yes` (`~/.claude.json` + `~/.claude/skills/`).
77
+ 3. **Codex** (Codex CLI / Desktop):
78
+ - Add the repository marketplace (`.agents/plugins/marketplace.json` + `.codex-plugin/plugin.json`) via Codex plugin management, or run `npx causoryn@0.2.0 setup --client codex --yes` (`$CODEX_HOME/config.toml` `[mcp_servers.causoryn]` with `startup_timeout_sec = 30` + `~/.agents/skills/`).
79
+ 4. **ZCode (GLM)**:
80
+ - Open **Plugin Marketplace -> New / Discover**, add `https://github.com/MrBekoX/Causoryn` (uses root `marketplace.json` and `.zcode-plugin/plugin.json`), and install `causoryn`.
81
+ - Or run `npx causoryn@0.2.0 setup --client zcode --yes` (writes `~/.zcode/cli/config.json` `mcp.servers.causoryn` while preserving any existing `~/.agents/mcp.json` fallback servers, plus `~/.zcode/skills/`).
82
+
83
+ ---
84
+
85
+ ## Read-Only Workspace & Zero-Config Authorization
86
+
87
+ - **Read-only workspace guarantee:** Causoryn never writes to your repository source tree (`ADR-008`). SQLite graph databases, Living Wiki stores, and exports are isolated under `~/.causoryn/workspaces/<slug>-<hash>/` (or `ZCODE_PLUGIN_DATA` / `--data-dir`).
88
+ - **Zero-config CLI flags (`--allow-cwd --auto-data-dir`):** When launched inside a safe project directory, `--allow-cwd` authorizes that project root automatically; when launched by a desktop IDE from `$HOME`, filesystem root, or the plugin cache directory, Causoryn rejects unsafe roots and dynamically binds the active workspace via MCP `roots/list` (`notifications/roots/list_changed`).
89
+ - **Explicit `CAUSORYN_CONFIG` (`allowRoots`):** Bare `node dist/mcp-server.mjs` without CLI flags preserves strict default-deny (`{"allowRoots":[]}`) until a project path such as `{"allowRoots":["/work/my-service"]}` is explicitly declared.
90
+
91
+ ---
92
+
93
+ ## Published MCP Tools (29 Tools — `TOOL_NAMES`)
94
+
95
+ Every tool advertised below is genuinely implemented and registered by the compiled server (`ADR-010`):
96
+
97
+ 1. `causoryn_get_capabilities` — Adapter levels (L0–L3), server limits, protocol version, and published tool list.
98
+ 2. `causoryn_workspace_summary` — Language, project, entrypoint, and edge-resolution summary of the published snapshot.
99
+ 3. `causoryn_index_status` — Background/completed indexing job status, snapshot freshness, and diagnostics.
100
+ 4. `causoryn_refresh_index` — Starts a full or incremental workspace indexing job into the external data root.
101
+ 5. `causoryn_map_system` — Paginated L0–L3 architecture hierarchy map with kind/path filters and cursor pagination.
102
+ 6. `causoryn_find_symbols` — Deterministic ranked symbol lookup with candidate disambiguation.
103
+ 7. `causoryn_get_symbol_context` — Neighborhood graph and source-span evidence around a symbol or node ID.
104
+ 8. `causoryn_trace_execution` — Bounded deterministic call/route chain tracing with per-edge resolution.
105
+ 9. `causoryn_trace_business_flow` — Cross-component business and contract flow tracing with honest `gap` reporting.
106
+ 10. `causoryn_analyze_impact` — Reverse-edge BFS blast-radius analysis keeping `certainty` and `resolution` separate.
107
+ 11. `causoryn_check_architecture` — Evaluates `.causoryn/architecture.rules.yaml` (`no-cycles` SCC + forbidden dependencies).
108
+ 12. `causoryn_compare_architecture` — Read-only git ref architectural comparison (`baseRef` vs `targetRef`).
109
+ 13. `causoryn_get_agent_context` — Ranked, budget-bounded context retrieval across symbol, graph, contract, and FTS legs.
110
+ 14. `causoryn_generate_onboarding` — Structural onboarding guide (entrypoints, high-centrality modules, SCC learning order).
111
+ 15. `causoryn_export_documentation` — Atomic documentation export (`json`, `markdown`, `mermaid`, `html`, `snapshot`) to `output.allowedOutputDirs`.
112
+ 16. `causoryn_preflight_change` — Candidate-only pre-change impact, contract, and test-plan manifest (`candidateOnly: true`).
113
+ 17. `causoryn_check_contracts` — Static compatibility classification across OpenAPI, AsyncAPI, JSON Schema, SQL, and Protobuf pairs.
114
+ 18. `causoryn_detect_contract_drift` — Revision-to-revision contract drift and producer/consumer anchor impact detection.
115
+ 19. `causoryn_verify_change` — Deterministic post-change verification across `architecture`, `contracts`, `graph-diff`, and `test-plan`.
116
+ 20. `causoryn_derive_test_plan` — Content-addressed (`testplan:<sha256>`) candidate test plan without executing tests.
117
+ 21. `causoryn_get_evidence` — Source file, line span, hash, and analyzer provenance lookup for nodes and edges.
118
+ 22. `causoryn_architecture_timeline` — Sampled multi-revision architectural evolution over read-only git history.
119
+ 23. `causoryn_wiki_build` — Projects the published graph snapshot into a deterministic Living Wiki SQLite snapshot (`wiki.dataDbPath`).
120
+ 24. `causoryn_wiki_get_tree` — Paginated 12-category Living Wiki taxonomy tree with freshness and coverage metadata.
121
+ 25. `causoryn_wiki_get_page` — Section-paginated Living Wiki page reader with `evidenceRefs` and `sourceRefs`.
122
+ 26. `causoryn_wiki_search` — Escaped multi-field FTS5 search over Living Wiki pages.
123
+ 27. `causoryn_wiki_get_links` — Outgoing links, reverse-indexed backlinks, and `brokenLinkDiagnostics`.
124
+ 28. `causoryn_wiki_get_versions` — Read-only git/snapshot version availability for Living Wiki pages.
125
+ 29. `causoryn_wiki_diff` — Structural diff (`changedSections`, `coverageDelta`, `contractChanges`) between two Living Wiki snapshots.
126
+
127
+ ---
128
+
129
+ ## Envelope Error Codes (`CAUSORYN_TOOL_ERROR_CODES` & Specification Catalog)
130
+
131
+ Active envelope error codes exported in `CAUSORYN_TOOL_ERROR_CODES` (15 codes):
132
+ - `WORKSPACE_NOT_AUTHORIZED`
133
+ - `PATH_DENIED`
134
+ - `INDEX_NOT_READY`
135
+ - `AMBIGUOUS_SYMBOL`
136
+ - `LIMIT_EXCEEDED`
137
+ - `INVALID_ARGUMENT`
138
+ - `EVIDENCE_NOT_FOUND`
139
+ - `SYMBOL_NOT_FOUND`
140
+ - `POLICY_INVALID`
141
+ - `INVALID_REVISION`
142
+ - `EXPORT_NOT_ALLOWED`
143
+ - `WIKI_PAGE_NOT_FOUND`
144
+ - `CONTRACT_PARSE_FAILED`
145
+ - `UNSUPPORTED_LANGUAGE`
146
+ - `INTERNAL_ERROR`
147
+
148
+ Reserved specification base identifiers not emitted as envelope errors in v0.2.0 (6 codes; 21 total catalog + extension identifiers):
149
+ - `UNRESOLVED_FLOW`
150
+ - `STALE_PREFLIGHT`
151
+ - `CANCELLED`
152
+ - `WIKI_REVISION_NOT_AVAILABLE`
153
+ - `WIKI_BROKEN_LINK`
154
+ - `WIKI_NOTE_CONFLICT`
155
+
156
+ ---
157
+
158
+ ## Documentation (English & Türkçe)
159
+
160
+ - **[English Documentation Hub](https://github.com/MrBekoX/Causoryn/blob/main/docs/en/README.md)** — [Architecture](https://github.com/MrBekoX/Causoryn/blob/main/docs/en/architecture.md) · [CLI & Configuration](https://github.com/MrBekoX/Causoryn/blob/main/docs/en/cli-and-configuration.md) · [5-Language Analyzers](https://github.com/MrBekoX/Causoryn/blob/main/docs/en/language-analyzers.md) · [MCP Tool Contracts](https://github.com/MrBekoX/Causoryn/blob/main/docs/en/tool-contracts.md) · [Compatibility Matrix](https://github.com/MrBekoX/Causoryn/blob/main/docs/en/compatibility-matrix.md)
161
+ - **[Türkçe Dokümantasyon Merkezi](https://github.com/MrBekoX/Causoryn/blob/main/docs/README.md)** — [Mimari Özeti](https://github.com/MrBekoX/Causoryn/blob/main/docs/architecture.md) · [CLI ve Konfigürasyon](https://github.com/MrBekoX/Causoryn/blob/main/docs/cli-and-configuration.md) · [5-Dil Analizörleri](https://github.com/MrBekoX/Causoryn/blob/main/docs/language-analyzers.md) · [MCP Araç Sözleşmeleri](https://github.com/MrBekoX/Causoryn/blob/main/docs/tool-contracts.md) · [Uyumluluk Matrisi](https://github.com/MrBekoX/Causoryn/blob/main/docs/compatibility-matrix.md)
162
+ - **[Bilingual Architecture & Project Overview (TR · EN)](https://github.com/MrBekoX/Causoryn/blob/main/docs/project-overview.tr-en.md)**
163
+
164
+ ---
165
+
166
+ ## Governance, Security & License
167
+
168
+ - **Security policy:** [SECURITY.md](https://github.com/MrBekoX/Causoryn/blob/main/SECURITY.md)
169
+ - **Contributing:** [CONTRIBUTING.md](https://github.com/MrBekoX/Causoryn/blob/main/CONTRIBUTING.md)
170
+ - **Code of Conduct:** [CODE_OF_CONDUCT.md](https://github.com/MrBekoX/Causoryn/blob/main/CODE_OF_CONDUCT.md)
171
+ - **Third-party notices:** `THIRD-PARTY-NOTICES.md` (included in package)
172
+ - **License:** [MIT](LICENSE)