@backbencher/brain 0.0.0-stage → 0.1.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 (319) hide show
  1. package/CHANGELOG.md +298 -0
  2. package/EMBEDDINGS.md +355 -0
  3. package/LICENSE +21 -0
  4. package/README.md +415 -2
  5. package/bin/bb +13 -0
  6. package/dist/analysis-exclusions-7ZJDXOVZ.js +35 -0
  7. package/dist/brain-index-health-KY7K552E.js +17 -0
  8. package/dist/brain-relationship-enrichment-QH7OOHUF.js +558 -0
  9. package/dist/brain.sql-EIM4WS4D.js +29 -0
  10. package/dist/chunk-2BSKD7O3.js +40 -0
  11. package/dist/chunk-2DE27DVC.js +1314 -0
  12. package/dist/chunk-2RRBMNBQ.js +322 -0
  13. package/dist/chunk-2RTN2DFU.js +711 -0
  14. package/dist/chunk-2WXYNLBA.js +29 -0
  15. package/dist/chunk-3CTFIJJB.js +17 -0
  16. package/dist/chunk-3LFTSMIV.js +174 -0
  17. package/dist/chunk-47HKX4AJ.js +930 -0
  18. package/dist/chunk-4H22TLOT.js +543 -0
  19. package/dist/chunk-5SD45FLC.js +818 -0
  20. package/dist/chunk-66A5ZFYA.js +1758 -0
  21. package/dist/chunk-6AIRWAO2.js +247 -0
  22. package/dist/chunk-6WNGD3NN.js +196 -0
  23. package/dist/chunk-7AN7U5IZ.js +371 -0
  24. package/dist/chunk-BHB7BYYI.js +626 -0
  25. package/dist/chunk-BQ3OVQ3P.js +125 -0
  26. package/dist/chunk-CW4XXSNN.js +1479 -0
  27. package/dist/chunk-D2Q4Y47A.js +53 -0
  28. package/dist/chunk-DIYAGQJL.js +34 -0
  29. package/dist/chunk-DYM4FQEE.js +90 -0
  30. package/dist/chunk-EWMWK7WN.js +75 -0
  31. package/dist/chunk-FVVQTSIM.js +3427 -0
  32. package/dist/chunk-FWSL4VG6.js +1290 -0
  33. package/dist/chunk-GBI7V7KY.js +69 -0
  34. package/dist/chunk-GEFFO6O2.js +152 -0
  35. package/dist/chunk-HOWAQXJO.js +236 -0
  36. package/dist/chunk-HQSPJDHI.js +613 -0
  37. package/dist/chunk-IFZNR5UJ.js +2863 -0
  38. package/dist/chunk-J4PMBXQQ.js +336 -0
  39. package/dist/chunk-KAET47ZL.js +125 -0
  40. package/dist/chunk-KCDECRJY.js +440 -0
  41. package/dist/chunk-KLK3PBTO.js +1119 -0
  42. package/dist/chunk-L5TDYKYK.js +76 -0
  43. package/dist/chunk-MLKGABMK.js +9 -0
  44. package/dist/chunk-OWISBAOF.js +61 -0
  45. package/dist/chunk-PJTNGD3Z.js +6924 -0
  46. package/dist/chunk-QLK6ED4Q.js +235 -0
  47. package/dist/chunk-R2GW4F6R.js +19 -0
  48. package/dist/chunk-RCMTFSEF.js +87 -0
  49. package/dist/chunk-RH7KC5HU.js +12050 -0
  50. package/dist/chunk-RM3PY6TG.js +376 -0
  51. package/dist/chunk-ROMM6KMC.js +433 -0
  52. package/dist/chunk-SK6YVHFZ.js +211 -0
  53. package/dist/chunk-SM7RFQRO.js +214 -0
  54. package/dist/chunk-UFE77L67.js +782 -0
  55. package/dist/chunk-UGR4QIGS.js +67 -0
  56. package/dist/chunk-UUNHHX4M.js +13 -0
  57. package/dist/chunk-V44PGPA6.js +2104 -0
  58. package/dist/chunk-VL52PL2T.js +71 -0
  59. package/dist/chunk-VURYFIHW.js +201 -0
  60. package/dist/chunk-XJKJYIPP.js +7436 -0
  61. package/dist/chunk-YI6FF2ZR.js +340 -0
  62. package/dist/cli/index.js +37 -0
  63. package/dist/config-HZAAYDP3.js +10 -0
  64. package/dist/content-search-642F7E5V.js +593 -0
  65. package/dist/database-TCTZDLE5.js +9 -0
  66. package/dist/doctor-GXCKSJOX.js +395 -0
  67. package/dist/edit-engine-KM7MPFEC.js +51 -0
  68. package/dist/engine-42TZFNIZ.js +11 -0
  69. package/dist/engine-LO6L4JLQ.js +18 -0
  70. package/dist/fingerprint-XDXFRWO6.js +33 -0
  71. package/dist/framework-intelligence-DWFCKV44.js +860 -0
  72. package/dist/freshness-3K6VU5OT.js +174 -0
  73. package/dist/graph-engine-PL5YA7BA.js +21 -0
  74. package/dist/graph_request-MM4REP6H.js +350 -0
  75. package/dist/impact_request-WDE47IZ5.js +68 -0
  76. package/dist/index-space-IUUN5WYV.js +15 -0
  77. package/dist/index-status-6BD7UBHR.js +34 -0
  78. package/dist/index.js +159 -0
  79. package/dist/instance-FO6QZRLH.js +19 -0
  80. package/dist/language-detection-DFCAU5DZ.js +11 -0
  81. package/dist/lsp/server.js +4301 -0
  82. package/dist/mcp/server.js +132 -0
  83. package/dist/onboard-DIQZV2NW.js +161 -0
  84. package/dist/override-companion-pass-XR7MHTP7.js +117 -0
  85. package/dist/parallel-indexer-4PW3AFXP.js +88 -0
  86. package/dist/pool-worker.js +1153 -0
  87. package/dist/project-health-ZS5TS2Z6.js +94 -0
  88. package/dist/project-index-5SDPHITE.js +57 -0
  89. package/dist/project-registry-DGZBIZS7.js +355 -0
  90. package/dist/real-bash-analyzer-SXSV67E2.js +2201 -0
  91. package/dist/real-c-analyzer-SY7FTZ6W.js +5942 -0
  92. package/dist/real-clean-analyzer-IGDHHLZK.js +3470 -0
  93. package/dist/real-clojure-analyzer-4OH7IWLB.js +2818 -0
  94. package/dist/real-cpp-analyzer-7LTDRJRJ.js +4101 -0
  95. package/dist/real-csharp-analyzer-KICU3TLH.js +3298 -0
  96. package/dist/real-css-analyzer-HPU277Q6.js +15 -0
  97. package/dist/real-dart-analyzer-7LZ5LCMW.js +3944 -0
  98. package/dist/real-elixir-analyzer-BE3MEVZO.js +2192 -0
  99. package/dist/real-erlang-analyzer-BZMAKYBK.js +1731 -0
  100. package/dist/real-fsharp-analyzer-5QLTOV3E.js +2390 -0
  101. package/dist/real-go-analyzer-POD7MZQR.js +4126 -0
  102. package/dist/real-graphql-analyzer-MAQRZ6QW.js +1442 -0
  103. package/dist/real-groovy-analyzer-MEWSUPMJ.js +2285 -0
  104. package/dist/real-haskell-analyzer-I5L2GR3Y.js +2533 -0
  105. package/dist/real-hcl-analyzer-DBOPXSWJ.js +725 -0
  106. package/dist/real-html-analyzer-O63XZLZD.js +1759 -0
  107. package/dist/real-java-analyzer-CHCW3EKA.js +4677 -0
  108. package/dist/real-javascript-analyzer-QAAJQYZE.js +14 -0
  109. package/dist/real-json-analyzer-UGBR7YQN.js +1640 -0
  110. package/dist/real-julia-analyzer-35Q4GHOZ.js +2085 -0
  111. package/dist/real-kotlin-analyzer-GRAYCWW2.js +3956 -0
  112. package/dist/real-lua-analyzer-5BAPDZDF.js +1957 -0
  113. package/dist/real-makefile-analyzer-YJKAHNAS.js +920 -0
  114. package/dist/real-markdown-analyzer-UKUQZO4F.js +1215 -0
  115. package/dist/real-matlab-analyzer-FVIKQZKG.js +480 -0
  116. package/dist/real-nim-analyzer-M7FAIABG.js +3603 -0
  117. package/dist/real-objective-c-analyzer-XMYQIGQI.js +1518 -0
  118. package/dist/real-perl-analyzer-ZLY6M2DZ.js +1865 -0
  119. package/dist/real-php-analyzer-KI2ZAM7X.js +9368 -0
  120. package/dist/real-powershell-analyzer-B3T5ZP6U.js +2915 -0
  121. package/dist/real-protobuf-analyzer-23OZ75XV.js +867 -0
  122. package/dist/real-python-analyzer-I4TIUB6D.js +4880 -0
  123. package/dist/real-r-analyzer-FJZJXXS6.js +2596 -0
  124. package/dist/real-ruby-analyzer-M3UFIVTQ.js +2429 -0
  125. package/dist/real-rust-analyzer-LVSONPAN.js +3359 -0
  126. package/dist/real-scala-analyzer-CWPI33Q2.js +3293 -0
  127. package/dist/real-scss-analyzer-TGRJQ7TH.js +1515 -0
  128. package/dist/real-solidity-analyzer-4P2VBVWA.js +2608 -0
  129. package/dist/real-sql-analyzer-J7DYZOZR.js +3840 -0
  130. package/dist/real-svelte-analyzer-NHEN2SX5.js +2532 -0
  131. package/dist/real-swift-analyzer-2NSYULWI.js +2311 -0
  132. package/dist/real-toml-analyzer-L3C66L7Q.js +929 -0
  133. package/dist/real-typescript-analyzer-FTC6ETRQ.js +14 -0
  134. package/dist/real-vb-analyzer-ORY7LAQS.js +3145 -0
  135. package/dist/real-vba-analyzer-JH2TTUFI.js +466 -0
  136. package/dist/real-vue-analyzer-OO4FUGBV.js +2680 -0
  137. package/dist/real-xml-analyzer-6CQVR477.js +2405 -0
  138. package/dist/real-yaml-analyzer-J6MQG3YX.js +3528 -0
  139. package/dist/real-zig-analyzer-EFKCPJNU.js +2430 -0
  140. package/dist/regex-search-OPTLKUN5.js +239 -0
  141. package/dist/rules-I453JTRC.js +152 -0
  142. package/dist/scoped-path-MJYWJZQX.js +11 -0
  143. package/dist/setup-show-Y5GB5KXA.js +15 -0
  144. package/dist/setup-wizard-G5YYR5T6.js +24 -0
  145. package/dist/symbol-search-KB4MU4SI.js +16 -0
  146. package/dist/taint-YOTN5X55.js +202 -0
  147. package/dist/taint-analyzer-N7YLZU3N.js +163 -0
  148. package/dist/tool-handlers-G4NAGJIH.js +72 -0
  149. package/dist/tool-registry-BPEJNSZG.js +17 -0
  150. package/dist/tool-validation-RF675A3C.js +32 -0
  151. package/dist/type-inference-4Y7WTMFE.js +13 -0
  152. package/dist/vector-binary-LMY4QGAN.js +19 -0
  153. package/dist/version-LXGNFO37.js +9 -0
  154. package/dist/wasm-NMWO3WXY.js +16 -0
  155. package/docs/EMBEDDINGS.md +132 -0
  156. package/docs/README.md +178 -0
  157. package/docs/data/m10-baseline.json +602 -0
  158. package/docs/data/m10-benchmark-baseline.json +57 -0
  159. package/docs/data/m10-benchmark-last-run.json +127 -0
  160. package/docs/data/m10-final-audit.json +215 -0
  161. package/docs/data/m12-final-audit.json +138 -0
  162. package/docs/data/m12-surface-matrix.json +50 -0
  163. package/docs/data/public-tools.json +1902 -0
  164. package/docs/indexing/DEAD-ASSETS.md +88 -0
  165. package/docs/indexing/INDEXER-REVIEW.md +634 -0
  166. package/docs/indexing/PERFORMANCE-FINDINGS.md +106 -0
  167. package/docs/indexing/README.md +427 -0
  168. package/docs/indexing/discovery-matrix.md +41 -0
  169. package/docs/indexing/embeddings.md +325 -0
  170. package/docs/indexing/environment-variables.md +77 -0
  171. package/docs/indexing/performance.md +323 -0
  172. package/docs/indexing/resume.md +345 -0
  173. package/docs/indexing/troubleshooting.md +391 -0
  174. package/docs/man/bb.1 +190 -0
  175. package/docs/tools/bb_analyze.md +147 -0
  176. package/docs/tools/bb_annotate.md +110 -0
  177. package/docs/tools/bb_annotations.md +106 -0
  178. package/docs/tools/bb_ask.md +101 -0
  179. package/docs/tools/bb_cross_language.md +103 -0
  180. package/docs/tools/bb_doc.md +169 -0
  181. package/docs/tools/bb_edit.md +185 -0
  182. package/docs/tools/bb_graph.md +169 -0
  183. package/docs/tools/bb_health.md +156 -0
  184. package/docs/tools/bb_impact.md +117 -0
  185. package/docs/tools/bb_index.md +108 -0
  186. package/docs/tools/bb_migrate.md +135 -0
  187. package/docs/tools/bb_patterns.md +140 -0
  188. package/docs/tools/bb_search.md +150 -0
  189. package/docs/tools/bb_security.md +100 -0
  190. package/docs/tools/bb_visualize.md +184 -0
  191. package/grammars/README.md +57 -0
  192. package/grammars/THIRD-PARTY-NOTICES.md +50 -0
  193. package/grammars/tree-sitter-c/LICENSE +21 -0
  194. package/grammars/tree-sitter-clojure/LICENSE.md +21 -0
  195. package/grammars/tree-sitter-cpp/LICENSE +21 -0
  196. package/grammars/tree-sitter-csharp/LICENSE +21 -0
  197. package/grammars/tree-sitter-css/LICENSE +21 -0
  198. package/grammars/tree-sitter-css/README.md +21 -0
  199. package/grammars/tree-sitter-dart/LICENSE +20 -0
  200. package/grammars/tree-sitter-dart-upstream/LICENSE +20 -0
  201. package/grammars/tree-sitter-dart-upstream/README.md +18 -0
  202. package/grammars/tree-sitter-elixir/LICENSE +176 -0
  203. package/grammars/tree-sitter-elixir/README.md +11 -0
  204. package/grammars/tree-sitter-fsharp/LICENSE +21 -0
  205. package/grammars/tree-sitter-fsharp/README.md +45 -0
  206. package/grammars/tree-sitter-graphql/LICENSE +21 -0
  207. package/grammars/tree-sitter-graphql/README.md +106 -0
  208. package/grammars/tree-sitter-groovy/LICENSE +21 -0
  209. package/grammars/tree-sitter-groovy/README.md +4 -0
  210. package/grammars/tree-sitter-haskell/LICENSE +21 -0
  211. package/grammars/tree-sitter-haskell/README.md +394 -0
  212. package/grammars/tree-sitter-hcl/CHANGELOG.md +102 -0
  213. package/grammars/tree-sitter-hcl/LICENSE +201 -0
  214. package/grammars/tree-sitter-hcl/README.md +39 -0
  215. package/grammars/tree-sitter-html/LICENSE +21 -0
  216. package/grammars/tree-sitter-html/README.md +21 -0
  217. package/grammars/tree-sitter-julia/LICENSE +21 -0
  218. package/grammars/tree-sitter-julia/README.md +24 -0
  219. package/grammars/tree-sitter-kotlin/LICENSE +9 -0
  220. package/grammars/tree-sitter-lua/LICENSE.md +21 -0
  221. package/grammars/tree-sitter-lua/README.md +29 -0
  222. package/grammars/tree-sitter-make/LICENSE +21 -0
  223. package/grammars/tree-sitter-matlab/LICENSE +19 -0
  224. package/grammars/tree-sitter-matlab/README.md +99 -0
  225. package/grammars/tree-sitter-nim/LICENSE +373 -0
  226. package/grammars/tree-sitter-nim/README.md +46 -0
  227. package/grammars/tree-sitter-objc/LICENSE +21 -0
  228. package/grammars/tree-sitter-objc/README.md +20 -0
  229. package/grammars/tree-sitter-perl/LICENSE +7 -0
  230. package/grammars/tree-sitter-perl/README.md +100 -0
  231. package/grammars/tree-sitter-powershell/LICENSE +21 -0
  232. package/grammars/tree-sitter-powershell/README.md +7 -0
  233. package/grammars/tree-sitter-proto/LICENSE +21 -0
  234. package/grammars/tree-sitter-proto/README.md +105 -0
  235. package/grammars/tree-sitter-r/LICENSE +9 -0
  236. package/grammars/tree-sitter-r/README.md +66 -0
  237. package/grammars/tree-sitter-ruby/LICENSE +22 -0
  238. package/grammars/tree-sitter-scss/LICENSE +21 -0
  239. package/grammars/tree-sitter-scss/README.md +17 -0
  240. package/grammars/tree-sitter-solidity/LICENSE +7 -0
  241. package/grammars/tree-sitter-sql/LICENSE +21 -0
  242. package/grammars/tree-sitter-typescript/LICENSE +21 -0
  243. package/grammars/tree-sitter-vba/LICENSE +21 -0
  244. package/grammars/tree-sitter-vba/README.md +738 -0
  245. package/grammars/tree-sitter-vbnet/LICENSE +21 -0
  246. package/grammars/tree-sitter-vbnet/README.md +322 -0
  247. package/grammars/tree-sitter-xml/LICENSE +19 -0
  248. package/grammars/tree-sitter-yaml/LICENSE +20 -0
  249. package/grammars/tree-sitter-yaml/README.md +21 -0
  250. package/package.json +184 -4
  251. package/wasm/dart.wasm +0 -0
  252. package/wasm/tree-sitter-bash.wasm +0 -0
  253. package/wasm/tree-sitter-c.wasm +0 -0
  254. package/wasm/tree-sitter-c_sharp.wasm +0 -0
  255. package/wasm/tree-sitter-clean.wasm +0 -0
  256. package/wasm/tree-sitter-clojure.wasm +0 -0
  257. package/wasm/tree-sitter-core_schema.wasm +0 -0
  258. package/wasm/tree-sitter-cpp.wasm +0 -0
  259. package/wasm/tree-sitter-css.wasm +0 -0
  260. package/wasm/tree-sitter-dart.wasm +0 -0
  261. package/wasm/tree-sitter-elisp.wasm +0 -0
  262. package/wasm/tree-sitter-elixir.wasm +0 -0
  263. package/wasm/tree-sitter-elm.wasm +0 -0
  264. package/wasm/tree-sitter-embedded_template.wasm +0 -0
  265. package/wasm/tree-sitter-erlang.wasm +0 -0
  266. package/wasm/tree-sitter-fsharp.wasm +0 -0
  267. package/wasm/tree-sitter-fsharp_signature.wasm +0 -0
  268. package/wasm/tree-sitter-go.wasm +0 -0
  269. package/wasm/tree-sitter-graphql.wasm +0 -0
  270. package/wasm/tree-sitter-groovy.wasm +0 -0
  271. package/wasm/tree-sitter-haskell.wasm +0 -0
  272. package/wasm/tree-sitter-hcl.wasm +0 -0
  273. package/wasm/tree-sitter-html.wasm +0 -0
  274. package/wasm/tree-sitter-java.wasm +0 -0
  275. package/wasm/tree-sitter-javascript.wasm +0 -0
  276. package/wasm/tree-sitter-json.wasm +0 -0
  277. package/wasm/tree-sitter-json_schema.wasm +0 -0
  278. package/wasm/tree-sitter-julia.wasm +0 -0
  279. package/wasm/tree-sitter-kotlin.wasm +0 -0
  280. package/wasm/tree-sitter-lua.wasm +0 -0
  281. package/wasm/tree-sitter-make.wasm +0 -0
  282. package/wasm/tree-sitter-markdown.wasm +0 -0
  283. package/wasm/tree-sitter-markdown_inline.wasm +0 -0
  284. package/wasm/tree-sitter-matlab.wasm +0 -0
  285. package/wasm/tree-sitter-nim.wasm +0 -0
  286. package/wasm/tree-sitter-objc.wasm +0 -0
  287. package/wasm/tree-sitter-ocaml.wasm +0 -0
  288. package/wasm/tree-sitter-perl.wasm +0 -0
  289. package/wasm/tree-sitter-php.wasm +0 -0
  290. package/wasm/tree-sitter-php_only.wasm +0 -0
  291. package/wasm/tree-sitter-powershell.wasm +0 -0
  292. package/wasm/tree-sitter-protobuf.wasm +0 -0
  293. package/wasm/tree-sitter-python.wasm +0 -0
  294. package/wasm/tree-sitter-ql.wasm +0 -0
  295. package/wasm/tree-sitter-r.wasm +0 -0
  296. package/wasm/tree-sitter-rescript.wasm +0 -0
  297. package/wasm/tree-sitter-ruby.wasm +0 -0
  298. package/wasm/tree-sitter-rust.wasm +0 -0
  299. package/wasm/tree-sitter-scala.wasm +0 -0
  300. package/wasm/tree-sitter-scss.wasm +0 -0
  301. package/wasm/tree-sitter-solidity.wasm +0 -0
  302. package/wasm/tree-sitter-sql.wasm +0 -0
  303. package/wasm/tree-sitter-svelte.wasm +0 -0
  304. package/wasm/tree-sitter-swift.wasm +0 -0
  305. package/wasm/tree-sitter-systemrdl.wasm +0 -0
  306. package/wasm/tree-sitter-terraform.wasm +0 -0
  307. package/wasm/tree-sitter-tlaplus.wasm +0 -0
  308. package/wasm/tree-sitter-toml.wasm +0 -0
  309. package/wasm/tree-sitter-tsx.wasm +0 -0
  310. package/wasm/tree-sitter-typescript.wasm +0 -0
  311. package/wasm/tree-sitter-vba.wasm +0 -0
  312. package/wasm/tree-sitter-vbnet.wasm +0 -0
  313. package/wasm/tree-sitter-vue.wasm +0 -0
  314. package/wasm/tree-sitter-xml.wasm +0 -0
  315. package/wasm/tree-sitter-yaml.wasm +0 -0
  316. package/wasm/tree-sitter-zig.wasm +0 -0
  317. package/wasm/tree-sitter.wasm +0 -0
  318. package/wasm/tsx.wasm +0 -0
  319. package/wasm/typescript.wasm +0 -0
