@zvec/zvec-grep 0.2.1 → 0.3.0-rc.1

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 (406) hide show
  1. package/README.md +87 -238
  2. package/bin/zg.exe +3 -0
  3. package/install.cjs +510 -0
  4. package/package.json +22 -72
  5. package/platforms.json +92 -0
  6. package/plugins.cjs +183 -0
  7. package/README_CN.md +0 -230
  8. package/dist/authorization/index.d.ts +0 -7
  9. package/dist/authorization/index.js +0 -7
  10. package/dist/authorization/index.js.map +0 -1
  11. package/dist/authorization/manager.d.ts +0 -8
  12. package/dist/authorization/manager.js +0 -19
  13. package/dist/authorization/manager.js.map +0 -1
  14. package/dist/authorization/operation.d.ts +0 -7
  15. package/dist/authorization/operation.js +0 -50
  16. package/dist/authorization/operation.js.map +0 -1
  17. package/dist/authorization/planner.d.ts +0 -21
  18. package/dist/authorization/planner.js +0 -97
  19. package/dist/authorization/planner.js.map +0 -1
  20. package/dist/authorization/prompt.d.ts +0 -12
  21. package/dist/authorization/prompt.js +0 -63
  22. package/dist/authorization/prompt.js.map +0 -1
  23. package/dist/authorization/store.d.ts +0 -20
  24. package/dist/authorization/store.js +0 -251
  25. package/dist/authorization/store.js.map +0 -1
  26. package/dist/authorization/target.d.ts +0 -15
  27. package/dist/authorization/target.js +0 -49
  28. package/dist/authorization/target.js.map +0 -1
  29. package/dist/authorization/types.d.ts +0 -61
  30. package/dist/authorization/types.js +0 -2
  31. package/dist/authorization/types.js.map +0 -1
  32. package/dist/cli/args.d.ts +0 -5
  33. package/dist/cli/args.js +0 -1207
  34. package/dist/cli/args.js.map +0 -1
  35. package/dist/cli/auth.d.ts +0 -21
  36. package/dist/cli/auth.js +0 -209
  37. package/dist/cli/auth.js.map +0 -1
  38. package/dist/cli/commands.d.ts +0 -4
  39. package/dist/cli/commands.js +0 -697
  40. package/dist/cli/commands.js.map +0 -1
  41. package/dist/cli/errors.d.ts +0 -6
  42. package/dist/cli/errors.js +0 -98
  43. package/dist/cli/errors.js.map +0 -1
  44. package/dist/cli/format/context.d.ts +0 -9
  45. package/dist/cli/format/context.js +0 -786
  46. package/dist/cli/format/context.js.map +0 -1
  47. package/dist/cli/format/debug.d.ts +0 -4
  48. package/dist/cli/format/debug.js +0 -60
  49. package/dist/cli/format/debug.js.map +0 -1
  50. package/dist/cli/format/highlight.d.ts +0 -3
  51. package/dist/cli/format/highlight.js +0 -106
  52. package/dist/cli/format/highlight.js.map +0 -1
  53. package/dist/cli/format/progress.d.ts +0 -13
  54. package/dist/cli/format/progress.js +0 -290
  55. package/dist/cli/format/progress.js.map +0 -1
  56. package/dist/cli/format/range.d.ts +0 -3
  57. package/dist/cli/format/range.js +0 -24
  58. package/dist/cli/format/range.js.map +0 -1
  59. package/dist/cli/format/status.d.ts +0 -81
  60. package/dist/cli/format/status.js +0 -512
  61. package/dist/cli/format/status.js.map +0 -1
  62. package/dist/cli/help.d.ts +0 -1
  63. package/dist/cli/help.js +0 -524
  64. package/dist/cli/help.js.map +0 -1
  65. package/dist/cli/index.d.ts +0 -2
  66. package/dist/cli/index.js +0 -32
  67. package/dist/cli/index.js.map +0 -1
  68. package/dist/cli/install.d.ts +0 -4
  69. package/dist/cli/install.js +0 -1661
  70. package/dist/cli/install.js.map +0 -1
  71. package/dist/cli/managed-rg.d.ts +0 -10
  72. package/dist/cli/managed-rg.js +0 -329
  73. package/dist/cli/managed-rg.js.map +0 -1
  74. package/dist/cli/server-search.d.ts +0 -3
  75. package/dist/cli/server-search.js +0 -12
  76. package/dist/cli/server-search.js.map +0 -1
  77. package/dist/cli/types.d.ts +0 -87
  78. package/dist/cli/types.js +0 -10
  79. package/dist/cli/types.js.map +0 -1
  80. package/dist/cli/version.d.ts +0 -1
  81. package/dist/cli/version.js +0 -13
  82. package/dist/cli/version.js.map +0 -1
  83. package/dist/client/daemon-client.d.ts +0 -31
  84. package/dist/client/daemon-client.js +0 -203
  85. package/dist/client/daemon-client.js.map +0 -1
  86. package/dist/client/mode-router.d.ts +0 -9
  87. package/dist/client/mode-router.js +0 -28
  88. package/dist/client/mode-router.js.map +0 -1
  89. package/dist/client/search-policy.d.ts +0 -11
  90. package/dist/client/search-policy.js +0 -15
  91. package/dist/client/search-policy.js.map +0 -1
  92. package/dist/daemon/backend.d.ts +0 -78
  93. package/dist/daemon/backend.js +0 -1085
  94. package/dist/daemon/backend.js.map +0 -1
  95. package/dist/daemon/change-set.d.ts +0 -30
  96. package/dist/daemon/change-set.js +0 -163
  97. package/dist/daemon/change-set.js.map +0 -1
  98. package/dist/daemon/config.d.ts +0 -24
  99. package/dist/daemon/config.js +0 -88
  100. package/dist/daemon/config.js.map +0 -1
  101. package/dist/daemon/errors.d.ts +0 -5
  102. package/dist/daemon/errors.js +0 -11
  103. package/dist/daemon/errors.js.map +0 -1
  104. package/dist/daemon/http-server.d.ts +0 -30
  105. package/dist/daemon/http-server.js +0 -288
  106. package/dist/daemon/http-server.js.map +0 -1
  107. package/dist/daemon/index-coordinator.d.ts +0 -22
  108. package/dist/daemon/index-coordinator.js +0 -55
  109. package/dist/daemon/index-coordinator.js.map +0 -1
  110. package/dist/daemon/job-scheduler.d.ts +0 -70
  111. package/dist/daemon/job-scheduler.js +0 -366
  112. package/dist/daemon/job-scheduler.js.map +0 -1
  113. package/dist/daemon/logger.d.ts +0 -9
  114. package/dist/daemon/logger.js +0 -53
  115. package/dist/daemon/logger.js.map +0 -1
  116. package/dist/daemon/model-pool.d.ts +0 -45
  117. package/dist/daemon/model-pool.js +0 -187
  118. package/dist/daemon/model-pool.js.map +0 -1
  119. package/dist/daemon/root-lease.d.ts +0 -14
  120. package/dist/daemon/root-lease.js +0 -188
  121. package/dist/daemon/root-lease.js.map +0 -1
  122. package/dist/daemon/root-runtime.d.ts +0 -79
  123. package/dist/daemon/root-runtime.js +0 -337
  124. package/dist/daemon/root-runtime.js.map +0 -1
  125. package/dist/daemon/runtime-manager.d.ts +0 -46
  126. package/dist/daemon/runtime-manager.js +0 -246
  127. package/dist/daemon/runtime-manager.js.map +0 -1
  128. package/dist/daemon/runtime.d.ts +0 -12
  129. package/dist/daemon/runtime.js +0 -102
  130. package/dist/daemon/runtime.js.map +0 -1
  131. package/dist/daemon/server-controller.d.ts +0 -39
  132. package/dist/daemon/server-controller.js +0 -327
  133. package/dist/daemon/server-controller.js.map +0 -1
  134. package/dist/daemon/watch-manager.d.ts +0 -55
  135. package/dist/daemon/watch-manager.js +0 -340
  136. package/dist/daemon/watch-manager.js.map +0 -1
  137. package/dist/daemon/workspace-read-session-cache.d.ts +0 -31
  138. package/dist/daemon/workspace-read-session-cache.js +0 -115
  139. package/dist/daemon/workspace-read-session-cache.js.map +0 -1
  140. package/dist/engine/code-formats.d.ts +0 -3
  141. package/dist/engine/code-formats.js +0 -14
  142. package/dist/engine/code-formats.js.map +0 -1
  143. package/dist/engine/config.d.ts +0 -50
  144. package/dist/engine/config.js +0 -321
  145. package/dist/engine/config.js.map +0 -1
  146. package/dist/engine/errors.d.ts +0 -19
  147. package/dist/engine/errors.js +0 -40
  148. package/dist/engine/errors.js.map +0 -1
  149. package/dist/engine/extraction/code/adapter.d.ts +0 -19
  150. package/dist/engine/extraction/code/adapter.js +0 -24
  151. package/dist/engine/extraction/code/adapter.js.map +0 -1
  152. package/dist/engine/extraction/code/extractor.d.ts +0 -13
  153. package/dist/engine/extraction/code/extractor.js +0 -696
  154. package/dist/engine/extraction/code/extractor.js.map +0 -1
  155. package/dist/engine/extraction/code/families/c-family.d.ts +0 -2
  156. package/dist/engine/extraction/code/families/c-family.js +0 -122
  157. package/dist/engine/extraction/code/families/c-family.js.map +0 -1
  158. package/dist/engine/extraction/code/families/js-ts.d.ts +0 -12
  159. package/dist/engine/extraction/code/families/js-ts.js +0 -118
  160. package/dist/engine/extraction/code/families/js-ts.js.map +0 -1
  161. package/dist/engine/extraction/code/families/metadata.d.ts +0 -8
  162. package/dist/engine/extraction/code/families/metadata.js +0 -86
  163. package/dist/engine/extraction/code/families/metadata.js.map +0 -1
  164. package/dist/engine/extraction/code/families/name-field.d.ts +0 -3
  165. package/dist/engine/extraction/code/families/name-field.js +0 -22
  166. package/dist/engine/extraction/code/families/name-field.js.map +0 -1
  167. package/dist/engine/extraction/code/languages/c.d.ts +0 -1
  168. package/dist/engine/extraction/code/languages/c.js +0 -12
  169. package/dist/engine/extraction/code/languages/c.js.map +0 -1
  170. package/dist/engine/extraction/code/languages/cpp.d.ts +0 -1
  171. package/dist/engine/extraction/code/languages/cpp.js +0 -18
  172. package/dist/engine/extraction/code/languages/cpp.js.map +0 -1
  173. package/dist/engine/extraction/code/languages/go.d.ts +0 -2
  174. package/dist/engine/extraction/code/languages/go.js +0 -70
  175. package/dist/engine/extraction/code/languages/go.js.map +0 -1
  176. package/dist/engine/extraction/code/languages/java.d.ts +0 -1
  177. package/dist/engine/extraction/code/languages/java.js +0 -17
  178. package/dist/engine/extraction/code/languages/java.js.map +0 -1
  179. package/dist/engine/extraction/code/languages/javascript.d.ts +0 -2
  180. package/dist/engine/extraction/code/languages/javascript.js +0 -23
  181. package/dist/engine/extraction/code/languages/javascript.js.map +0 -1
  182. package/dist/engine/extraction/code/languages/python.d.ts +0 -2
  183. package/dist/engine/extraction/code/languages/python.js +0 -52
  184. package/dist/engine/extraction/code/languages/python.js.map +0 -1
  185. package/dist/engine/extraction/code/languages/rust.d.ts +0 -2
  186. package/dist/engine/extraction/code/languages/rust.js +0 -25
  187. package/dist/engine/extraction/code/languages/rust.js.map +0 -1
  188. package/dist/engine/extraction/code/languages/typescript.d.ts +0 -2
  189. package/dist/engine/extraction/code/languages/typescript.js +0 -37
  190. package/dist/engine/extraction/code/languages/typescript.js.map +0 -1
  191. package/dist/engine/extraction/code/tree-sitter/grammar.d.ts +0 -4
  192. package/dist/engine/extraction/code/tree-sitter/grammar.js +0 -49
  193. package/dist/engine/extraction/code/tree-sitter/grammar.js.map +0 -1
  194. package/dist/engine/extraction/code/tree-sitter/nodes.d.ts +0 -3
  195. package/dist/engine/extraction/code/tree-sitter/nodes.js +0 -27
  196. package/dist/engine/extraction/code/tree-sitter/nodes.js.map +0 -1
  197. package/dist/engine/extraction/code/tree-sitter/parser.d.ts +0 -2
  198. package/dist/engine/extraction/code/tree-sitter/parser.js +0 -31
  199. package/dist/engine/extraction/code/tree-sitter/parser.js.map +0 -1
  200. package/dist/engine/extraction/ids.d.ts +0 -1
  201. package/dist/engine/extraction/ids.js +0 -5
  202. package/dist/engine/extraction/ids.js.map +0 -1
  203. package/dist/engine/extraction/image/extractor.d.ts +0 -5
  204. package/dist/engine/extraction/image/extractor.js +0 -35
  205. package/dist/engine/extraction/image/extractor.js.map +0 -1
  206. package/dist/engine/extraction/index.d.ts +0 -4
  207. package/dist/engine/extraction/index.js +0 -3
  208. package/dist/engine/extraction/index.js.map +0 -1
  209. package/dist/engine/extraction/markdown/extractor.d.ts +0 -7
  210. package/dist/engine/extraction/markdown/extractor.js +0 -362
  211. package/dist/engine/extraction/markdown/extractor.js.map +0 -1
  212. package/dist/engine/extraction/runtime.d.ts +0 -9
  213. package/dist/engine/extraction/runtime.js +0 -37
  214. package/dist/engine/extraction/runtime.js.map +0 -1
  215. package/dist/engine/extraction/source.d.ts +0 -18
  216. package/dist/engine/extraction/source.js +0 -22
  217. package/dist/engine/extraction/source.js.map +0 -1
  218. package/dist/engine/extraction/text/extractor.d.ts +0 -7
  219. package/dist/engine/extraction/text/extractor.js +0 -168
  220. package/dist/engine/extraction/text/extractor.js.map +0 -1
  221. package/dist/engine/extraction/types.d.ts +0 -4
  222. package/dist/engine/extraction/types.js +0 -2
  223. package/dist/engine/extraction/types.js.map +0 -1
  224. package/dist/engine/extraction/vector-content.d.ts +0 -5
  225. package/dist/engine/extraction/vector-content.js +0 -83
  226. package/dist/engine/extraction/vector-content.js.map +0 -1
  227. package/dist/engine/file-size-policy.d.ts +0 -6
  228. package/dist/engine/file-size-policy.js +0 -20
  229. package/dist/engine/file-size-policy.js.map +0 -1
  230. package/dist/engine/file-type.d.ts +0 -15
  231. package/dist/engine/file-type.js +0 -152
  232. package/dist/engine/file-type.js.map +0 -1
  233. package/dist/engine/index-status.d.ts +0 -9
  234. package/dist/engine/index-status.js +0 -38
  235. package/dist/engine/index-status.js.map +0 -1
  236. package/dist/engine/manifest.d.ts +0 -13
  237. package/dist/engine/manifest.js +0 -124
  238. package/dist/engine/manifest.js.map +0 -1
  239. package/dist/engine/models/backends/llama-cpp.d.ts +0 -99
  240. package/dist/engine/models/backends/llama-cpp.js +0 -511
  241. package/dist/engine/models/backends/llama-cpp.js.map +0 -1
  242. package/dist/engine/models/backends/model2vec-runtime.d.ts +0 -63
  243. package/dist/engine/models/backends/model2vec-runtime.js +0 -112
  244. package/dist/engine/models/backends/model2vec-runtime.js.map +0 -1
  245. package/dist/engine/models/backends/model2vec-tokenizer.d.ts +0 -2
  246. package/dist/engine/models/backends/model2vec-tokenizer.js +0 -42
  247. package/dist/engine/models/backends/model2vec-tokenizer.js.map +0 -1
  248. package/dist/engine/models/backends/model2vec-worker-pool.d.ts +0 -25
  249. package/dist/engine/models/backends/model2vec-worker-pool.js +0 -264
  250. package/dist/engine/models/backends/model2vec-worker-pool.js.map +0 -1
  251. package/dist/engine/models/backends/model2vec-worker.d.ts +0 -1
  252. package/dist/engine/models/backends/model2vec-worker.js +0 -41
  253. package/dist/engine/models/backends/model2vec-worker.js.map +0 -1
  254. package/dist/engine/models/backends/model2vec.d.ts +0 -40
  255. package/dist/engine/models/backends/model2vec.js +0 -311
  256. package/dist/engine/models/backends/model2vec.js.map +0 -1
  257. package/dist/engine/models/backends/qwen.d.ts +0 -44
  258. package/dist/engine/models/backends/qwen.js +0 -411
  259. package/dist/engine/models/backends/qwen.js.map +0 -1
  260. package/dist/engine/models/backends/transformers-js.d.ts +0 -87
  261. package/dist/engine/models/backends/transformers-js.js +0 -316
  262. package/dist/engine/models/backends/transformers-js.js.map +0 -1
  263. package/dist/engine/models/catalog.d.ts +0 -231
  264. package/dist/engine/models/catalog.js +0 -218
  265. package/dist/engine/models/catalog.js.map +0 -1
  266. package/dist/engine/models/download-progress.d.ts +0 -15
  267. package/dist/engine/models/download-progress.js +0 -48
  268. package/dist/engine/models/download-progress.js.map +0 -1
  269. package/dist/engine/models/embeddings.d.ts +0 -67
  270. package/dist/engine/models/embeddings.js +0 -125
  271. package/dist/engine/models/embeddings.js.map +0 -1
  272. package/dist/engine/models/factory.d.ts +0 -2
  273. package/dist/engine/models/factory.js +0 -51
  274. package/dist/engine/models/factory.js.map +0 -1
  275. package/dist/engine/models/index.d.ts +0 -4
  276. package/dist/engine/models/index.js +0 -5
  277. package/dist/engine/models/index.js.map +0 -1
  278. package/dist/engine/models/ranking.d.ts +0 -19
  279. package/dist/engine/models/ranking.js +0 -2
  280. package/dist/engine/models/ranking.js.map +0 -1
  281. package/dist/engine/models/resolution.d.ts +0 -8
  282. package/dist/engine/models/resolution.js +0 -22
  283. package/dist/engine/models/resolution.js.map +0 -1
  284. package/dist/engine/pipeline/indexing/index.d.ts +0 -14
  285. package/dist/engine/pipeline/indexing/index.js +0 -1061
  286. package/dist/engine/pipeline/indexing/index.js.map +0 -1
  287. package/dist/engine/pipeline/indexing/input-budget.d.ts +0 -2
  288. package/dist/engine/pipeline/indexing/input-budget.js +0 -51
  289. package/dist/engine/pipeline/indexing/input-budget.js.map +0 -1
  290. package/dist/engine/pipeline/indexing/root-paths.d.ts +0 -7
  291. package/dist/engine/pipeline/indexing/root-paths.js +0 -148
  292. package/dist/engine/pipeline/indexing/root-paths.js.map +0 -1
  293. package/dist/engine/pipeline/indexing/scanner/index.d.ts +0 -14
  294. package/dist/engine/pipeline/indexing/scanner/index.js +0 -776
  295. package/dist/engine/pipeline/indexing/scanner/index.js.map +0 -1
  296. package/dist/engine/pipeline/search/index.d.ts +0 -12
  297. package/dist/engine/pipeline/search/index.js +0 -811
  298. package/dist/engine/pipeline/search/index.js.map +0 -1
  299. package/dist/engine/service/index.d.ts +0 -3
  300. package/dist/engine/service/index.js +0 -2
  301. package/dist/engine/service/index.js.map +0 -1
  302. package/dist/engine/service/lexical.d.ts +0 -28
  303. package/dist/engine/service/lexical.js +0 -446
  304. package/dist/engine/service/lexical.js.map +0 -1
  305. package/dist/engine/service/root.d.ts +0 -15
  306. package/dist/engine/service/root.js +0 -57
  307. package/dist/engine/service/root.js.map +0 -1
  308. package/dist/engine/service/structure-enrichment.d.ts +0 -8
  309. package/dist/engine/service/structure-enrichment.js +0 -178
  310. package/dist/engine/service/structure-enrichment.js.map +0 -1
  311. package/dist/engine/service/types.d.ts +0 -210
  312. package/dist/engine/service/types.js +0 -2
  313. package/dist/engine/service/types.js.map +0 -1
  314. package/dist/engine/service/workspace-index.d.ts +0 -26
  315. package/dist/engine/service/workspace-index.js +0 -157
  316. package/dist/engine/service/workspace-index.js.map +0 -1
  317. package/dist/engine/service/zvec-grep.d.ts +0 -13
  318. package/dist/engine/service/zvec-grep.js +0 -1393
  319. package/dist/engine/service/zvec-grep.js.map +0 -1
  320. package/dist/engine/storage/index.d.ts +0 -53
  321. package/dist/engine/storage/index.js +0 -3
  322. package/dist/engine/storage/index.js.map +0 -1
  323. package/dist/engine/storage/layout.d.ts +0 -10
  324. package/dist/engine/storage/layout.js +0 -29
  325. package/dist/engine/storage/layout.js.map +0 -1
  326. package/dist/engine/storage/zvec.d.ts +0 -4
  327. package/dist/engine/storage/zvec.js +0 -976
  328. package/dist/engine/storage/zvec.js.map +0 -1
  329. package/dist/engine/types.d.ts +0 -303
  330. package/dist/engine/types.js +0 -14
  331. package/dist/engine/types.js.map +0 -1
  332. package/dist/engine/utils/daemon-lease.d.ts +0 -17
  333. package/dist/engine/utils/daemon-lease.js +0 -175
  334. package/dist/engine/utils/daemon-lease.js.map +0 -1
  335. package/dist/engine/utils/file-selection.d.ts +0 -10
  336. package/dist/engine/utils/file-selection.js +0 -157
  337. package/dist/engine/utils/file-selection.js.map +0 -1
  338. package/dist/engine/utils/glob.d.ts +0 -9
  339. package/dist/engine/utils/glob.js +0 -208
  340. package/dist/engine/utils/glob.js.map +0 -1
  341. package/dist/engine/utils/hash.d.ts +0 -2
  342. package/dist/engine/utils/hash.js +0 -8
  343. package/dist/engine/utils/hash.js.map +0 -1
  344. package/dist/engine/utils/json.d.ts +0 -8
  345. package/dist/engine/utils/json.js +0 -83
  346. package/dist/engine/utils/json.js.map +0 -1
  347. package/dist/engine/utils/lock.d.ts +0 -19
  348. package/dist/engine/utils/lock.js +0 -254
  349. package/dist/engine/utils/lock.js.map +0 -1
  350. package/dist/engine/utils/path.d.ts +0 -4
  351. package/dist/engine/utils/path.js +0 -18
  352. package/dist/engine/utils/path.js.map +0 -1
  353. package/dist/engine/utils/timing.d.ts +0 -19
  354. package/dist/engine/utils/timing.js +0 -87
  355. package/dist/engine/utils/timing.js.map +0 -1
  356. package/dist/index-progress.d.ts +0 -10
  357. package/dist/index-progress.js +0 -159
  358. package/dist/index-progress.js.map +0 -1
  359. package/dist/index.d.ts +0 -6
  360. package/dist/index.js +0 -4
  361. package/dist/index.js.map +0 -1
  362. package/dist/mcp/http-transport.d.ts +0 -27
  363. package/dist/mcp/http-transport.js +0 -182
  364. package/dist/mcp/http-transport.js.map +0 -1
  365. package/dist/mcp/input-normalization.d.ts +0 -38
  366. package/dist/mcp/input-normalization.js +0 -104
  367. package/dist/mcp/input-normalization.js.map +0 -1
  368. package/dist/mcp/progress-heartbeat.d.ts +0 -17
  369. package/dist/mcp/progress-heartbeat.js +0 -46
  370. package/dist/mcp/progress-heartbeat.js.map +0 -1
  371. package/dist/mcp/request-metadata.d.ts +0 -2
  372. package/dist/mcp/request-metadata.js +0 -11
  373. package/dist/mcp/request-metadata.js.map +0 -1
  374. package/dist/mcp/request-state.d.ts +0 -40
  375. package/dist/mcp/request-state.js +0 -210
  376. package/dist/mcp/request-state.js.map +0 -1
  377. package/dist/mcp/result-format.d.ts +0 -13
  378. package/dist/mcp/result-format.js +0 -75
  379. package/dist/mcp/result-format.js.map +0 -1
  380. package/dist/mcp/schemas.d.ts +0 -664
  381. package/dist/mcp/schemas.js +0 -510
  382. package/dist/mcp/schemas.js.map +0 -1
  383. package/dist/mcp/stdio-bridge.d.ts +0 -14
  384. package/dist/mcp/stdio-bridge.js +0 -178
  385. package/dist/mcp/stdio-bridge.js.map +0 -1
  386. package/dist/mcp/tools.d.ts +0 -153
  387. package/dist/mcp/tools.js +0 -482
  388. package/dist/mcp/tools.js.map +0 -1
  389. package/dist/mcp/toolset.d.ts +0 -5
  390. package/dist/mcp/toolset.js +0 -12
  391. package/dist/mcp/toolset.js.map +0 -1
  392. package/dist/observability/trace-context.d.ts +0 -11
  393. package/dist/observability/trace-context.js +0 -138
  394. package/dist/observability/trace-context.js.map +0 -1
  395. package/dist/prompts/zvec-grep-guidance.d.ts +0 -2
  396. package/dist/prompts/zvec-grep-guidance.js +0 -9
  397. package/dist/prompts/zvec-grep-guidance.js.map +0 -1
  398. package/docs/01-agents.md +0 -209
  399. package/docs/02-cli.md +0 -246
  400. package/docs/03-mcp.md +0 -185
  401. package/docs/04-pipeline.md +0 -226
  402. package/docs/05-architecture.md +0 -86
  403. package/docs/06-server.md +0 -220
  404. package/docs/07-embedding.md +0 -203
  405. package/docs/08-roadmap.md +0 -85
  406. package/docs/README.md +0 -53
package/dist/cli/help.js DELETED
@@ -1,524 +0,0 @@
1
- import { COMPONENT_CODE_FORMATS, STRUCTURED_CODE_FORMATS, } from "../engine/code-formats.js";
2
- import { resolveMaxFileSizeBytes } from "../engine/file-size-policy.js";
3
- import { listKnownBinaryExtensionGroups, listRecognizedFileTypes, } from "../engine/file-type.js";
4
- import { listEmbeddingModels } from "../engine/models/index.js";
5
- export function printHelp(version, topic) {
6
- if (!topic) {
7
- console.log(mainHelp(version));
8
- return;
9
- }
10
- const help = commandHelp(topic);
11
- if (!help) {
12
- throw new Error(`Unknown help topic: ${topic}`);
13
- }
14
- console.log(help);
15
- }
16
- const ENVIRONMENT_VARIABLES = {
17
- ZVEC_GREP_HOME: "Runtime and daemon state directory; Workspace indexes stay under <root>/.zvec-grep",
18
- ZVEC_GREP_MODE: "Default client mode: direct, server, or auto",
19
- ZVEC_GREP_SERVER_URL: "MCP server URL used by CLI clients",
20
- ZVEC_GREP_SERVER_TOKEN: "Server/client Bearer token",
21
- ZVEC_GREP_SERVER_TOKEN_FILE: "File containing the Server/client Bearer token",
22
- ZVEC_GREP_MCP_TOOLSET: "Server MCP surface: agent or full",
23
- ZVEC_GREP_EMBEDDING: "Default model for new indexes and auth grant",
24
- ZVEC_GREP_API_KEY: "Embedding provider credential fallback",
25
- ZVEC_GREP_ENDPOINT: "Remote Embedding endpoint fallback",
26
- ZVEC_GREP_MODEL_CACHE: "Local embedding model cache directory",
27
- ZVEC_GREP_DEVICE: "Local embedding device: auto, cpu, metal, vulkan, or cuda",
28
- DASHSCOPE_API_KEY: "Qwen credential fallback after ZVEC_GREP_API_KEY",
29
- QWEN_API_KEY: "Qwen credential fallback after DASHSCOPE_API_KEY",
30
- ZVEC_GREP_AUTHORIZATION_KEY_FILE: "Workspace grant signing-key file (advanced)",
31
- ZVEC_GREP_METAL_KEEP_RESIDENCY: "Set to 1 to keep llama.cpp Metal residency enabled (advanced)",
32
- ZVEC_GREP_LLAMA_CONTEXT_PARALLELISM: "Positive llama.cpp context parallelism override (advanced)",
33
- NO_COLOR: "Disable terminal colors",
34
- CODEX_HOME: "Codex configuration directory used by zg install",
35
- CLAUDE_CONFIG_DIR: "Claude configuration directory used by zg install",
36
- QWEN_HOME: "Qwen Code configuration directory used by zg install",
37
- QODER_CONFIG_DIR: "Qoder CLI configuration directory used by zg install",
38
- QODER_IDE_MCP_PATH: "Full Qoder IDE mcp.json path used by zg install",
39
- QODER_IDE_EXECUTABLE: "Qoder IDE executable used by automatic install-target detection",
40
- OPENCODE_CONFIG: "OpenCode configuration file used by zg install",
41
- CURSOR_CONFIG_DIR: "Cursor configuration directory used by zg install",
42
- };
43
- const MAIN_ENVIRONMENT_VARIABLES = [
44
- "ZVEC_GREP_HOME",
45
- "ZVEC_GREP_MODE",
46
- "ZVEC_GREP_EMBEDDING",
47
- "ZVEC_GREP_API_KEY",
48
- "ZVEC_GREP_SERVER_URL",
49
- ];
50
- function mainHelp(version) {
51
- return `zvec-grep ${version}
52
-
53
- Usage:
54
- zg <command> [options]
55
-
56
- Commands:
57
- query Search indexed context or run managed ripgrep
58
- index Build, rebuild, or drop the workspace index
59
- status Show workspace and index status
60
- config Configure provider credentials and embedding model defaults
61
- auth Manage Workspace Remote Embedding authorization
62
- server Start, stop, inspect, or run the shared MCP server
63
- install Install agent integrations
64
- uninstall Remove agent integrations
65
- help Show help for a command or topic
66
- version Print the installed version
67
-
68
- Examples:
69
- zg query "where authentication is validated"
70
- zg query --fts "AuthService"
71
- zg query --rg -F "AuthService" src
72
- zg index --embedding local/potion-code-16m-v2
73
- zg status
74
- zg auth status
75
- zg server on
76
- zg config model set local/potion-code-16m-v2 --device metal
77
- zg install
78
-
79
- Environment:
80
- ${formatEnvironmentVariables(MAIN_ENVIRONMENT_VARIABLES)}
81
-
82
- Run zg help models or zg help file-types for supported indexing capabilities.
83
- Run zg help environment for all variables, scopes, aliases, and precedence.
84
- Run zg help <command> or zg <command> --help for command-specific help.
85
- Use zg -h/--help for this page and zg -v/--version for the version.`;
86
- }
87
- function commandHelp(topic) {
88
- switch (topic) {
89
- case "query":
90
- return `Usage:
91
- zg query <query> [options]
92
- zg query --hybrid <query> --fts <query> --vector <query> [--fuse]
93
- zg query --rg [rg-options] <pattern> [path...]
94
-
95
- Search routes:
96
- positional query Hybrid FTS and vector search
97
- --hybrid <query> Add an explicit hybrid query
98
- --fts <query> Add an exact/lexical query
99
- --vector <query> Add a semantic/vector query
100
- --fuse Fuse all query groups into one ranked list
101
- --rg Run exhaustive managed ripgrep
102
-
103
- Result options:
104
- --limit <n> Maximum results per group (default: 7)
105
- --human Human-readable output (default: agent markdown)
106
- --preview <none|short|full> Indexed preview size (default: none; --human: full)
107
- --debug Print diagnostics to stderr
108
- --trace Include per-hit indexed search trace
109
- --refresh <background|wait|off> Refresh policy (defaults: server=background, direct=off)
110
- In direct mode, background warns and falls back to off
111
- --mode <direct|server|auto> Select indexed query transport (default: auto)
112
-
113
- Indexed results are shown by query group, preserving each group's own rank.
114
- A result that matches more than one group is shown in each matching group.
115
-
116
- Embedding runtime:
117
- --api-key <key> Embedding provider API key
118
- --model-cache <path> Local model cache directory
119
- --device <device> auto, cpu, metal, vulkan, cuda
120
- --allow-remote Allow Remote Embedding for this command only
121
-
122
- File filters:
123
- -g, --glob <glob> Include paths; prefix with ! to exclude; repeatable
124
- --iglob <glob> Case-insensitive path glob; repeatable
125
- -t, --type <type> Include a ripgrep file type; repeatable
126
- -T, --type-not <type> Exclude a ripgrep file type; repeatable
127
- --modified-after <time> Only files modified after a date or epoch milliseconds
128
- --modified-before <time> Only files modified before a date or epoch milliseconds
129
- --symbol-type <type> module, class, interface, function, value, alias
130
- --prefer-symbol Prefer exact indexed symbols
131
-
132
- Managed --rg supports common ripgrep matching, context, engine, encoding,
133
- discovery, glob, and type flags. Use -e when a pattern begins with "-".
134
- Options that replace rg's output format are rejected.
135
-
136
- Environment:
137
- ${formatEnvironmentVariables([
138
- "ZVEC_GREP_MODE",
139
- "ZVEC_GREP_API_KEY",
140
- "ZVEC_GREP_ENDPOINT",
141
- "ZVEC_GREP_MODEL_CACHE",
142
- "ZVEC_GREP_DEVICE",
143
- ])}
144
-
145
- See zg help environment for precedence and Server-mode scope.`;
146
- case "index":
147
- return `Usage:
148
- zg index [root] [options]
149
- zg index [root] --rebuild [options]
150
- zg index [root] --drop [--yes]
151
-
152
- Index options:
153
- --rebuild Rebuild the existing index
154
- --drop Permanently remove the workspace index
155
- --yes Confirm --drop without prompting
156
- --debug Print skipped-file diagnostics to stderr
157
- --mode <direct|server|auto> Select indexing transport
158
-
159
- Embedding options:
160
- --embedding <model> Model such as local/potion-code-16m-v2 or qwen/text-embedding-v4
161
- --api-key <key> Embedding provider API key
162
- --endpoint <url> Embedding provider endpoint
163
- --model-cache <path> Local model cache directory
164
- --device <device> auto, cpu, metal, vulkan, cuda
165
- --embedding-concurrency <n> Embedding task concurrency
166
- --allow-remote Allow Remote Embedding for this command only
167
-
168
- File selection:
169
- -g, --glob <glob> Include paths; prefix with ! to exclude; repeatable
170
- --iglob <glob> Case-insensitive path glob; repeatable
171
- -t, --type <type> Include a ripgrep file type; repeatable
172
- -T, --type-not <type> Exclude a ripgrep file type; repeatable
173
- --hidden Include hidden paths except .git and .zvec-grep
174
- --no-ignore Do not apply default or .gitignore rules
175
- --ignore-file <path> Add an explicit ignore file; repeatable
176
- --max-depth <n> Maximum directory depth
177
- --max-filesize <size> Maximum bytes or K/M/G/T size
178
- -L, --follow Follow symbolic links safely
179
- --reset-paths Clear inherited file-selection settings
180
-
181
- New indexes require --embedding, ZVEC_GREP_EMBEDDING, or a configured default.
182
- Existing indexes reuse their stored embedding schema.
183
-
184
- Environment:
185
- ${formatEnvironmentVariables([
186
- "ZVEC_GREP_MODE",
187
- "ZVEC_GREP_EMBEDDING",
188
- "ZVEC_GREP_API_KEY",
189
- "ZVEC_GREP_ENDPOINT",
190
- "ZVEC_GREP_MODEL_CACHE",
191
- "ZVEC_GREP_DEVICE",
192
- ])}
193
-
194
- See zg help environment for precedence and Server-mode scope.`;
195
- case "status":
196
- return `Usage:
197
- zg status [root] [--mode <direct|server|auto>] [--check-ready]
198
-
199
- Shows the nearest workspace root, index policy, index state, embedding schema,
200
- stored paths, refresh status, and suggested next action.
201
-
202
- --check-ready preserves the normal output and exits non-zero unless the
203
- Workspace index is ready.`;
204
- case "config":
205
- return `Usage:
206
- zg config provider set <provider> --api-key <key>
207
- zg config model set <model> [--endpoint <url> | --device <device>] [--default]
208
-
209
- Provider options:
210
- --api-key <key> Default API key for the provider
211
-
212
- Model options:
213
- --endpoint <url> Endpoint for a remote embedding model
214
- --device <device> Local device: auto, cpu, metal, vulkan, cuda
215
- --default Use this model for new indexes
216
-
217
- Remote models support --endpoint; local models support --device. At least one
218
- model option is required. --default may be used alone or with a runtime option.
219
- Existing indexes continue to use their stored model.
220
-
221
- Global configuration is stored in ~/.zvec-grep/config.json.`;
222
- case "auth":
223
- return `Usage:
224
- zg auth grant [root] --capability embedding --scope workspace [--embedding <model>]
225
- zg auth status [root]
226
- zg auth revoke [root]
227
-
228
- Manage the signed Remote Embedding grant stored in the Workspace under
229
- .zvec-grep/authorization.json. Workspace grants are shared by zg CLI and zg MCP.
230
-
231
- --embedding selects the Remote Embedding model to authorize; it does not run
232
- embedding. If omitted, auth grant uses the existing Workspace index model, then
233
- ZVEC_GREP_EMBEDDING, then the global default.
234
-
235
- Scopes used during operations:
236
- once Current CLI command or Agent tool call only
237
- workspace Persisted in this Workspace
238
-
239
- Use --allow-remote on zg query or zg index to authorize Remote Embedding for
240
- that command only. This authorization is not persisted. API credentials
241
- configure a provider but do not grant permission.
242
-
243
- Environment used by auth grant:
244
- ${formatEnvironmentVariables([
245
- "ZVEC_GREP_EMBEDDING",
246
- "ZVEC_GREP_API_KEY",
247
- "ZVEC_GREP_ENDPOINT",
248
- "ZVEC_GREP_AUTHORIZATION_KEY_FILE",
249
- ])}`;
250
- case "server":
251
- return `Usage:
252
- zg server --stdio [--token-file <path>] [--mcp-toolset <agent|full>]
253
- zg server on [--listen 127.0.0.1:7999] [--token-file <path>] [--mcp-toolset <agent|full>]
254
- zg server off [--token-file <path>]
255
- zg server status [--check-ready]
256
- zg server run [--listen 127.0.0.1:7999] [--token-file <path>] [--mcp-toolset <agent|full>]
257
-
258
- --stdio is the MCP client bootstrap transport. It safely starts or reuses the
259
- shared daemon, proxies MCP over stdin/stdout, and leaves the daemon running
260
- when the client disconnects.
261
-
262
- The server listens on loopback. Authentication is disabled by default; pass a
263
- token file or set ZVEC_GREP_SERVER_TOKEN to require Bearer authentication.
264
- The public MCP endpoint defaults to the agent toolset (indexed search only).
265
- Use --mcp-toolset full, or ZVEC_GREP_MCP_TOOLSET=full, to expose managed rg and
266
- the four index and status tools. CLI managed rg, index, and status commands
267
- continue to use the daemon's internal administration endpoint.
268
- --check-ready exits non-zero unless the server is ready.
269
-
270
- Environment:
271
- ${formatEnvironmentVariables([
272
- "ZVEC_GREP_HOME",
273
- "ZVEC_GREP_SERVER_URL",
274
- "ZVEC_GREP_SERVER_TOKEN",
275
- "ZVEC_GREP_SERVER_TOKEN_FILE",
276
- "ZVEC_GREP_MCP_TOOLSET",
277
- ])}
278
-
279
- See zg help environment for daemon startup scope.`;
280
- case "install":
281
- return `Usage:
282
- zg install [--target codex|claude|qwen|qoder|opencode|cursor|all|auto] [--mcp-transport stdio|http] [--mcp-toolset agent|full] [--yes] [--force]
283
-
284
- Options:
285
- --target <agent> codex, claude, qwen, qoder, opencode, cursor, auto, or all; repeatable
286
- --mcp-transport <stdio|http> MCP connection mode (default: stdio)
287
- --mcp-toolset <agent|full> Daemon MCP toolset (default: agent)
288
- --mcp-tool-timeout <seconds> MCP tool timeout where supported (default: 600)
289
- --mcp-token-env <name> HTTP mode Bearer token environment variable
290
- --yes Install detected agents without prompting
291
- --force Replace conflicting unmanaged configuration
292
-
293
- The qoder target configures Qoder CLI and Qoder IDE together.
294
-
295
- Interactive setup detects supported agents, configures stdio by default, and
296
- starts the shared daemon. In stdio mode an agent reconnect also starts the
297
- daemon automatically after a reboot. HTTP users manage later daemon restarts.
298
- Codex, Claude Code, Qwen Code, Qoder CLI, and OpenCode also receive managed
299
- guidance. Qoder IDE has no supported global Rules file, so only its MCP
300
- configuration is managed.
301
- Codex and Claude Code receive local tool pre-approval. Qoder's CLI-backed
302
- runtime receives exact pre-approval for zvec_grep_search and zvec_grep_rg. Remote Embedding
303
- authorization remains separate and is requested by zvec-grep on first remote
304
- use. Restart the agent or open a new session after installation. This does not
305
- install the npm package.`;
306
- case "uninstall":
307
- return `Usage:
308
- zg uninstall [--target codex|claude|qwen|qoder|opencode|cursor|all|auto] [--yes]
309
-
310
- Removes zvec-grep-managed MCP configuration, agent-specific approval, and
311
- guidance. The qoder target removes the managed Qoder CLI and IDE integration
312
- together.`;
313
- case "help":
314
- return `Usage:
315
- zg help [command|topic]
316
- zg <command> --help
317
- zg -h
318
- zg --help
319
-
320
- Topics:
321
- models Supported embedding models
322
- file-types Supported file types and structural parsing
323
- environment, env Environment variables and precedence`;
324
- case "models":
325
- return modelsHelp();
326
- case "file-types":
327
- return fileTypesHelp();
328
- case "environment":
329
- case "env":
330
- return environmentHelp();
331
- case "version":
332
- return `Usage:
333
- zg version
334
- zg version -v
335
- zg -v
336
- zg --version`;
337
- default:
338
- return undefined;
339
- }
340
- }
341
- function modelsHelp() {
342
- const models = listEmbeddingModels().sort((left, right) => {
343
- const leftRuntime = left.provider === "local" ? 0 : 1;
344
- const rightRuntime = right.provider === "local" ? 0 : 1;
345
- return (leftRuntime - rightRuntime ||
346
- left.reference.localeCompare(right.reference));
347
- });
348
- return `Usage:
349
- zg help models
350
-
351
- Supported embedding models:
352
- ${formatEmbeddingModels(models)}
353
-
354
- Local models are downloaded to the model cache on first use. Remote models
355
- require provider credentials plus --allow-remote or a Workspace authorization.
356
- Only qwen/qwen3-vl-embedding accepts image input.
357
-
358
- Existing indexes keep their stored model. See zg help environment for
359
- new-index model selection and runtime precedence.`;
360
- }
361
- function fileTypesHelp() {
362
- const types = listRecognizedFileTypes();
363
- const structuredFormats = new Set(STRUCTURED_CODE_FORMATS);
364
- const componentFormats = new Set(COMPONENT_CODE_FORMATS);
365
- const codeTypes = types.filter((type) => type.kind === "code");
366
- const structuredCode = codeTypes.filter((type) => structuredFormats.has(type.format));
367
- const componentCode = codeTypes.filter((type) => componentFormats.has(type.format));
368
- const plainCode = codeTypes.filter((type) => !structuredFormats.has(type.format) && !componentFormats.has(type.format));
369
- const documentsAndData = types.filter((type) => type.kind === "text" || type.kind === "data");
370
- const images = types.filter((type) => type.kind === "image");
371
- const skipped = listKnownBinaryExtensionGroups().map((group) => [
372
- group.label,
373
- group.extensions.join(", "),
374
- ]);
375
- const sizeLimits = [
376
- ["Code", "code"],
377
- ["Text", "text"],
378
- ["Data", "data"],
379
- ["Image", "image"],
380
- ].map(([label, kind]) => [
381
- label,
382
- `${resolveMaxFileSizeBytes(kind) / (1024 * 1024)} MiB`,
383
- ]);
384
- return `Usage:
385
- zg help file-types
386
-
387
- Structured code (symbols and scopes):
388
- ${formatFileTypeTable(structuredCode)}
389
-
390
- Component code (JavaScript and TypeScript script blocks):
391
- ${formatFileTypeTable(componentCode)}
392
-
393
- Other code (plain-text chunks):
394
- ${formatFileTypeTable(plainCode)}
395
-
396
- Documents and data:
397
- ${formatFileTypeTable(documentsAndData)}
398
- Markdown preserves heading structure; other formats use text chunks.
399
-
400
- Images (multimodal embedding required):
401
- ${formatFileTypeTable(images)}
402
- Images are ignored by default and must be explicitly selected.
403
-
404
- Other text:
405
- Unknown non-binary extensions and extensionless files use text chunks.
406
-
407
- Skipped binary types:
408
- ${formatTable(["GROUP", "EXTENSIONS"], skipped)}
409
- Files detected as binary by content are also skipped.
410
-
411
- Indexing rules:
412
- Default size limits:
413
- ${formatTable(["KIND", "MAX SIZE"], sizeLimits)}
414
- Empty files are skipped. Use --max-filesize to override the size limit.
415
- Common dependencies, build output, generated files, and lock files are
416
- ignored by default. .git and .zvec-grep are always skipped.`;
417
- }
418
- function formatEmbeddingModels(models) {
419
- const rows = models.map((model) => {
420
- const runtime = model.provider === "local" ? "local" : "remote";
421
- const input = "kind" in model && model.kind === "multimodal" ? "text,image" : "text";
422
- const inputLimit = "maxInputTokens" in model ? model.maxInputTokens : model.contextSize;
423
- return [
424
- model.reference,
425
- runtime,
426
- input,
427
- String(model.dimension),
428
- String(inputLimit),
429
- model.backend,
430
- ];
431
- });
432
- return formatTable(["MODEL", "RUNTIME", "INPUT", "DIMS", "TOKENS", "BACKEND"], rows, new Set([3, 4]));
433
- }
434
- function formatFileTypeTable(types) {
435
- const rows = [...types]
436
- .sort((left, right) => left.format.localeCompare(right.format))
437
- .map((type) => [type.format, type.patterns.join(", ")]);
438
- return formatTable(["TYPE", "FILES"], rows);
439
- }
440
- function formatTable(header, rows, rightAlignedColumns = new Set()) {
441
- const widths = header.map((label, index) => Math.max(label.length, ...rows.map((row) => row[index].length)));
442
- const separator = widths.map((width) => "-".repeat(width));
443
- return [header, separator, ...rows]
444
- .map((row) => ` ${row
445
- .map((value, index) => index === row.length - 1
446
- ? value
447
- : rightAlignedColumns.has(index)
448
- ? value.padStart(widths[index])
449
- : value.padEnd(widths[index]))
450
- .join(" ")}`)
451
- .join("\n");
452
- }
453
- function environmentHelp() {
454
- return `Usage:
455
- zg help environment
456
- zg help env
457
-
458
- Client and Server:
459
- ${formatEnvironmentVariables([
460
- "ZVEC_GREP_MODE",
461
- "ZVEC_GREP_SERVER_URL",
462
- "ZVEC_GREP_SERVER_TOKEN",
463
- "ZVEC_GREP_SERVER_TOKEN_FILE",
464
- "ZVEC_GREP_MCP_TOOLSET",
465
- ])}
466
-
467
- Embedding:
468
- ${formatEnvironmentVariables([
469
- "ZVEC_GREP_EMBEDDING",
470
- "ZVEC_GREP_API_KEY",
471
- "ZVEC_GREP_ENDPOINT",
472
- "ZVEC_GREP_MODEL_CACHE",
473
- "ZVEC_GREP_DEVICE",
474
- ])}
475
-
476
- Qwen credential aliases:
477
- ${formatEnvironmentVariables(["DASHSCOPE_API_KEY", "QWEN_API_KEY"])}
478
-
479
- State and authorization:
480
- ${formatEnvironmentVariables([
481
- "ZVEC_GREP_HOME",
482
- "ZVEC_GREP_AUTHORIZATION_KEY_FILE",
483
- ])}
484
-
485
- Advanced:
486
- ${formatEnvironmentVariables([
487
- "ZVEC_GREP_METAL_KEEP_RESIDENCY",
488
- "ZVEC_GREP_LLAMA_CONTEXT_PARALLELISM",
489
- "NO_COLOR",
490
- ])}
491
-
492
- Agent integration paths:
493
- ${formatEnvironmentVariables([
494
- "CODEX_HOME",
495
- "CLAUDE_CONFIG_DIR",
496
- "QWEN_HOME",
497
- "QODER_CONFIG_DIR",
498
- "QODER_IDE_MCP_PATH",
499
- "QODER_IDE_EXECUTABLE",
500
- "OPENCODE_CONFIG",
501
- "CURSOR_CONFIG_DIR",
502
- ])}
503
-
504
- Precedence:
505
- Embedding runtime CLI > Workspace snapshot > Global config > Environment
506
- New-index model --embedding > ZVEC_GREP_EMBEDDING > Global config
507
- Client mode --mode > ZVEC_GREP_MODE > Global config
508
- Qwen environment credential ZVEC_GREP_API_KEY > DASHSCOPE_API_KEY > QWEN_API_KEY
509
-
510
- Server scope:
511
- zg index forwards its ZVEC_GREP_EMBEDDING default to Server and auto modes.
512
- Direct MCP calls use the embedding environment inherited by the daemon.
513
- Restart the daemon after changing its embedding runtime environment.
514
-
515
- Explicit CLI options take priority. Help output never prints or stores
516
- environment values.`;
517
- }
518
- function formatEnvironmentVariables(names) {
519
- const width = Math.max(...names.map((name) => name.length)) + 2;
520
- return names
521
- .map((name) => ` ${name.padEnd(width)}${ENVIRONMENT_VARIABLES[name]}`)
522
- .join("\n");
523
- }
524
- //# sourceMappingURL=help.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"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"}
@@ -1,2 +0,0 @@
1
- #!/usr/bin/env -S node --liftoff-only
2
- export {};
package/dist/cli/index.js DELETED
@@ -1,32 +0,0 @@
1
- #!/usr/bin/env -S node --liftoff-only
2
- import { parseArgs } from "./args.js";
3
- import { runParsedCommand } from "./commands.js";
4
- import { colorModeFromArgs, printError } from "./errors.js";
5
- import { printHelp } from "./help.js";
6
- import { readPackageVersion } from "./version.js";
7
- const PACKAGE_VERSION = readPackageVersion();
8
- void main();
9
- async function main() {
10
- const args = process.argv.slice(2);
11
- const errorColor = colorModeFromArgs(args);
12
- try {
13
- const parsed = parseArgs(args);
14
- if (parsed.command === "version") {
15
- console.log(PACKAGE_VERSION);
16
- process.exitCode = 0;
17
- return;
18
- }
19
- if (parsed.command === "help") {
20
- printHelp(PACKAGE_VERSION, parsed.helpTopic);
21
- process.exitCode = 0;
22
- return;
23
- }
24
- await runParsedCommand(parsed);
25
- process.exitCode = 0;
26
- }
27
- catch (error) {
28
- printError(error, { color: errorColor });
29
- process.exitCode = 1;
30
- }
31
- }
32
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAC;AAE7C,KAAK,IAAI,EAAE,CAAC;AAEZ,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAE/B,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC7B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;YAC9B,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;YAC7C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC/B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,UAAU,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}
@@ -1,4 +0,0 @@
1
- import type { ParsedArgs } from "./types.js";
2
- export declare function runInstall(parsed: ParsedArgs): Promise<void>;
3
- export declare function runUninstall(parsed: ParsedArgs): Promise<void>;
4
- export declare function installerSelectionLines(activeIndex: number, detected: ReadonlySet<string>): string[];