@@ -0,0 +1,53 @@
1
+ // src/ast/scoped-path.ts
2
+ import { existsSync, realpathSync, statSync } from "fs";
3
+ import path from "path";
4
+ function canonicalProjectRoot(projectPath) {
5
+ const resolved = path.resolve(projectPath);
6
+ try {
7
+ return realpathSync.native(resolved);
8
+ } catch {
9
+ return resolved;
10
+ }
11
+ }
12
+ function isInsideProject(absolute, projectRoot) {
13
+ if (absolute === projectRoot) return true;
14
+ return absolute.startsWith(projectRoot + path.sep);
15
+ }
16
+ function resolveScopedProjectFile(projectPath, input) {
17
+ const projectRoot = canonicalProjectRoot(projectPath);
18
+ const raw = typeof input === "string" ? input.trim() : "";
19
+ if (raw.length === 0) return { ok: false, reason: "empty-path", resolved: projectRoot, projectRoot };
20
+ const lexical = path.resolve(projectRoot, raw);
21
+ if (!isInsideProject(lexical, projectRoot)) {
22
+ return { ok: false, reason: "outside-project", resolved: lexical, projectRoot };
23
+ }
24
+ let canonical = lexical;
25
+ try {
26
+ canonical = realpathSync.native(lexical);
27
+ } catch {
28
+ return { ok: false, reason: "not-found", resolved: lexical, projectRoot };
29
+ }
30
+ if (!isInsideProject(canonical, projectRoot)) {
31
+ return { ok: false, reason: "outside-project", resolved: canonical, projectRoot };
32
+ }
33
+ try {
34
+ if (!statSync(canonical).isFile()) return { ok: false, reason: "not-a-file", resolved: canonical, projectRoot };
35
+ } catch {
36
+ return { ok: false, reason: "not-found", resolved: canonical, projectRoot };
37
+ }
38
+ if (!existsSync(canonical)) return { ok: false, reason: "not-found", resolved: canonical, projectRoot };
39
+ return { ok: true, absolute: canonical };
40
+ }
41
+ function describeScopedPathRefusal(result) {
42
+ const where = `(resolved against ${result.projectRoot})`;
43
+ if (result.reason === "empty-path") return `--file path is empty ${where}`;
44
+ if (result.reason === "not-found") return `--file not found: ${result.resolved} ${where}`;
45
+ if (result.reason === "not-a-file") return `--file is not a file: ${result.resolved} ${where}`;
46
+ return `--file is outside the project: ${result.resolved}; the project root is ${result.projectRoot}`;
47
+ }
48
+
49
+ export {
50
+ canonicalProjectRoot,
51
+ resolveScopedProjectFile,
52
+ describeScopedPathRefusal
53
+ };
@@ -0,0 +1,34 @@
1
+ import {
2
+ bbProjectsDir
3
+ } from "./chunk-2BSKD7O3.js";
4
+
5
+ // src/util/project-id.ts
6
+ import { createHash } from "crypto";
7
+ import { existsSync, mkdirSync, realpathSync, renameSync } from "fs";
8
+ import path from "path";
9
+ function getProjectId(projectPath) {
10
+ const resolved = path.resolve(projectPath);
11
+ let canonical = resolved;
12
+ try {
13
+ canonical = realpathSync.native(resolved);
14
+ } catch {
15
+ }
16
+ const canonicalId = createHash("sha1").update(canonical).digest("hex").substring(0, 40);
17
+ if (canonical !== resolved) {
18
+ const legacyId = createHash("sha1").update(resolved).digest("hex").substring(0, 40);
19
+ const legacyDir = path.join(bbProjectsDir(), legacyId);
20
+ const canonicalDir = path.join(bbProjectsDir(), canonicalId);
21
+ if (existsSync(legacyDir) && !existsSync(canonicalDir)) {
22
+ mkdirSync(bbProjectsDir(), { recursive: true });
23
+ try {
24
+ renameSync(legacyDir, canonicalDir);
25
+ } catch {
26
+ }
27
+ }
28
+ }
29
+ return canonicalId;
30
+ }
31
+
32
+ export {
33
+ getProjectId
34
+ };
@@ -0,0 +1,90 @@
1
+ // src/ast/index-space.ts
2
+ import { statSync } from "fs";
3
+ function runPragma(rawDb, body) {
4
+ const driver = rawDb?.native ?? rawDb;
5
+ if (typeof driver?.pragma === "function") return driver.pragma(body);
6
+ if (typeof driver?.prepare === "function") {
7
+ const stmt = driver.prepare(`PRAGMA ${body}`);
8
+ if (typeof stmt?.all === "function") {
9
+ const rows = stmt.all();
10
+ return Array.isArray(rows) ? rows : [rows];
11
+ }
12
+ }
13
+ return void 0;
14
+ }
15
+ function checkpointWal(rawDb) {
16
+ try {
17
+ const result = runPragma(rawDb, "wal_checkpoint(TRUNCATE)");
18
+ const row = Array.isArray(result) ? result[0] : result;
19
+ if (row && typeof row === "object" && "busy" in row) return Number(row.busy) === 0;
20
+ return true;
21
+ } catch {
22
+ return false;
23
+ }
24
+ }
25
+ function spaceReport(rawDb, dbPath) {
26
+ let dbBytes = 0;
27
+ let walBytes = 0;
28
+ try {
29
+ dbBytes = statSync(dbPath).size;
30
+ } catch {
31
+ }
32
+ try {
33
+ walBytes = statSync(`${dbPath}-wal`).size;
34
+ } catch {
35
+ }
36
+ let freelistBytes = 0;
37
+ let freeRatio = 0;
38
+ try {
39
+ const freeRow = runPragma(rawDb, "freelist_count");
40
+ const pageRow = runPragma(rawDb, "page_size");
41
+ const first = (row, key) => Array.isArray(row) ? row[0]?.[key] : row?.[key];
42
+ const free = Number(first(freeRow, "freelist_count") ?? 0);
43
+ const pageSize = Number(first(pageRow, "page_size") ?? 0);
44
+ freelistBytes = free * pageSize;
45
+ freeRatio = dbBytes > 0 ? freelistBytes / dbBytes : 0;
46
+ } catch {
47
+ }
48
+ return { dbBytes, walBytes, freelistBytes, freeRatio, checkpointed: false, vacuumed: false, vacuumMs: null };
49
+ }
50
+ function shouldVacuumAfterWipe(input) {
51
+ const minBytes = input.minBytes ?? 256 * 1024 * 1024;
52
+ return input.rowsDeleted > 0 && input.dbBytes >= minBytes;
53
+ }
54
+ function reclaimSpace(rawDb, dbPath, opts = {}) {
55
+ const checkpointed = checkpointWal(rawDb);
56
+ const before = spaceReport(rawDb, dbPath);
57
+ const ratioFloor = opts.vacuumAboveRatio ?? 0.25;
58
+ const byteFloor = opts.vacuumAboveBytes ?? 64 * 1024 * 1024;
59
+ const wantVacuum = opts.vacuum === true && before.freelistBytes >= byteFloor && before.freeRatio >= ratioFloor;
60
+ let vacuumed = false;
61
+ let vacuumMs = null;
62
+ if (wantVacuum && process.env.BB_INDEX_VACUUM !== "0") {
63
+ const started = Date.now();
64
+ try {
65
+ rawDb.exec("VACUUM");
66
+ vacuumed = true;
67
+ } catch (e) {
68
+ opts.log?.("VACUUM skipped", { error: String(e?.message ?? e) });
69
+ }
70
+ vacuumMs = Date.now() - started;
71
+ if (vacuumed) checkpointWal(rawDb);
72
+ }
73
+ const after = spaceReport(rawDb, dbPath);
74
+ return { ...after, checkpointed, vacuumed, vacuumMs };
75
+ }
76
+ function formatSpace(report) {
77
+ const mb = (n) => `${(n / 1024 / 1024).toFixed(1)} MB`;
78
+ const parts = [`db ${mb(report.dbBytes)}`, `wal ${mb(report.walBytes)}`];
79
+ if (report.freeRatio > 0) parts.push(`${(report.freeRatio * 100).toFixed(0)}% free`);
80
+ if (report.vacuumed && report.vacuumMs !== null) parts.push(`vacuumed in ${(report.vacuumMs / 1e3).toFixed(1)}s`);
81
+ return parts.join(", ");
82
+ }
83
+
84
+ export {
85
+ checkpointWal,
86
+ spaceReport,
87
+ shouldVacuumAfterWipe,
88
+ reclaimSpace,
89
+ formatSpace
90
+ };
@@ -0,0 +1,75 @@
1
+ // src/ast/file-claim.ts
2
+ import { statSync } from "fs";
3
+ import * as path from "path";
4
+ var FILE_CLAIM_MAX_BYTES = 1 * 1024 * 1024;
5
+ var NOT_A_PLAIN_PATH = [" ", " ", "*", "?", "<", ">", "|", "{", "}", "$"];
6
+ function foldProjectPath(baseDir, written) {
7
+ const rel = projectRelativeOf(baseDir, written);
8
+ return rel !== null && rel.length > 0 ? rel : null;
9
+ }
10
+ function projectRelativeOf(baseDir, written) {
11
+ const w = written.trim();
12
+ if (w.length === 0 || w.length > 300) return null;
13
+ if (w.includes("://") || w.startsWith("/") || w.startsWith("~") || w.startsWith("\\")) return null;
14
+ for (const ch of NOT_A_PLAIN_PATH) if (w.includes(ch)) return null;
15
+ const out = [];
16
+ for (const seg of (baseDir + w).split("/")) {
17
+ if (seg.length === 0 || seg === ".") continue;
18
+ if (seg === "..") {
19
+ if (out.length === 0) return null;
20
+ out.pop();
21
+ continue;
22
+ }
23
+ out.push(seg);
24
+ }
25
+ return out.join("/");
26
+ }
27
+ function dirOf(rel) {
28
+ const i = rel.lastIndexOf("/");
29
+ return i < 0 ? "" : rel.slice(0, i + 1);
30
+ }
31
+ var extOf = (rel) => {
32
+ const dot = rel.lastIndexOf(".");
33
+ const slash = rel.lastIndexOf("/");
34
+ return dot > slash && dot >= 0 ? rel.slice(dot + 1).toLowerCase() : "";
35
+ };
36
+ function fileClaimForTarget(input) {
37
+ const { projectRoot, filePath, admittedExtensions } = input;
38
+ if (projectRoot.length === 0 || admittedExtensions.length === 0) return null;
39
+ let written = input.written.trim();
40
+ if (written.length === 0) return null;
41
+ const magic = input.magicConstants;
42
+ if (magic) {
43
+ for (const key of Object.keys(magic).sort((a, b) => b.length - a.length)) {
44
+ if (key.length > 0) written = written.split(key).join(magic[key]);
45
+ }
46
+ }
47
+ const root = path.resolve(projectRoot);
48
+ const fileRel = path.relative(root, filePath).split(path.sep).join("/");
49
+ const candidates = [];
50
+ for (const c of [foldProjectPath(dirOf(fileRel), written), foldProjectPath("", written), ...input.extraCandidates ?? []]) {
51
+ if (c !== null && c.length > 0 && !candidates.includes(c)) candidates.push(c);
52
+ }
53
+ const admitted = new Set(admittedExtensions.map((e) => e.replace(/^\./, "").toLowerCase()));
54
+ for (const candidate of candidates) {
55
+ if (candidate === ".." || candidate.startsWith("../")) continue;
56
+ if (!admitted.has(extOf(candidate))) continue;
57
+ try {
58
+ const st = statSync(path.join(root, candidate));
59
+ if (!st.isFile()) continue;
60
+ if (input.maxFileSizeBytes !== void 0 && st.size > input.maxFileSizeBytes) continue;
61
+ } catch {
62
+ continue;
63
+ }
64
+ return candidate;
65
+ }
66
+ return null;
67
+ }
68
+
69
+ export {
70
+ FILE_CLAIM_MAX_BYTES,
71
+ foldProjectPath,
72
+ projectRelativeOf,
73
+ dirOf,
74
+ fileClaimForTarget
75
+ };