@genobank/biofs 3.1.0 → 3.18.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 (499) hide show
  1. package/CHANGELOG.md +663 -462
  2. package/dist/abi/USDC.json +33 -0
  3. package/dist/abi/sequentia/BioAgentRegistry.json +20 -0
  4. package/dist/abi/sequentia/BioCIDRegistry.json +139 -0
  5. package/dist/abi/sequentia/BioPIL.json +130 -0
  6. package/dist/abi/sequentia/ConsentManager.json +620 -0
  7. package/dist/abi/sequentia/OpenCravatJobs.json +988 -0
  8. package/dist/abi/sequentia/PaymentRouter.json +638 -0
  9. package/dist/commands/agent/list-sequentia.d.ts +17 -0
  10. package/dist/commands/agent/list-sequentia.d.ts.map +1 -0
  11. package/dist/commands/agent/list-sequentia.js +87 -0
  12. package/dist/commands/agent/list-sequentia.js.map +1 -0
  13. package/dist/commands/agent/register-sequentia.d.ts +33 -0
  14. package/dist/commands/agent/register-sequentia.d.ts.map +1 -0
  15. package/dist/commands/agent/register-sequentia.js +145 -0
  16. package/dist/commands/agent/register-sequentia.js.map +1 -0
  17. package/dist/commands/align-shard/exec.d.ts +45 -0
  18. package/dist/commands/align-shard/exec.d.ts.map +1 -0
  19. package/dist/commands/align-shard/exec.js +549 -0
  20. package/dist/commands/align-shard/exec.js.map +1 -0
  21. package/dist/commands/align-shard/submit.d.ts +37 -0
  22. package/dist/commands/align-shard/submit.d.ts.map +1 -0
  23. package/dist/commands/align-shard/submit.js +117 -0
  24. package/dist/commands/align-shard/submit.js.map +1 -0
  25. package/dist/commands/ancestry/ingest.d.ts +34 -0
  26. package/dist/commands/ancestry/ingest.d.ts.map +1 -0
  27. package/dist/commands/ancestry/ingest.js +175 -0
  28. package/dist/commands/ancestry/ingest.js.map +1 -0
  29. package/dist/commands/ancestry/share.d.ts +33 -0
  30. package/dist/commands/ancestry/share.d.ts.map +1 -0
  31. package/dist/commands/ancestry/share.js +154 -0
  32. package/dist/commands/ancestry/share.js.map +1 -0
  33. package/dist/commands/ancestry/somos.d.ts +34 -0
  34. package/dist/commands/ancestry/somos.d.ts.map +1 -0
  35. package/dist/commands/ancestry/somos.js +151 -0
  36. package/dist/commands/ancestry/somos.js.map +1 -0
  37. package/dist/commands/ancestry/status.d.ts +14 -0
  38. package/dist/commands/ancestry/status.d.ts.map +1 -0
  39. package/dist/commands/ancestry/status.js +74 -0
  40. package/dist/commands/ancestry/status.js.map +1 -0
  41. package/dist/commands/annotate/status.d.ts +11 -4
  42. package/dist/commands/annotate/status.d.ts.map +1 -1
  43. package/dist/commands/annotate/status.js +66 -99
  44. package/dist/commands/annotate/status.js.map +1 -1
  45. package/dist/commands/annotate/submit.d.ts +15 -5
  46. package/dist/commands/annotate/submit.d.ts.map +1 -1
  47. package/dist/commands/annotate/submit.js +86 -266
  48. package/dist/commands/annotate/submit.js.map +1 -1
  49. package/dist/commands/benchmark.d.ts +50 -0
  50. package/dist/commands/benchmark.d.ts.map +1 -0
  51. package/dist/commands/benchmark.js +608 -0
  52. package/dist/commands/benchmark.js.map +1 -0
  53. package/dist/commands/biofiles.d.ts +1 -0
  54. package/dist/commands/biofiles.d.ts.map +1 -1
  55. package/dist/commands/biofiles.js +19 -6
  56. package/dist/commands/biofiles.js.map +1 -1
  57. package/dist/commands/biowallet/bind.d.ts +12 -0
  58. package/dist/commands/biowallet/bind.d.ts.map +1 -0
  59. package/dist/commands/biowallet/bind.js +85 -0
  60. package/dist/commands/biowallet/bind.js.map +1 -0
  61. package/dist/commands/biowallet/create.d.ts +40 -0
  62. package/dist/commands/biowallet/create.d.ts.map +1 -0
  63. package/dist/commands/biowallet/create.js +191 -0
  64. package/dist/commands/biowallet/create.js.map +1 -0
  65. package/dist/commands/biowallet/family.d.ts +48 -0
  66. package/dist/commands/biowallet/family.d.ts.map +1 -0
  67. package/dist/commands/biowallet/family.js +310 -0
  68. package/dist/commands/biowallet/family.js.map +1 -0
  69. package/dist/commands/biowallet/list.d.ts +15 -0
  70. package/dist/commands/biowallet/list.d.ts.map +1 -0
  71. package/dist/commands/biowallet/list.js +81 -0
  72. package/dist/commands/biowallet/list.js.map +1 -0
  73. package/dist/commands/bode.d.ts +34 -0
  74. package/dist/commands/bode.d.ts.map +1 -0
  75. package/dist/commands/bode.js +257 -0
  76. package/dist/commands/bode.js.map +1 -0
  77. package/dist/commands/claim.d.ts +32 -0
  78. package/dist/commands/claim.d.ts.map +1 -0
  79. package/dist/commands/claim.js +138 -0
  80. package/dist/commands/claim.js.map +1 -0
  81. package/dist/commands/clinical.d.ts +49 -0
  82. package/dist/commands/clinical.d.ts.map +1 -0
  83. package/dist/commands/clinical.js +273 -0
  84. package/dist/commands/clinical.js.map +1 -0
  85. package/dist/commands/cohort-acmg.d.ts +42 -0
  86. package/dist/commands/cohort-acmg.d.ts.map +1 -0
  87. package/dist/commands/cohort-acmg.js +319 -0
  88. package/dist/commands/cohort-acmg.js.map +1 -0
  89. package/dist/commands/cohort-fourier-score.d.ts +57 -0
  90. package/dist/commands/cohort-fourier-score.d.ts.map +1 -0
  91. package/dist/commands/cohort-fourier-score.js +390 -0
  92. package/dist/commands/cohort-fourier-score.js.map +1 -0
  93. package/dist/commands/cohort-pipeline.d.ts +49 -0
  94. package/dist/commands/cohort-pipeline.d.ts.map +1 -0
  95. package/dist/commands/cohort-pipeline.js +308 -0
  96. package/dist/commands/cohort-pipeline.js.map +1 -0
  97. package/dist/commands/cohort-train.d.ts +45 -0
  98. package/dist/commands/cohort-train.d.ts.map +1 -0
  99. package/dist/commands/cohort-train.js +308 -0
  100. package/dist/commands/cohort-train.js.map +1 -0
  101. package/dist/commands/comethyl/exec.d.ts +40 -0
  102. package/dist/commands/comethyl/exec.d.ts.map +1 -0
  103. package/dist/commands/comethyl/exec.js +493 -0
  104. package/dist/commands/comethyl/exec.js.map +1 -0
  105. package/dist/commands/comethyl/submit.d.ts +35 -0
  106. package/dist/commands/comethyl/submit.d.ts.map +1 -0
  107. package/dist/commands/comethyl/submit.js +98 -0
  108. package/dist/commands/comethyl/submit.js.map +1 -0
  109. package/dist/commands/consent.d.ts +10 -0
  110. package/dist/commands/consent.d.ts.map +1 -0
  111. package/dist/commands/consent.js +114 -0
  112. package/dist/commands/consent.js.map +1 -0
  113. package/dist/commands/dipcall/exec.d.ts +25 -0
  114. package/dist/commands/dipcall/exec.d.ts.map +1 -0
  115. package/dist/commands/dipcall/exec.js +207 -0
  116. package/dist/commands/dipcall/exec.js.map +1 -0
  117. package/dist/commands/dipcall/submit.d.ts +22 -0
  118. package/dist/commands/dipcall/submit.d.ts.map +1 -0
  119. package/dist/commands/dipcall/submit.js +81 -0
  120. package/dist/commands/dipcall/submit.js.map +1 -0
  121. package/dist/commands/download-with-consent.d.ts +1 -0
  122. package/dist/commands/download-with-consent.d.ts.map +1 -1
  123. package/dist/commands/download-with-consent.js +32 -0
  124. package/dist/commands/download-with-consent.js.map +1 -1
  125. package/dist/commands/download.d.ts +2 -0
  126. package/dist/commands/download.d.ts.map +1 -1
  127. package/dist/commands/download.js +31 -0
  128. package/dist/commands/download.js.map +1 -1
  129. package/dist/commands/duet.d.ts +39 -0
  130. package/dist/commands/duet.d.ts.map +1 -0
  131. package/dist/commands/duet.js +323 -0
  132. package/dist/commands/duet.js.map +1 -0
  133. package/dist/commands/erase.d.ts +29 -0
  134. package/dist/commands/erase.d.ts.map +1 -0
  135. package/dist/commands/erase.js +136 -0
  136. package/dist/commands/erase.js.map +1 -0
  137. package/dist/commands/family-status.d.ts +3 -0
  138. package/dist/commands/family-status.d.ts.map +1 -1
  139. package/dist/commands/family-status.js +279 -166
  140. package/dist/commands/family-status.js.map +1 -1
  141. package/dist/commands/fingerprint.d.ts +2 -0
  142. package/dist/commands/fingerprint.d.ts.map +1 -1
  143. package/dist/commands/fingerprint.js +4 -0
  144. package/dist/commands/fingerprint.js.map +1 -1
  145. package/dist/commands/fluency/index.d.ts +7 -0
  146. package/dist/commands/fluency/index.d.ts.map +1 -0
  147. package/dist/commands/fluency/index.js +122 -0
  148. package/dist/commands/fluency/index.js.map +1 -0
  149. package/dist/commands/fourier-score.d.ts +36 -0
  150. package/dist/commands/fourier-score.d.ts.map +1 -0
  151. package/dist/commands/fourier-score.js +713 -0
  152. package/dist/commands/fourier-score.js.map +1 -0
  153. package/dist/commands/fuse.d.ts.map +1 -1
  154. package/dist/commands/fuse.js +29 -7
  155. package/dist/commands/fuse.js.map +1 -1
  156. package/dist/commands/hifi-align/exec.d.ts +23 -0
  157. package/dist/commands/hifi-align/exec.d.ts.map +1 -0
  158. package/dist/commands/hifi-align/exec.js +224 -0
  159. package/dist/commands/hifi-align/exec.js.map +1 -0
  160. package/dist/commands/hifi-align/submit.d.ts +22 -0
  161. package/dist/commands/hifi-align/submit.d.ts.map +1 -0
  162. package/dist/commands/hifi-align/submit.js +82 -0
  163. package/dist/commands/hifi-align/submit.js.map +1 -0
  164. package/dist/commands/hifi-deepvariant/exec.d.ts +29 -0
  165. package/dist/commands/hifi-deepvariant/exec.d.ts.map +1 -0
  166. package/dist/commands/hifi-deepvariant/exec.js +280 -0
  167. package/dist/commands/hifi-deepvariant/exec.js.map +1 -0
  168. package/dist/commands/hifi-deepvariant/submit.d.ts +23 -0
  169. package/dist/commands/hifi-deepvariant/submit.d.ts.map +1 -0
  170. package/dist/commands/hifi-deepvariant/submit.js +80 -0
  171. package/dist/commands/hifi-deepvariant/submit.js.map +1 -0
  172. package/dist/commands/hifi-methyl/exec.d.ts +25 -0
  173. package/dist/commands/hifi-methyl/exec.d.ts.map +1 -0
  174. package/dist/commands/hifi-methyl/exec.js +243 -0
  175. package/dist/commands/hifi-methyl/exec.js.map +1 -0
  176. package/dist/commands/hifi-methyl/submit.d.ts +22 -0
  177. package/dist/commands/hifi-methyl/submit.d.ts.map +1 -0
  178. package/dist/commands/hifi-methyl/submit.js +78 -0
  179. package/dist/commands/hifi-methyl/submit.js.map +1 -0
  180. package/dist/commands/htsget.d.ts +6 -0
  181. package/dist/commands/htsget.d.ts.map +1 -1
  182. package/dist/commands/htsget.js +31 -6
  183. package/dist/commands/htsget.js.map +1 -1
  184. package/dist/commands/imaging/attribute.d.ts +19 -0
  185. package/dist/commands/imaging/attribute.d.ts.map +1 -0
  186. package/dist/commands/imaging/attribute.js +102 -0
  187. package/dist/commands/imaging/attribute.js.map +1 -0
  188. package/dist/commands/imaging/characterize.d.ts +20 -0
  189. package/dist/commands/imaging/characterize.d.ts.map +1 -0
  190. package/dist/commands/imaging/characterize.js +105 -0
  191. package/dist/commands/imaging/characterize.js.map +1 -0
  192. package/dist/commands/imaging/compare.d.ts +33 -0
  193. package/dist/commands/imaging/compare.d.ts.map +1 -0
  194. package/dist/commands/imaging/compare.js +129 -0
  195. package/dist/commands/imaging/compare.js.map +1 -0
  196. package/dist/commands/imaging/enrich.d.ts +28 -0
  197. package/dist/commands/imaging/enrich.d.ts.map +1 -0
  198. package/dist/commands/imaging/enrich.js +130 -0
  199. package/dist/commands/imaging/enrich.js.map +1 -0
  200. package/dist/commands/imaging/findings.d.ts +21 -0
  201. package/dist/commands/imaging/findings.d.ts.map +1 -0
  202. package/dist/commands/imaging/findings.js +134 -0
  203. package/dist/commands/imaging/findings.js.map +1 -0
  204. package/dist/commands/imaging/lesions.d.ts +21 -0
  205. package/dist/commands/imaging/lesions.d.ts.map +1 -0
  206. package/dist/commands/imaging/lesions.js +131 -0
  207. package/dist/commands/imaging/lesions.js.map +1 -0
  208. package/dist/commands/imaging/submit.d.ts +32 -0
  209. package/dist/commands/imaging/submit.d.ts.map +1 -0
  210. package/dist/commands/imaging/submit.js +118 -0
  211. package/dist/commands/imaging/submit.js.map +1 -0
  212. package/dist/commands/imaging/trajectory.d.ts +23 -0
  213. package/dist/commands/imaging/trajectory.d.ts.map +1 -0
  214. package/dist/commands/imaging/trajectory.js +134 -0
  215. package/dist/commands/imaging/trajectory.js.map +1 -0
  216. package/dist/commands/imaging/twin.d.ts +32 -0
  217. package/dist/commands/imaging/twin.d.ts.map +1 -0
  218. package/dist/commands/imaging/twin.js +168 -0
  219. package/dist/commands/imaging/twin.js.map +1 -0
  220. package/dist/commands/ingest-rna-tpm.d.ts +33 -0
  221. package/dist/commands/ingest-rna-tpm.d.ts.map +1 -0
  222. package/dist/commands/ingest-rna-tpm.js +104 -0
  223. package/dist/commands/ingest-rna-tpm.js.map +1 -0
  224. package/dist/commands/interpret/status.d.ts +14 -0
  225. package/dist/commands/interpret/status.d.ts.map +1 -0
  226. package/dist/commands/interpret/status.js +83 -0
  227. package/dist/commands/interpret/status.js.map +1 -0
  228. package/dist/commands/interpret/submit.d.ts +22 -0
  229. package/dist/commands/interpret/submit.d.ts.map +1 -0
  230. package/dist/commands/interpret/submit.js +103 -0
  231. package/dist/commands/interpret/submit.js.map +1 -0
  232. package/dist/commands/inventory/cohort.d.ts +29 -0
  233. package/dist/commands/inventory/cohort.d.ts.map +1 -0
  234. package/dist/commands/inventory/cohort.js +136 -0
  235. package/dist/commands/inventory/cohort.js.map +1 -0
  236. package/dist/commands/inventory-register-sqlite.d.ts +36 -0
  237. package/dist/commands/inventory-register-sqlite.d.ts.map +1 -0
  238. package/dist/commands/inventory-register-sqlite.js +178 -0
  239. package/dist/commands/inventory-register-sqlite.js.map +1 -0
  240. package/dist/commands/job/recall.d.ts +6 -0
  241. package/dist/commands/job/recall.d.ts.map +1 -0
  242. package/dist/commands/job/recall.js +59 -0
  243. package/dist/commands/job/recall.js.map +1 -0
  244. package/dist/commands/job/reconcile.d.ts +19 -0
  245. package/dist/commands/job/reconcile.d.ts.map +1 -0
  246. package/dist/commands/job/reconcile.js +67 -0
  247. package/dist/commands/job/reconcile.js.map +1 -0
  248. package/dist/commands/lab/refreshCoverage.d.ts +53 -0
  249. package/dist/commands/lab/refreshCoverage.d.ts.map +1 -0
  250. package/dist/commands/lab/refreshCoverage.js +244 -0
  251. package/dist/commands/lab/refreshCoverage.js.map +1 -0
  252. package/dist/commands/liftover/exec.d.ts +27 -0
  253. package/dist/commands/liftover/exec.d.ts.map +1 -0
  254. package/dist/commands/liftover/exec.js +258 -0
  255. package/dist/commands/liftover/exec.js.map +1 -0
  256. package/dist/commands/liftover/submit.d.ts +22 -0
  257. package/dist/commands/liftover/submit.d.ts.map +1 -0
  258. package/dist/commands/liftover/submit.js +79 -0
  259. package/dist/commands/liftover/submit.js.map +1 -0
  260. package/dist/commands/lineage.d.ts +6 -0
  261. package/dist/commands/lineage.d.ts.map +1 -0
  262. package/dist/commands/lineage.js +126 -0
  263. package/dist/commands/lineage.js.map +1 -0
  264. package/dist/commands/methyl/exec.d.ts +47 -0
  265. package/dist/commands/methyl/exec.d.ts.map +1 -0
  266. package/dist/commands/methyl/exec.js +565 -0
  267. package/dist/commands/methyl/exec.js.map +1 -0
  268. package/dist/commands/methyl/submit.d.ts +25 -0
  269. package/dist/commands/methyl/submit.d.ts.map +1 -0
  270. package/dist/commands/methyl/submit.js +98 -0
  271. package/dist/commands/methyl/submit.js.map +1 -0
  272. package/dist/commands/mount.d.ts +17 -2
  273. package/dist/commands/mount.d.ts.map +1 -1
  274. package/dist/commands/mount.js +158 -6
  275. package/dist/commands/mount.js.map +1 -1
  276. package/dist/commands/myvariant.d.ts +60 -0
  277. package/dist/commands/myvariant.d.ts.map +1 -0
  278. package/dist/commands/myvariant.js +433 -0
  279. package/dist/commands/myvariant.js.map +1 -0
  280. package/dist/commands/ont-variants/exec.d.ts +24 -0
  281. package/dist/commands/ont-variants/exec.d.ts.map +1 -0
  282. package/dist/commands/ont-variants/exec.js +230 -0
  283. package/dist/commands/ont-variants/exec.js.map +1 -0
  284. package/dist/commands/ont-variants/submit.d.ts +22 -0
  285. package/dist/commands/ont-variants/submit.d.ts.map +1 -0
  286. package/dist/commands/ont-variants/submit.js +78 -0
  287. package/dist/commands/ont-variants/submit.js.map +1 -0
  288. package/dist/commands/pbsv/exec.d.ts +24 -0
  289. package/dist/commands/pbsv/exec.d.ts.map +1 -0
  290. package/dist/commands/pbsv/exec.js +231 -0
  291. package/dist/commands/pbsv/exec.js.map +1 -0
  292. package/dist/commands/pbsv/submit.d.ts +22 -0
  293. package/dist/commands/pbsv/submit.d.ts.map +1 -0
  294. package/dist/commands/pbsv/submit.js +78 -0
  295. package/dist/commands/pbsv/submit.js.map +1 -0
  296. package/dist/commands/phase/exec.d.ts +26 -0
  297. package/dist/commands/phase/exec.d.ts.map +1 -0
  298. package/dist/commands/phase/exec.js +246 -0
  299. package/dist/commands/phase/exec.js.map +1 -0
  300. package/dist/commands/phase/submit.d.ts +24 -0
  301. package/dist/commands/phase/submit.d.ts.map +1 -0
  302. package/dist/commands/phase/submit.js +83 -0
  303. package/dist/commands/phase/submit.js.map +1 -0
  304. package/dist/commands/pipe.d.ts +4 -2
  305. package/dist/commands/pipe.d.ts.map +1 -1
  306. package/dist/commands/pipe.js +55 -50
  307. package/dist/commands/pipe.js.map +1 -1
  308. package/dist/commands/pipeline/runWes.d.ts +28 -0
  309. package/dist/commands/pipeline/runWes.d.ts.map +1 -0
  310. package/dist/commands/pipeline/runWes.js +276 -0
  311. package/dist/commands/pipeline/runWes.js.map +1 -0
  312. package/dist/commands/profile.d.ts +8 -0
  313. package/dist/commands/profile.d.ts.map +1 -0
  314. package/dist/commands/profile.js +193 -0
  315. package/dist/commands/profile.js.map +1 -0
  316. package/dist/commands/psm-consensus.d.ts +72 -0
  317. package/dist/commands/psm-consensus.d.ts.map +1 -0
  318. package/dist/commands/psm-consensus.js +338 -0
  319. package/dist/commands/psm-consensus.js.map +1 -0
  320. package/dist/commands/qc/exec.d.ts +32 -0
  321. package/dist/commands/qc/exec.d.ts.map +1 -0
  322. package/dist/commands/qc/exec.js +350 -0
  323. package/dist/commands/qc/exec.js.map +1 -0
  324. package/dist/commands/qc/submit.d.ts +23 -0
  325. package/dist/commands/qc/submit.d.ts.map +1 -0
  326. package/dist/commands/qc/submit.js +88 -0
  327. package/dist/commands/qc/submit.js.map +1 -0
  328. package/dist/commands/query.d.ts +37 -0
  329. package/dist/commands/query.d.ts.map +1 -0
  330. package/dist/commands/query.js +170 -0
  331. package/dist/commands/query.js.map +1 -0
  332. package/dist/commands/repeat-genotype/exec.d.ts +26 -0
  333. package/dist/commands/repeat-genotype/exec.d.ts.map +1 -0
  334. package/dist/commands/repeat-genotype/exec.js +245 -0
  335. package/dist/commands/repeat-genotype/exec.js.map +1 -0
  336. package/dist/commands/repeat-genotype/submit.d.ts +23 -0
  337. package/dist/commands/repeat-genotype/submit.d.ts.map +1 -0
  338. package/dist/commands/repeat-genotype/submit.js +82 -0
  339. package/dist/commands/repeat-genotype/submit.js.map +1 -0
  340. package/dist/commands/researcher/passport.d.ts +15 -0
  341. package/dist/commands/researcher/passport.d.ts.map +1 -0
  342. package/dist/commands/researcher/passport.js +98 -0
  343. package/dist/commands/researcher/passport.js.map +1 -0
  344. package/dist/commands/researcher/register.d.ts +18 -0
  345. package/dist/commands/researcher/register.d.ts.map +1 -0
  346. package/dist/commands/researcher/register.js +277 -0
  347. package/dist/commands/researcher/register.js.map +1 -0
  348. package/dist/commands/researcher/status.d.ts +6 -0
  349. package/dist/commands/researcher/status.d.ts.map +1 -0
  350. package/dist/commands/researcher/status.js +111 -0
  351. package/dist/commands/researcher/status.js.map +1 -0
  352. package/dist/commands/room.d.ts +31 -0
  353. package/dist/commands/room.d.ts.map +1 -0
  354. package/dist/commands/room.js +486 -0
  355. package/dist/commands/room.js.map +1 -0
  356. package/dist/commands/route/anchor.d.ts +42 -0
  357. package/dist/commands/route/anchor.d.ts.map +1 -0
  358. package/dist/commands/route/anchor.js +213 -0
  359. package/dist/commands/route/anchor.js.map +1 -0
  360. package/dist/commands/route/index.d.ts +27 -0
  361. package/dist/commands/route/index.d.ts.map +1 -0
  362. package/dist/commands/route/index.js +82 -0
  363. package/dist/commands/route/index.js.map +1 -0
  364. package/dist/commands/rrm-consensus.d.ts +74 -0
  365. package/dist/commands/rrm-consensus.d.ts.map +1 -0
  366. package/dist/commands/rrm-consensus.js +334 -0
  367. package/dist/commands/rrm-consensus.js.map +1 -0
  368. package/dist/commands/rrm-distribution.d.ts +34 -0
  369. package/dist/commands/rrm-distribution.d.ts.map +1 -0
  370. package/dist/commands/rrm-distribution.js +743 -0
  371. package/dist/commands/rrm-distribution.js.map +1 -0
  372. package/dist/commands/rrm-train.d.ts +33 -0
  373. package/dist/commands/rrm-train.d.ts.map +1 -0
  374. package/dist/commands/rrm-train.js +549 -0
  375. package/dist/commands/rrm-train.js.map +1 -0
  376. package/dist/commands/samples.d.ts +25 -0
  377. package/dist/commands/samples.d.ts.map +1 -0
  378. package/dist/commands/samples.js +184 -0
  379. package/dist/commands/samples.js.map +1 -0
  380. package/dist/commands/score-protein.d.ts +13 -0
  381. package/dist/commands/score-protein.d.ts.map +1 -0
  382. package/dist/commands/score-protein.js +360 -0
  383. package/dist/commands/score-protein.js.map +1 -0
  384. package/dist/commands/stream.d.ts +7 -0
  385. package/dist/commands/stream.d.ts.map +1 -1
  386. package/dist/commands/stream.js +26 -41
  387. package/dist/commands/stream.js.map +1 -1
  388. package/dist/commands/sv-call/exec.d.ts +23 -0
  389. package/dist/commands/sv-call/exec.d.ts.map +1 -0
  390. package/dist/commands/sv-call/exec.js +233 -0
  391. package/dist/commands/sv-call/exec.js.map +1 -0
  392. package/dist/commands/sv-call/submit.d.ts +21 -0
  393. package/dist/commands/sv-call/submit.d.ts.map +1 -0
  394. package/dist/commands/sv-call/submit.js +77 -0
  395. package/dist/commands/sv-call/submit.js.map +1 -0
  396. package/dist/commands/tele.d.ts +42 -0
  397. package/dist/commands/tele.d.ts.map +1 -0
  398. package/dist/commands/tele.js +559 -0
  399. package/dist/commands/tele.js.map +1 -0
  400. package/dist/commands/tokenize-spectrum.d.ts +58 -0
  401. package/dist/commands/tokenize-spectrum.d.ts.map +1 -0
  402. package/dist/commands/tokenize-spectrum.js +297 -0
  403. package/dist/commands/tokenize-spectrum.js.map +1 -0
  404. package/dist/commands/umount.d.ts.map +1 -1
  405. package/dist/commands/umount.js +42 -1
  406. package/dist/commands/umount.js.map +1 -1
  407. package/dist/commands/variants.d.ts +42 -0
  408. package/dist/commands/variants.d.ts.map +1 -0
  409. package/dist/commands/variants.js +237 -0
  410. package/dist/commands/variants.js.map +1 -0
  411. package/dist/commands/verkko/exec.d.ts +27 -0
  412. package/dist/commands/verkko/exec.d.ts.map +1 -0
  413. package/dist/commands/verkko/exec.js +223 -0
  414. package/dist/commands/verkko/exec.js.map +1 -0
  415. package/dist/commands/verkko/submit.d.ts +24 -0
  416. package/dist/commands/verkko/submit.d.ts.map +1 -0
  417. package/dist/commands/verkko/submit.js +96 -0
  418. package/dist/commands/verkko/submit.js.map +1 -0
  419. package/dist/commands/wavelet-consensus.d.ts +69 -0
  420. package/dist/commands/wavelet-consensus.d.ts.map +1 -0
  421. package/dist/commands/wavelet-consensus.js +338 -0
  422. package/dist/commands/wavelet-consensus.js.map +1 -0
  423. package/dist/commands/workspace.d.ts +59 -0
  424. package/dist/commands/workspace.d.ts.map +1 -0
  425. package/dist/commands/workspace.js +419 -0
  426. package/dist/commands/workspace.js.map +1 -0
  427. package/dist/commands/x402/index.d.ts +8 -0
  428. package/dist/commands/x402/index.d.ts.map +1 -1
  429. package/dist/commands/x402/index.js +100 -2
  430. package/dist/commands/x402/index.js.map +1 -1
  431. package/dist/commands/x402/pipeline-cancer-twin.d.ts +119 -0
  432. package/dist/commands/x402/pipeline-cancer-twin.d.ts.map +1 -0
  433. package/dist/commands/x402/pipeline-cancer-twin.js +326 -0
  434. package/dist/commands/x402/pipeline-cancer-twin.js.map +1 -0
  435. package/dist/commands/x402/submit.d.ts +72 -0
  436. package/dist/commands/x402/submit.d.ts.map +1 -0
  437. package/dist/commands/x402/submit.js +227 -0
  438. package/dist/commands/x402/submit.js.map +1 -0
  439. package/dist/commands/x402/verify-payment.d.ts +24 -0
  440. package/dist/commands/x402/verify-payment.d.ts.map +1 -0
  441. package/dist/commands/x402/verify-payment.js +113 -0
  442. package/dist/commands/x402/verify-payment.js.map +1 -0
  443. package/dist/index.js +2804 -196
  444. package/dist/index.js.map +1 -1
  445. package/dist/lib/api/client.d.ts +1 -0
  446. package/dist/lib/api/client.d.ts.map +1 -1
  447. package/dist/lib/api/client.js +22 -0
  448. package/dist/lib/api/client.js.map +1 -1
  449. package/dist/lib/api/fuse-client.d.ts +281 -0
  450. package/dist/lib/api/fuse-client.d.ts.map +1 -1
  451. package/dist/lib/api/fuse-client.js +428 -0
  452. package/dist/lib/api/fuse-client.js.map +1 -1
  453. package/dist/lib/biofiles/resolver.d.ts +1 -1
  454. package/dist/lib/biofiles/resolver.d.ts.map +1 -1
  455. package/dist/lib/biofiles/resolver.js +173 -138
  456. package/dist/lib/biofiles/resolver.js.map +1 -1
  457. package/dist/lib/config/constants.d.ts +1 -0
  458. package/dist/lib/config/constants.d.ts.map +1 -1
  459. package/dist/lib/config/constants.js +1 -0
  460. package/dist/lib/config/constants.js.map +1 -1
  461. package/dist/lib/config/paths.d.ts +6 -6
  462. package/dist/lib/config/paths.d.ts.map +1 -1
  463. package/dist/lib/config/paths.js +56 -17
  464. package/dist/lib/config/paths.js.map +1 -1
  465. package/dist/lib/gene-map.d.ts +24 -0
  466. package/dist/lib/gene-map.d.ts.map +1 -0
  467. package/dist/lib/gene-map.js +114 -0
  468. package/dist/lib/gene-map.js.map +1 -0
  469. package/dist/lib/htsget/client.d.ts +28 -5
  470. package/dist/lib/htsget/client.d.ts.map +1 -1
  471. package/dist/lib/htsget/client.js +96 -18
  472. package/dist/lib/htsget/client.js.map +1 -1
  473. package/dist/lib/sequentia/BioAgentRegistry.d.ts +98 -0
  474. package/dist/lib/sequentia/BioAgentRegistry.d.ts.map +1 -0
  475. package/dist/lib/sequentia/BioAgentRegistry.js +209 -0
  476. package/dist/lib/sequentia/BioAgentRegistry.js.map +1 -0
  477. package/dist/lib/tele/core.d.ts +71 -0
  478. package/dist/lib/tele/core.d.ts.map +1 -0
  479. package/dist/lib/tele/core.js +387 -0
  480. package/dist/lib/tele/core.js.map +1 -0
  481. package/dist/lib/x402/cancer-twin-agents.d.ts +65 -0
  482. package/dist/lib/x402/cancer-twin-agents.d.ts.map +1 -0
  483. package/dist/lib/x402/cancer-twin-agents.js +114 -0
  484. package/dist/lib/x402/cancer-twin-agents.js.map +1 -0
  485. package/dist/lib/x402/sequentia-pay.d.ts +51 -0
  486. package/dist/lib/x402/sequentia-pay.d.ts.map +1 -0
  487. package/dist/lib/x402/sequentia-pay.js +186 -0
  488. package/dist/lib/x402/sequentia-pay.js.map +1 -0
  489. package/dist/types/biofiles.d.ts +1 -1
  490. package/dist/types/biofiles.d.ts.map +1 -1
  491. package/dist/utils/errorReporter.d.ts +1 -0
  492. package/dist/utils/errorReporter.d.ts.map +1 -1
  493. package/dist/utils/errorReporter.js +39 -1
  494. package/dist/utils/errorReporter.js.map +1 -1
  495. package/dist/version.d.ts +2 -0
  496. package/dist/version.d.ts.map +1 -0
  497. package/dist/version.js +20 -0
  498. package/dist/version.js.map +1 -0
  499. package/package.json +5 -4
package/CHANGELOG.md CHANGED
@@ -1,3 +1,204 @@
1
+ # v3.5.0 — biofs clinical: phenotype-driven multi-exome ACMG/AMP 2015 + ClinGen-SVI classifier
2
+
3
+ **Published**: 2026-05-23. Server endpoint at `POST https://genobank.app/api_biofs_fuse/clinical_acmg` (analyzer at `/home/ubuntu/Genobank_APIs/production_api/clinical_acmg/clinical_acmg.py`).
4
+
5
+ ## New verb: `biofs clinical <biosample_serial>`
6
+
7
+ Phenotype-driven, n-of-1 or joint-N exome ACMG/AMP 2015 + ClinGen-SVI 2024 (Pejaver-2022 calibrated) variant classifier. Complements `cohort-acmg` which is batch-mode-across-probands ClinVar P/LP only; `clinical` is single-proband, applies ACMG criteria de novo across the full variant set, ranks by phenotype-gene match.
8
+
9
+ ### CLI surface
10
+
11
+ ```bash
12
+ # joint 4-exome with phenotype words
13
+ biofs clinical 55052008714014 \
14
+ --serials 55052008714060,55052008713972,55052008714008 \
15
+ --phenotype "skeletal disability, bone fractures, under development, wheelchair" \
16
+ --panel skeletal_dysplasia
17
+
18
+ # explicit HPO codes + photo (graceful fallback if FDNA Face2Gene key not set server-side)
19
+ biofs clinical 55052008714014 \
20
+ --hpo HP:0000924,HP:0002659,HP:0001263 \
21
+ --photo ./patient.jpg
22
+ ```
23
+
24
+ ### Inputs
25
+
26
+ - Primary biosample serial (positional) + optional `--serials` list for joint-N pass
27
+ - `--phenotype "<text>"` — mapped to HPO via local HPOA annotations at `/home/ubuntu/data/hpo_cache/`
28
+ - `--hpo HP:...` — explicit codes, additive with `--phenotype`
29
+ - `--photo <path>` — Face2Gene-style syndrome predictor; returns `no_api_key` with graceful fallback to phenotype-text mapping when `CLINICAL_FACE2GENE_KEY` not configured server-side
30
+ - `--panel skeletal_dysplasia` — built-in panel (HPO-curated genes auto-augment)
31
+ - `--max-af 0.01` — gnomAD AF ceiling
32
+ - `--case-label <name>` — privacy-safe (no proper names; defaults to `proband-<wallet-prefix>`)
33
+
34
+ ### ACMG criteria implemented
35
+
36
+ - **PVS1** (Very Strong): null variant (frameshift, stop-gain, splice donor/acceptor, start-lost) in HPO-matched / panel gene
37
+ - **PS3**: ClinVar Pathogenic; **PS3_Supporting** for Likely Pathogenic
38
+ - **PM2_Supporting**: absent / ultra-rare in gnomAD (AF ≤ 1e-4)
39
+ - **PP3** (Pejaver-2022 calibration):
40
+ - REVEL Supporting ≥0.644 / Moderate ≥0.773 / Strong ≥0.932
41
+ - AlphaMissense ≥0.564 (Supporting)
42
+ - SpliceAI ≥0.5 / ≥0.8 (Moderate / Strong)
43
+ - SIFT damaging, PolyPhen2 hVAR damaging (Supporting)
44
+ - **PP4** (custom phenotype-gene match): patient HPO terms hit curated set for gene (Supporting=1, Moderate=≥2)
45
+ - **BA1** (Stand-alone Benign): gnomAD AF ≥ 0.05 (hard override)
46
+ - **BS1** (Strong Benign): gnomAD AF ≥ 0.01
47
+ - **BP4** (Pejaver-2022 calibrated benign thresholds): REVEL ≤0.290, AlphaMissense ≤0.340
48
+
49
+ Final classification via Pejaver/Tavtigian Bayesian-integer scoring:
50
+ - Pathogenic ≥ +8, Likely Pathogenic ≥ +6, VUS −1..+5, Likely Benign ≥ −6, Benign ≤ −7
51
+ - BA1 short-circuits to Benign
52
+
53
+ ### Output
54
+
55
+ - `<output-dir>/<case-label>__clinical_acmg.json` — full report with per-variant ACMG evidence stack
56
+ - `<output-dir>/<case-label>__clinical_acmg.html` — light-themed HTML report (per `[[feedback-no-dark-themes]]`)
57
+
58
+ ### Validation (case proband, joint 4 exomes, 2026-05-23)
59
+
60
+ - Phenotype: "skeletal disability, bone fractures, under development, wheelchair"
61
+ - HPO mapped: HP:0000924, HP:0001263, HP:0001371, HP:0001508, HP:0002355, HP:0002540, HP:0002659, HP:0002757
62
+ - 4,900 variants classified; **3 P/LP candidates**: PIGL c.494+1G>A (P, CHIME syndrome), SLC12A3 p.Asp486Ala (P, Gitelman), PGAP1 p.Lys111Glu (LP, AR intellectual disability + hereditary spastic paraplegia; 2 HPO matches).
63
+
64
+ ### Files touched
65
+
66
+ - `src/commands/clinical.ts` — new
67
+ - `src/index.ts` — registered the `clinical <biosample_serial>` command
68
+ - Server: `plugins/api_biofs_fuse.py` got a `clinical_acmg` POST handler (subprocesses to `clinical_acmg.py`)
69
+ - Server: `/home/ubuntu/Genobank_APIs/production_api/clinical_acmg/clinical_acmg.py` — analyzer
70
+
71
+ ### Privacy
72
+
73
+ Per `CLAUDE.md`: no proper names anywhere. Case label is operator-private; subject referenced by EIP-55 biowallet otherwise. No genomic bytes touch the laptop — server resolves OC sqlites via `bioroutes.inventory` (with a `biosamples.lab_internal_id` fallback for minted research serials not yet in inventory).
74
+
75
+ ---
76
+
77
+ # v3.4.0 — biofs cohort-fourier-score: cohort-scale Cosic-RRM spectral scoring (verb scaffold)
78
+
79
+ **Published**: pending the server-side `/api_biofs_fuse/cohort_fourier_score` endpoint. Client-side verb, types, and command registration are landed; npm publish blocked until the prod endpoint exists. See `docs/specs/cohort_fourier_score_endpoint.md` for the contract.
80
+
81
+ ## New verb: `biofs cohort-fourier-score`
82
+
83
+ The missing rung between single-variant `biofs fourier-score` and per-gene ClinVar `biofs cohort-train`. Computes the per-patient × per-variant Cosic-RRM spectral score matrix that Section 14.4 of the biofs-rrm internal paper proposes, at cohort scale across a list of biosample serials or a prior `cohort-acmg` cohort summary.
84
+
85
+ Per CLAUDE.md "ALL jobs originate and run through biofs-cli + biofs-node protocol": this verb is the canonical replacement for any ad-hoc gcloud SSH script that previously would have iterated sqlites on prod. Same NFT-gated, server-side, gcsfuse-mounted pattern as `cohort-acmg`. Zero genomic bytes on the laptop.
86
+
87
+ ### Per-variant output fields
88
+
89
+ For each rare-missense variant passing the filter, the verb returns:
90
+
91
+ 1. `eiip_delta` — single-residue EIIP swap magnitude (Cosic 1994 Rydberg)
92
+ 2. `window_size` — 31 default, 51 if the residue falls in a UniProt-annotated transmembrane segment
93
+ 3. `window_sum_abs_df` — windowed Σ|ΔF|(k≥1)
94
+ 4. `window_delta_energy_pct` — windowed energy change
95
+ 5. `full_spectrum_l1` — L1 distance across all bins, full protein
96
+ 6. `fc_period_aa`, `fc_snr` — family characteristic-frequency context (cached at `~/.biofs/cache/rrm/<gene>.json`)
97
+ 7. `fc_ratio_mw`, `fc_delta_energy_pct` — mutant/wildtype magnitude ratio at f_c
98
+ 8. `weighted_agg_delta_energy_pct` — weighted across top consensus peaks
99
+ 9. `fc_cache_hit`, `scoring_status` — provenance and error-handling signals
100
+
101
+ ### CLI surface
102
+
103
+ ```bash
104
+ # from a serials file
105
+ biofs cohort-fourier-score --serials cohort.txt --max-af 0.005 --include-vus
106
+
107
+ # from a prior cohort-acmg summary (recovers biowallet→serial mapping locally)
108
+ biofs cohort-fourier-score --from-acmg ./cohort_acmg_reports/cohort_summary.json
109
+
110
+ # rare-and-novel-high-AM mode (admits AM >= threshold even if absent from ClinVar)
111
+ biofs cohort-fourier-score --serials cohort.txt --include-high-am --am-threshold 0.5
112
+ ```
113
+
114
+ ### Output layout
115
+
116
+ 1. `<output-dir>/<biowallet>.json` — per-proband Cosic-RRM score matrix
117
+ 2. `<output-dir>/cohort_fourier_summary.json` — cohort-wide aggregate with `variants_per_proband`, `variants_per_gene`, `top_l1_per_biowallet`
118
+
119
+ ### What's NOT in this release
120
+
121
+ 1. Server endpoint `/api_biofs_fuse/cohort_fourier_score` (specified at `docs/specs/cohort_fourier_score_endpoint.md`, implementation owed by the next session on the prod GenoBank API).
122
+ 2. On-chain anchoring (deferred to Sprint 2 via `ClaraBatchJobNFT` + biofs-node `/agent/batch-complete`).
123
+ 3. A multi-panel cohort plot generator (deferred; users can pivot the JSON in their own notebook for now).
124
+
125
+ ### Files touched
126
+
127
+ 1. `src/commands/cohort-fourier-score.ts` — new (≈ 330 LOC)
128
+ 2. `src/lib/api/fuse-client.ts` — new `FuseFourierVariantRow`, `FuseCohortFourierPerSerial`, `FuseCohortFourierResponse` types and `cohortFourierScorePerSerial()` method
129
+ 3. `src/index.ts` — import + new `.command('cohort-fourier-score')` block after the existing `cohort-acmg` registration
130
+ 4. `docs/specs/cohort_fourier_score_endpoint.md` — endpoint contract spec (new)
131
+ 5. `package.json` — version bump 3.3.0 → 3.4.0
132
+
133
+ ---
134
+
135
+ # v3.3.0 — Zero-local-cache refactor: variants + cohort-acmg now server-side via NFT-gated API
136
+
137
+ **Published**: 2026-05-22 (pending)
138
+
139
+ ## Breaking change: the laptop no longer holds genomic bytes
140
+
141
+ Prior versions of `biofs variants` and `biofs cohort-acmg` resolved an OpenCRAVAT sqlite via biorouter, then ran `gcloud storage cp <gs:// URI> ~/.biofs/cache/cravat/<serial>.sqlite` to download the ~250-MB file to local disk before querying. A cohort of 59 probands filled 21 GB of laptop disk in the prior session.
142
+
143
+ This release deletes that pattern entirely. Both verbs now call NFT-gated server-side endpoints on `https://genobank.app/api_biofs_fuse/`:
144
+
145
+ - `GET /api_biofs_fuse/variants` — server resolves the OpenCRAVAT sqlite via the bioroutes inventory, runs sqlite3 in-process against the `/mnt/gcsfuse-bioroutes/<bucket>/<obj>.sqlite` mount, returns filtered rows as JSON. Wallet-signature-gated. Supports the full PY_QUERY_SCRIPT surface: multi-gene, multi-region, multi-AF-column cap, ClinVar filters, trio zygosity join.
146
+ - `GET /api_biofs_fuse/cohort_acmg` — batch variant of the above (still present for completeness; client now prefers per-proband parallel `variants` calls to avoid the Cloudflare 100 s edge timeout).
147
+
148
+ The Mac CLI is now a pure API client. Zero `gcloud storage cp` invocations. `~/.biofs/cache/cravat/` is never written. Patient genomic bytes never traverse the laptop.
149
+
150
+ ### Server-side `immutable=1` URI fix
151
+
152
+ gcsfuse-backed sqlite files fail plain `sqlite3.connect(path)` because sqlite's WAL handshake tries to lock the `-wal`/`-shm` sidecars and gcsfuse does not support shared write locks on FUSE-backed files. The server now opens with the `file:<path>?immutable=1` URI flag, which skips all WAL/journal/locking and works against read-only FUSE mounts. Verified working against `/mnt/gcsfuse-bioroutes/deepvariant-fastq-to-vcf-genobank-app/...`.
153
+
154
+ ## Removed (no longer needed; behaviour subsumed by the API)
155
+
156
+ - `~/.biofs/cache/cravat/` (the offending cache directory). Cleared on disk; never re-created.
157
+ - `src/commands/variants.ts` — `CACHE_DIR`, `ensureCacheDir`, `resolveOpencravatSqlite`, `downloadSqlite`, `buildPayload`, `PY_QUERY_SCRIPT`, `querySqlite`. ~225 lines deleted.
158
+ - `src/commands/cohort-acmg.ts` — `CRAVAT_CACHE`, `fetchSqliteToCache`, `extractAcmgFindings`, `resolveOpencravatPath` (and the local Python sqlite query embedded in `extractAcmgFindings`). ~150 lines deleted.
159
+
160
+ ## Flag changes
161
+
162
+ - `biofs variants --refresh` — now a no-op (kept for back-compat; the server reads fresh on every call).
163
+ - `biofs variants --sqlite-uri <gs://>` — deprecated. The server resolves the sqlite via the bioroutes inventory only; use `--job-id <timestamp>` to disambiguate when multiple sqlites exist.
164
+ - `biofs variants --with-acmg` — NEW. Attaches the ACMG-SVI evidence stack (single-tool PP3 + PVS1 + PM2 per Section 2.7 of the biofs-rrm paper) to each row.
165
+
166
+ ## How to upgrade
167
+
168
+ ```bash
169
+ npm install -g @genobank/biofs@3.3.0
170
+ ```
171
+
172
+ If you had `~/.biofs/cache/cravat/` from a previous version, delete it: `rm -rf ~/.biofs/cache/cravat/`. The directory will never be re-created.
173
+
174
+ # v3.2.0 — Annotated-variant queries + Cosic-RRM Fourier scoring + family-status fix
175
+
176
+ **Published**: 2026-05-20 (pending)
177
+
178
+ ## New verbs
179
+
180
+ - **`biofs variants <biosample_serial>`** — query the latest OpenCRAVAT sqlite for a biosample via biorouter route-check resolution. Filters on `--gene` (HUGO symbols), `--region` (chrN:start-end, hg38), `--so` (sequence-ontology terms or `all`), `--max-af` (population frequency cap across gnomAD3/4 + AllOfUs), `--clinvar` (patho/likely/vus/benign/all). Surfaces full-trio zygosity automatically when the underlying sqlite is from a joint-call: samples not in the per-variant sample-table are filled as `ref` so compound-het patterns are visible at a glance. `--sqlite-uri` and `--job-id` overrides bypass bioroutes resolution for runs not yet in inventory. Output: pretty table, TSV, or JSON; optional `--output` file.
181
+
182
+ - **`biofs fourier-score <variants>`** — Cosic Resonant Recognition Model scoring of missense variants. Takes HGVS protein descriptors (e.g. `ITGA2B:p.Val779Ala`), fetches and caches the canonical UniProt sequence, extracts an EIIP-encoded window centered on the residue (N=31 default, N=51 for known transmembrane regions on ITGA2B / ITGB3), runs an rfft via numpy, and returns the |ΔF| spectrum between wildtype and mutant: Σ|ΔF| (with and without DC), max |ΔF| non-DC bin, spectral-energy change, and the full vectorized spectrum (raw and detrended). `--plot <path.png>` renders a one-panel-per-variant figure. Useful as a biophysical complement when REVEL / AlphaMissense / PrimateAI-3D return ambiguous calls.
183
+
184
+ ## Fixed
185
+
186
+ - **`biofs family-status`** was broken since the Sequentia chain migrated off AWS in March 2026. Root cause: hardcoded `http://54.226.180.9:8545` (dead AWS IP) and a `.env` override pointing at `http://52.90.163.112:8545` with chain id `262144` (wrong). Replaced with the canonical `SEQUENTIA_NETWORK.rpc` constant (`https://seqrpc.genobank.app`, chain `15132025`). Added bioroutes.inventory enrichment so the verb is informative even for legacy (pre-Phase-G) samples that aren't on-chain yet; surfaces file-type count, lab hints (AUGenomics / Neochromosome / Color / Ultima), and total bytes.
187
+ - **`biofs annotate status`** previously failed for both GenoBank API-issued job IDs (server-side `KeyError 'job_status'`) and OpenCRAVAT native IDs (session-auth mismatch on `/submit/jobstatus/<id>`). Added a three-step fallback: if the job ID matches OC's native `YYMMDD-HHMMSS` format, read `<wallet>/<jobid>/*.status.json` directly via gcloud IAP; otherwise try OC HTTP; otherwise try the GenoBank API. Status emoji recognizer now handles the verbose `Running CADD (cadd): line N` style strings.
188
+
189
+ ## Configuration
190
+
191
+ - `.env` Sequentia block updated to canonical GCE-hosted endpoints:
192
+ - `SEQUENTIA_RPC_URL=https://seqrpc.genobank.app`
193
+ - `SEQUENTIA_CHAIN_ID=15132025`
194
+ - `SEQUENTIA_EXPLORER=https://explorer.sequentias-test.genobank.io`
195
+
196
+ ## How to upgrade
197
+
198
+ ```bash
199
+ npm install -g @genobank/biofs@3.2.0
200
+ ```
201
+
1
202
  # v2.7.1 - Security: 0 vulnerabilities (was 46)
2
203
 
3
204
  **Published**: April 17, 2026
@@ -595,467 +796,467 @@ biofs shares --graphql
595
796
 
596
797
  ---
597
798
 
598
- # v2.0.5 - Transparency & Automatic Transmission 🔍
599
-
600
- **Published**: November 5, 2025
601
-
602
- ## 🎯 Key Changes
603
-
604
- ### 1. Full Transparency Before Transmission
605
- **BEFORE**: Report sent silently in background
606
- **AFTER**: User sees **exactly what data** is being sent before transmission
607
-
608
- **New Output**:
609
- ```
610
- 📡 Data Being Transmitted to GenoBank.io:
611
- ────────────────────────────────────────────────────────────────
612
- {
613
- "biofs_version": "2.0.5",
614
- "wallet_address": "0x1faabe...",
615
- "system_info": { ... },
616
- "authentication": { ... },
617
- "connectivity": { ... }
618
- }
619
- ────────────────────────────────────────────────────────────────
620
-
621
- ✓ No sensitive data (passwords, keys, genomic data)
622
- ✓ Paths sanitized (usernames removed)
623
- ✓ Only system diagnostics for troubleshooting
624
-
625
- ⠹ Sending report to GenoBank.io support...
626
- ```
627
-
628
- ### 2. Automatic Transmission (No Manual Sharing Needed)
629
- **BEFORE**: User had to manually copy/share Report ID
630
- **AFTER**: Report automatically sent to GenoBank.io support
631
-
632
- **User sees**:
633
- ```
634
- ✅ Report Received!
635
- 📋 Report ID: 690bac123456789abcdef012
636
- GenoBank.io support can now see your diagnostics
637
- No need to manually share - we already have it!
638
- ```
639
-
640
- ### 3. Branding Consistency
641
- ✅ Fixed: All references now use "GenoBank.io" (trademark)
642
- ✅ Updated: Error messages, documentation, UI text
643
-
644
- ## 🔒 Privacy Protection
645
-
646
- - Full payload displayed before transmission
647
- - User can review exactly what's being sent
648
- - No hidden data collection
649
- - Opt-out still available: `export BIOFS_TELEMETRY=false`
650
-
651
- ## 📝 Modified Files
652
-
653
- - `src/commands/report.ts` - Added transparency display
654
- - `src/utils/errorReporter.ts` - Updated branding
655
- - All "GenoBank" → "GenoBank.io"
656
-
657
- ---
658
-
659
- # v2.0.4 - Health Check Report Command 🏥
660
-
661
- **Published**: November 5, 2025
662
-
663
- ## 🎯 New Feature: `biofs report`
664
-
665
- **NEW**: Diagnostic health check command for proactive troubleshooting!
666
-
667
- ### What It Does
668
-
669
- The `biofs report` command generates a comprehensive diagnostic report that includes:
670
- - ✅ BioFS version and system information
671
- - ✅ Authentication status (wallet, expiry)
672
- - ✅ API connectivity tests (latency measurements)
673
- - ✅ Installed genomics tools (bcftools, samtools, IGV)
674
- - ✅ BioFiles access status
675
- - ✅ Environment configuration
676
- - ✅ Detected issues with severity levels
677
-
678
- ### Usage
679
-
680
- ```bash
681
- # Generate and send health report to GenoBank
682
- biofs report
683
-
684
- # Output as JSON
685
- biofs report --json > biofs-report.json
686
-
687
- # Verbose mode
688
- biofs report --verbose
689
- ```
690
-
691
- ### What Gets Reported
692
-
693
- ```json
694
- {
695
- "biofs_version": "2.0.4",
696
- "system": {
697
- "platform": "darwin",
698
- "arch": "arm64",
699
- "node_version": "v18.16.0",
700
- "installed_tools": {
701
- "bcftools": "installed",
702
- "bionfs": "not found"
703
- }
704
- },
705
- "authentication": {
706
- "status": "authenticated",
707
- "wallet_address": "0x...",
708
- "days_until_expiry": 28
709
- },
710
- "connectivity": {
711
- "Main API": {"status": "reachable", "latency_ms": 234}
712
- },
713
- "issues": [
714
- {"severity": "warning", "category": "tools", "message": "bionfs not installed"}
715
- ]
716
- }
717
- ```
718
-
719
- ### Benefits
720
-
721
- **For Users**:
722
- - 🎯 Easy to share diagnostic info with support
723
- - 📋 Get a Report ID for support tickets
724
- - 🔍 Proactive issue detection
725
- - 📊 See system health at a glance
726
-
727
- **For GenoBank**:
728
- - 🚀 Faster troubleshooting (don't need to ask 20 questions)
729
- - 📈 Understand user environment issues
730
- - 🎯 Prioritize feature development
731
- - 💡 Improve error messages
732
-
733
- ### Privacy
734
-
735
- - ✅ No sensitive data transmitted
736
- - ✅ Paths sanitized (usernames removed)
737
- - ✅ Same privacy protections as error telemetry
738
- - ✅ Opt-out: `export BIOFS_TELEMETRY=false`
739
-
740
- ## 🔧 Modified Files
741
-
742
- - `src/commands/report.ts` - New health check command (220 lines)
743
- - `src/index.ts` - Register report command
744
- - Backend: `/run/runweb.py` - New `/api_biofs_health_report` endpoint
745
-
746
- ---
747
-
748
- # v2.0.3 - Telemetry Bug Fix (CRITICAL) 🐛
749
-
750
- **Published**: November 5, 2025
751
-
752
- ## 🐛 Critical Bug Fix
753
-
754
- **BUG**: Telemetry system in v2.0.2 was implemented but never actually triggered due to early `process.exit()` calls that bypassed the error reporter.
755
-
756
- ### What Was Broken in v2.0.2
757
- - Error reporting infrastructure was complete
758
- - But errors never reached telemetry endpoint
759
- - Early `process.exit(1)` calls bypassed `ErrorReporter`
760
-
761
- ### Fixed in v2.0.3
762
- ✅ **mount.ts**:
763
- - Line 64: `process.exit(1)` → `throw new Error()`
764
- - Line 82: `process.exit(1)` → `throw new Error()`
765
- - Line 218: `process.exit(1)` → `throw new Error()`
766
-
767
- ✅ **umount.ts**:
768
- - Line 34: `process.exit(1)` → `throw new Error()`
769
- - Line 63: `process.exit(1)` → `throw new Error()`
770
-
771
- ### Impact
772
- - ✅ Errors now properly bubble up to outer catch blocks
773
- - ✅ ErrorReporter.report() now actually gets called
774
- - ✅ Telemetry data sent to MongoDB
775
- - ✅ Remote debugging now actually works
776
-
777
- ## 🙏 Thanks
778
- Special thanks to the Mac tester who discovered this bug through comprehensive testing!
779
-
780
- ---
781
-
782
- # v2.0.2 - Remote Error Telemetry 📡
783
-
784
- **Published**: November 5, 2025
785
-
786
- ## 🎯 New Features
787
-
788
- ### Remote Error Reporting
789
- - **NEW**: Automatic error telemetry to help debug issues remotely
790
- - **NEW**: Errors from researchers' wallets automatically reported to GenoBank
791
- - **NEW**: System info and context included for faster debugging
792
- - **Privacy-First**: Sensitive data (passwords, keys, paths) automatically sanitized
793
-
794
- ### How It Works
795
- ```typescript
796
- // Errors automatically reported with:
797
- - BioFS version
798
- - Command that failed
799
- - Error message and stack
800
- - Wallet address (for support)
801
- - System info (OS, Node version, etc.)
802
- - Sanitized context (no sensitive data)
803
- ```
804
-
805
- ### Privacy & Security
806
- - ✅ Sensitive keys automatically redacted
807
- - ✅ File paths sanitized (usernames removed)
808
- - ✅ Disable with `BIOFS_TELEMETRY=false`
809
- - ✅ 3-second timeout (never blocks user)
810
- - ✅ Fails silently (never interrupts workflow)
811
-
812
- ## 🔧 Modified Files
813
-
814
- - `src/utils/errorReporter.ts` - New error reporting utility (150 lines)
815
- - `src/commands/mount.ts` - Added telemetry on mount errors
816
- - `src/commands/umount.ts` - Added telemetry on umount errors
817
- - Backend: `/run/runweb.py` - New `/api_biofs_telemetry` endpoint
818
-
819
- ## 📊 Benefits
820
-
821
- - ✅ **Faster Support**: We see exactly what went wrong
822
- - ✅ **Proactive Fixes**: Fix bugs before users report them
823
- - ✅ **Better Testing**: Learn which edge cases to test
824
- - ✅ **User Privacy**: No sensitive data transmitted
825
-
826
- ## 🔐 Opt-Out
827
-
828
- ```bash
829
- # Disable telemetry globally
830
- export BIOFS_TELEMETRY=false
831
- ```
832
-
833
- ---
834
-
835
- # v2.0.1 - NFS Mount Support (Fixed) 🚀
836
-
837
- **Published**: December 31, 2025
838
-
839
- ## 🐛 Critical Fixes
840
-
841
- **v2.0.0 was published with incorrect build** - version 2.0.1 fixes all issues:
842
-
843
- ### Fixed:
844
- - ✅ CLI now correctly displays version 2.0.1 (was showing 1.9.3)
845
- - ✅ `biofs mount --help` now shows `--method <type>` option
846
- - ✅ `biofs umount` command now registered and working
847
- - ✅ All NFS mount functionality properly included in build
848
-
849
- ### What Was Wrong in v2.0.0:
850
- - ❌ Hardcoded version strings not updated in source code
851
- - ❌ Mount command missing `--method`, `--biocid`, `--port` options
852
- - ❌ Umount command not registered in CLI
853
- - ❌ Build contained old v1.9.3 code despite package.json saying 2.0.0
854
-
855
- **Users should upgrade to 2.0.1 immediately**: `npm install -g @genobank/biofs@latest`
856
-
857
- ---
858
-
859
- # v2.0.0 - NFS Mount Support (Broken - Use 2.0.1)
860
-
861
- **Published**: December 31, 2025
862
- **Status**: ⚠️ **DEPRECATED - Use 2.0.1 instead**
863
-
864
- ## 🎉 Major Features
865
-
866
- ### True Filesystem Mount Support
867
- - **NEW**: BioNFT-gated NFS mount via `biofs mount --method nfs`
868
- - **NEW**: `biofs umount` command for unmounting filesystems
869
- - **NEW**: BioCID-specific mounting with `--biocid` option
870
- - **NEW**: Integration with BioNFS server (Go-based NFS server)
871
-
872
- ### Key Benefits
873
- - ✅ **True Filesystem Mount**: Files appear as local filesystem, not downloaded copies
874
- - ✅ **BioNFT-Gated Access**: Only users with Story Protocol license tokens can access
875
- - ✅ **On-Demand Loading**: Files fetched from S3 only when accessed
876
- - ✅ **Standard Tools Compatible**: Works with bcftools, IGV, samtools
877
- - ✅ **Fast Access**: <3s cold start, <100ms cached access
878
- - ✅ **BioCID Support**: Mount specific files using BioCID URIs
879
-
880
- ## 🆕 New Commands
881
-
882
- ### `biofs mount <mountpoint> [--method nfs|copy] [--biocid <biocid>]`
883
- Mount BioNFT-gated files as filesystem
884
-
885
- ```bash
886
- # Mount all granted files via NFS
887
- biofs mount /mnt/genomics --method nfs
888
-
889
- # Mount specific BioCID
890
- biofs mount /mnt/sample --method nfs --biocid biocid://OWNER/bioip/IP_ID
891
-
892
- # Traditional copy method (default, downloads files)
893
- biofs mount /mnt/genomics --method copy
894
- ```
895
-
896
- ### `biofs umount <mountpoint> [--force]`
897
- Unmount filesystem
898
-
899
- ```bash
900
- # Unmount filesystem
901
- biofs umount /mnt/genomics
902
-
903
- # Force unmount
904
- biofs umount /mnt/genomics --force
905
- ```
906
-
907
- ## 🏗️ Architecture
908
-
909
- BioFS 2.0.0 integrates with **BioNFS Server**:
910
-
911
- - **BioNFS Server** (Go): NFSv3/v4 protocol server with BioNFT gating
912
- - **BioCID Resolver**: Maps `biocid://` URIs to S3 paths
913
- - **BioNFT Gating**: Story Protocol license token validation
914
- - **LRU Cache**: 1GB cache for fast repeated access
915
- - **S3 Backend**: On-demand file fetching from GenoBank
916
-
917
- ## 📦 Requirements for NFS Mount
918
-
919
- 1. **BioNFS Server**: Install from `/home/ubuntu/bionfs`
920
- ```bash
921
- cd /home/ubuntu/bionfs && make install
922
- ```
923
-
924
- 2. **NFS Client**: `sudo apt-get install nfs-common`
925
-
926
- 3. **Root Access**: System mount requires sudo
927
-
928
- ## 🔄 Modified Files
929
-
930
- - `src/commands/mount.ts` - Added NFS method support (14.3 KB compiled)
931
- - `src/commands/umount.ts` - New unmount command (7.4 KB compiled)
932
- - `package.json` - Version bump to 2.0.0
933
- - `README.md` - Updated with NFS mount documentation
934
-
935
- ## ⚡ Breaking Changes
936
-
937
- **None!** Fully backward compatible with v1.x. Default behavior unchanged.
938
-
939
- ## 🐛 Bug Fixes
940
-
941
- - Improved error handling in mount/umount commands
942
- - Better file path resolution for BioCID URIs
943
- - Enhanced consent flow UX
944
-
945
- ## 📊 Performance
946
-
947
- - **Cold Start**: ~3 seconds (S3 download + license validation)
948
- - **Cached Access**: <100ms (from LRU cache)
949
- - **Cache Size**: 1GB (configurable)
950
-
951
- ## 🔐 Security
952
-
953
- - BioNFT gating with Story Protocol
954
- - Permission caching (5 min TTL)
955
- - Web3 authentication required
956
- - BioPIL license validation
957
-
958
- ---
959
-
960
- # v1.8.9 - Local BioFiles Cache System
961
-
962
- ## 🚀 Major Features
963
-
964
- ### Local BioFiles Registry Cache
965
- - **NEW**: Comprehensive local biofile registry at `~/.biofs/cache/biofiles.json`
966
- - **NEW**: Auto-discovery during `biofs login` across all platforms
967
- - **NEW**: Cache-first file listing with 50-70x performance improvement
968
- - **NEW**: `biofs files --update` flag to force refresh from blockchain/S3
969
-
970
- ### Performance
971
- - File listing: **5-7 seconds → <100ms** (instant from cache)
972
- - No API calls needed for cached files
973
- - Automatic cache refresh after 1 hour
974
-
975
- ### Cache Features
976
- - Tracks files across Story Protocol, Sequentias, Avalanche, S3, and local storage
977
- - Preserves local file paths and metadata
978
- - Smart merge strategy prevents data loss
979
- - Statistics tracking (total, tokenized, shared, by location type)
980
-
981
- ## 🔄 Updated Commands
982
-
983
- ### `biofs login`
984
- - Now automatically discovers and caches all biofiles after authentication
985
- - Displays: "Discovered X BioFiles" confirmation
986
-
987
- ### `biofs files`
988
- - Cache-first listing (instant response)
989
- - Shows cache timestamp
990
- - Add `--update` flag to force refresh
991
-
992
- ### `biofs share`
993
- - Checks cache first for file metadata (faster resolution)
994
- - Updates cache with BioCID, IP Asset ID, and sharing info
995
-
996
- ### `biofs tokenize`
997
- - Updates cache after successful tokenization
998
- - Stores BioCID, IP Asset ID, fingerprint, and license info
999
-
1000
- ## 📦 New Modules
1001
-
1002
- - `src/lib/storage/biofiles-cache.ts` - BioFilesCacheManager (310 lines)
1003
-
1004
- ## 🔧 Modified Files
1005
-
1006
- - `src/commands/login.ts` - Cache initialization
1007
- - `src/commands/biofiles.ts` - Cache-first listing
1008
- - `src/commands/share.ts` - Cache lookup and update
1009
- - `src/commands/tokenize.ts` - Cache update after tokenization
1010
-
1011
- ## 📊 Cache Structure
1012
-
1013
- ```json
1014
- {
1015
- "wallet_address": "0x...",
1016
- "last_updated": "2025-01-03T17:30:00Z",
1017
- "biofiles": [
1018
- {
1019
- "filename": "sample.vcf",
1020
- "locations": {
1021
- "s3": "production/users/0x.../sample.vcf",
1022
- "biocid": "biocid://0x.../sequentias/abc",
1023
- "story_ip": "0x...",
1024
- "local_path": "/path/to/file.vcf"
1025
- },
1026
- "metadata": {
1027
- "file_type": "variant",
1028
- "tokenized": true,
1029
- "fingerprint": "0xabc...",
1030
- "shared_with": ["0xLab..."]
1031
- }
1032
- }
1033
- ]
1034
- }
1035
- ```
1036
-
1037
- ## 🎯 Discovery Sources
1038
-
1039
- The cache aggregates biofiles from:
1040
- 1. **Story Protocol** - IP Assets on Odyssey testnet
1041
- 2. **Avalanche** - Biosample NFTs on Fuji testnet
1042
- 3. **S3 Storage** - GenoBank uploaded files
1043
- 4. **BioIP Grants** - Files shared via license tokens
1044
- 5. **Local Files** - Tracked by local_path
1045
-
1046
- ## ⚡ Breaking Changes
1047
-
1048
- None - fully backward compatible
1049
-
1050
- ## 🐛 Bug Fixes
1051
-
1052
- - Fixed TypeScript type mismatch in source field
1053
- - Improved error handling for cache operations
1054
-
1055
- ## 📝 Total Changes
1056
-
1057
- - **New code**: ~460 lines of TypeScript
1058
- - **Files created**: 1
1059
- - **Files modified**: 4
799
+ # v2.0.5 - Transparency & Automatic Transmission 🔍
800
+
801
+ **Published**: November 5, 2025
802
+
803
+ ## 🎯 Key Changes
804
+
805
+ ### 1. Full Transparency Before Transmission
806
+ **BEFORE**: Report sent silently in background
807
+ **AFTER**: User sees **exactly what data** is being sent before transmission
808
+
809
+ **New Output**:
810
+ ```
811
+ 📡 Data Being Transmitted to GenoBank.io:
812
+ ────────────────────────────────────────────────────────────────
813
+ {
814
+ "biofs_version": "2.0.5",
815
+ "wallet_address": "0x1faabe...",
816
+ "system_info": { ... },
817
+ "authentication": { ... },
818
+ "connectivity": { ... }
819
+ }
820
+ ────────────────────────────────────────────────────────────────
821
+
822
+ ✓ No sensitive data (passwords, keys, genomic data)
823
+ ✓ Paths sanitized (usernames removed)
824
+ ✓ Only system diagnostics for troubleshooting
825
+
826
+ ⠹ Sending report to GenoBank.io support...
827
+ ```
828
+
829
+ ### 2. Automatic Transmission (No Manual Sharing Needed)
830
+ **BEFORE**: User had to manually copy/share Report ID
831
+ **AFTER**: Report automatically sent to GenoBank.io support
832
+
833
+ **User sees**:
834
+ ```
835
+ ✅ Report Received!
836
+ 📋 Report ID: 690bac123456789abcdef012
837
+ GenoBank.io support can now see your diagnostics
838
+ No need to manually share - we already have it!
839
+ ```
840
+
841
+ ### 3. Branding Consistency
842
+ ✅ Fixed: All references now use "GenoBank.io" (trademark)
843
+ ✅ Updated: Error messages, documentation, UI text
844
+
845
+ ## 🔒 Privacy Protection
846
+
847
+ - Full payload displayed before transmission
848
+ - User can review exactly what's being sent
849
+ - No hidden data collection
850
+ - Opt-out still available: `export BIOFS_TELEMETRY=false`
851
+
852
+ ## 📝 Modified Files
853
+
854
+ - `src/commands/report.ts` - Added transparency display
855
+ - `src/utils/errorReporter.ts` - Updated branding
856
+ - All "GenoBank" → "GenoBank.io"
857
+
858
+ ---
859
+
860
+ # v2.0.4 - Health Check Report Command 🏥
861
+
862
+ **Published**: November 5, 2025
863
+
864
+ ## 🎯 New Feature: `biofs report`
865
+
866
+ **NEW**: Diagnostic health check command for proactive troubleshooting!
867
+
868
+ ### What It Does
869
+
870
+ The `biofs report` command generates a comprehensive diagnostic report that includes:
871
+ - ✅ BioFS version and system information
872
+ - ✅ Authentication status (wallet, expiry)
873
+ - ✅ API connectivity tests (latency measurements)
874
+ - ✅ Installed genomics tools (bcftools, samtools, IGV)
875
+ - ✅ BioFiles access status
876
+ - ✅ Environment configuration
877
+ - ✅ Detected issues with severity levels
878
+
879
+ ### Usage
880
+
881
+ ```bash
882
+ # Generate and send health report to GenoBank
883
+ biofs report
884
+
885
+ # Output as JSON
886
+ biofs report --json > biofs-report.json
887
+
888
+ # Verbose mode
889
+ biofs report --verbose
890
+ ```
891
+
892
+ ### What Gets Reported
893
+
894
+ ```json
895
+ {
896
+ "biofs_version": "2.0.4",
897
+ "system": {
898
+ "platform": "darwin",
899
+ "arch": "arm64",
900
+ "node_version": "v18.16.0",
901
+ "installed_tools": {
902
+ "bcftools": "installed",
903
+ "bionfs": "not found"
904
+ }
905
+ },
906
+ "authentication": {
907
+ "status": "authenticated",
908
+ "wallet_address": "0x...",
909
+ "days_until_expiry": 28
910
+ },
911
+ "connectivity": {
912
+ "Main API": {"status": "reachable", "latency_ms": 234}
913
+ },
914
+ "issues": [
915
+ {"severity": "warning", "category": "tools", "message": "bionfs not installed"}
916
+ ]
917
+ }
918
+ ```
919
+
920
+ ### Benefits
921
+
922
+ **For Users**:
923
+ - 🎯 Easy to share diagnostic info with support
924
+ - 📋 Get a Report ID for support tickets
925
+ - 🔍 Proactive issue detection
926
+ - 📊 See system health at a glance
927
+
928
+ **For GenoBank**:
929
+ - 🚀 Faster troubleshooting (don't need to ask 20 questions)
930
+ - 📈 Understand user environment issues
931
+ - 🎯 Prioritize feature development
932
+ - 💡 Improve error messages
933
+
934
+ ### Privacy
935
+
936
+ - ✅ No sensitive data transmitted
937
+ - ✅ Paths sanitized (usernames removed)
938
+ - ✅ Same privacy protections as error telemetry
939
+ - ✅ Opt-out: `export BIOFS_TELEMETRY=false`
940
+
941
+ ## 🔧 Modified Files
942
+
943
+ - `src/commands/report.ts` - New health check command (220 lines)
944
+ - `src/index.ts` - Register report command
945
+ - Backend: `/run/runweb.py` - New `/api_biofs_health_report` endpoint
946
+
947
+ ---
948
+
949
+ # v2.0.3 - Telemetry Bug Fix (CRITICAL) 🐛
950
+
951
+ **Published**: November 5, 2025
952
+
953
+ ## 🐛 Critical Bug Fix
954
+
955
+ **BUG**: Telemetry system in v2.0.2 was implemented but never actually triggered due to early `process.exit()` calls that bypassed the error reporter.
956
+
957
+ ### What Was Broken in v2.0.2
958
+ - Error reporting infrastructure was complete
959
+ - But errors never reached telemetry endpoint
960
+ - Early `process.exit(1)` calls bypassed `ErrorReporter`
961
+
962
+ ### Fixed in v2.0.3
963
+ ✅ **mount.ts**:
964
+ - Line 64: `process.exit(1)` → `throw new Error()`
965
+ - Line 82: `process.exit(1)` → `throw new Error()`
966
+ - Line 218: `process.exit(1)` → `throw new Error()`
967
+
968
+ ✅ **umount.ts**:
969
+ - Line 34: `process.exit(1)` → `throw new Error()`
970
+ - Line 63: `process.exit(1)` → `throw new Error()`
971
+
972
+ ### Impact
973
+ - ✅ Errors now properly bubble up to outer catch blocks
974
+ - ✅ ErrorReporter.report() now actually gets called
975
+ - ✅ Telemetry data sent to MongoDB
976
+ - ✅ Remote debugging now actually works
977
+
978
+ ## 🙏 Thanks
979
+ Special thanks to the Mac tester who discovered this bug through comprehensive testing!
980
+
981
+ ---
982
+
983
+ # v2.0.2 - Remote Error Telemetry 📡
984
+
985
+ **Published**: November 5, 2025
986
+
987
+ ## 🎯 New Features
988
+
989
+ ### Remote Error Reporting
990
+ - **NEW**: Automatic error telemetry to help debug issues remotely
991
+ - **NEW**: Errors from researchers' wallets automatically reported to GenoBank
992
+ - **NEW**: System info and context included for faster debugging
993
+ - **Privacy-First**: Sensitive data (passwords, keys, paths) automatically sanitized
994
+
995
+ ### How It Works
996
+ ```typescript
997
+ // Errors automatically reported with:
998
+ - BioFS version
999
+ - Command that failed
1000
+ - Error message and stack
1001
+ - Wallet address (for support)
1002
+ - System info (OS, Node version, etc.)
1003
+ - Sanitized context (no sensitive data)
1004
+ ```
1005
+
1006
+ ### Privacy & Security
1007
+ - ✅ Sensitive keys automatically redacted
1008
+ - ✅ File paths sanitized (usernames removed)
1009
+ - ✅ Disable with `BIOFS_TELEMETRY=false`
1010
+ - ✅ 3-second timeout (never blocks user)
1011
+ - ✅ Fails silently (never interrupts workflow)
1012
+
1013
+ ## 🔧 Modified Files
1014
+
1015
+ - `src/utils/errorReporter.ts` - New error reporting utility (150 lines)
1016
+ - `src/commands/mount.ts` - Added telemetry on mount errors
1017
+ - `src/commands/umount.ts` - Added telemetry on umount errors
1018
+ - Backend: `/run/runweb.py` - New `/api_biofs_telemetry` endpoint
1019
+
1020
+ ## 📊 Benefits
1021
+
1022
+ - ✅ **Faster Support**: We see exactly what went wrong
1023
+ - ✅ **Proactive Fixes**: Fix bugs before users report them
1024
+ - ✅ **Better Testing**: Learn which edge cases to test
1025
+ - ✅ **User Privacy**: No sensitive data transmitted
1026
+
1027
+ ## 🔐 Opt-Out
1028
+
1029
+ ```bash
1030
+ # Disable telemetry globally
1031
+ export BIOFS_TELEMETRY=false
1032
+ ```
1033
+
1034
+ ---
1035
+
1036
+ # v2.0.1 - NFS Mount Support (Fixed) 🚀
1037
+
1038
+ **Published**: December 31, 2025
1039
+
1040
+ ## 🐛 Critical Fixes
1041
+
1042
+ **v2.0.0 was published with incorrect build** - version 2.0.1 fixes all issues:
1043
+
1044
+ ### Fixed:
1045
+ - ✅ CLI now correctly displays version 2.0.1 (was showing 1.9.3)
1046
+ - ✅ `biofs mount --help` now shows `--method <type>` option
1047
+ - ✅ `biofs umount` command now registered and working
1048
+ - ✅ All NFS mount functionality properly included in build
1049
+
1050
+ ### What Was Wrong in v2.0.0:
1051
+ - ❌ Hardcoded version strings not updated in source code
1052
+ - ❌ Mount command missing `--method`, `--biocid`, `--port` options
1053
+ - ❌ Umount command not registered in CLI
1054
+ - ❌ Build contained old v1.9.3 code despite package.json saying 2.0.0
1055
+
1056
+ **Users should upgrade to 2.0.1 immediately**: `npm install -g @genobank/biofs@latest`
1057
+
1058
+ ---
1059
+
1060
+ # v2.0.0 - NFS Mount Support (Broken - Use 2.0.1)
1061
+
1062
+ **Published**: December 31, 2025
1063
+ **Status**: ⚠️ **DEPRECATED - Use 2.0.1 instead**
1064
+
1065
+ ## 🎉 Major Features
1066
+
1067
+ ### True Filesystem Mount Support
1068
+ - **NEW**: BioNFT-gated NFS mount via `biofs mount --method nfs`
1069
+ - **NEW**: `biofs umount` command for unmounting filesystems
1070
+ - **NEW**: BioCID-specific mounting with `--biocid` option
1071
+ - **NEW**: Integration with BioNFS server (Go-based NFS server)
1072
+
1073
+ ### Key Benefits
1074
+ - ✅ **True Filesystem Mount**: Files appear as local filesystem, not downloaded copies
1075
+ - ✅ **BioNFT-Gated Access**: Only users with Story Protocol license tokens can access
1076
+ - ✅ **On-Demand Loading**: Files fetched from S3 only when accessed
1077
+ - ✅ **Standard Tools Compatible**: Works with bcftools, IGV, samtools
1078
+ - ✅ **Fast Access**: <3s cold start, <100ms cached access
1079
+ - ✅ **BioCID Support**: Mount specific files using BioCID URIs
1080
+
1081
+ ## 🆕 New Commands
1082
+
1083
+ ### `biofs mount <mountpoint> [--method nfs|copy] [--biocid <biocid>]`
1084
+ Mount BioNFT-gated files as filesystem
1085
+
1086
+ ```bash
1087
+ # Mount all granted files via NFS
1088
+ biofs mount /mnt/genomics --method nfs
1089
+
1090
+ # Mount specific BioCID
1091
+ biofs mount /mnt/sample --method nfs --biocid biocid://OWNER/bioip/IP_ID
1092
+
1093
+ # Traditional copy method (default, downloads files)
1094
+ biofs mount /mnt/genomics --method copy
1095
+ ```
1096
+
1097
+ ### `biofs umount <mountpoint> [--force]`
1098
+ Unmount filesystem
1099
+
1100
+ ```bash
1101
+ # Unmount filesystem
1102
+ biofs umount /mnt/genomics
1103
+
1104
+ # Force unmount
1105
+ biofs umount /mnt/genomics --force
1106
+ ```
1107
+
1108
+ ## 🏗️ Architecture
1109
+
1110
+ BioFS 2.0.0 integrates with **BioNFS Server**:
1111
+
1112
+ - **BioNFS Server** (Go): NFSv3/v4 protocol server with BioNFT gating
1113
+ - **BioCID Resolver**: Maps `biocid://` URIs to S3 paths
1114
+ - **BioNFT Gating**: Story Protocol license token validation
1115
+ - **LRU Cache**: 1GB cache for fast repeated access
1116
+ - **S3 Backend**: On-demand file fetching from GenoBank
1117
+
1118
+ ## 📦 Requirements for NFS Mount
1119
+
1120
+ 1. **BioNFS Server**: Install from `/home/ubuntu/bionfs`
1121
+ ```bash
1122
+ cd /home/ubuntu/bionfs && make install
1123
+ ```
1124
+
1125
+ 2. **NFS Client**: `sudo apt-get install nfs-common`
1126
+
1127
+ 3. **Root Access**: System mount requires sudo
1128
+
1129
+ ## 🔄 Modified Files
1130
+
1131
+ - `src/commands/mount.ts` - Added NFS method support (14.3 KB compiled)
1132
+ - `src/commands/umount.ts` - New unmount command (7.4 KB compiled)
1133
+ - `package.json` - Version bump to 2.0.0
1134
+ - `README.md` - Updated with NFS mount documentation
1135
+
1136
+ ## ⚡ Breaking Changes
1137
+
1138
+ **None!** Fully backward compatible with v1.x. Default behavior unchanged.
1139
+
1140
+ ## 🐛 Bug Fixes
1141
+
1142
+ - Improved error handling in mount/umount commands
1143
+ - Better file path resolution for BioCID URIs
1144
+ - Enhanced consent flow UX
1145
+
1146
+ ## 📊 Performance
1147
+
1148
+ - **Cold Start**: ~3 seconds (S3 download + license validation)
1149
+ - **Cached Access**: <100ms (from LRU cache)
1150
+ - **Cache Size**: 1GB (configurable)
1151
+
1152
+ ## 🔐 Security
1153
+
1154
+ - BioNFT gating with Story Protocol
1155
+ - Permission caching (5 min TTL)
1156
+ - Web3 authentication required
1157
+ - BioPIL license validation
1158
+
1159
+ ---
1160
+
1161
+ # v1.8.9 - Local BioFiles Cache System
1162
+
1163
+ ## 🚀 Major Features
1164
+
1165
+ ### Local BioFiles Registry Cache
1166
+ - **NEW**: Comprehensive local biofile registry at `~/.biofs/cache/biofiles.json`
1167
+ - **NEW**: Auto-discovery during `biofs login` across all platforms
1168
+ - **NEW**: Cache-first file listing with 50-70x performance improvement
1169
+ - **NEW**: `biofs files --update` flag to force refresh from blockchain/S3
1170
+
1171
+ ### Performance
1172
+ - File listing: **5-7 seconds → <100ms** (instant from cache)
1173
+ - No API calls needed for cached files
1174
+ - Automatic cache refresh after 1 hour
1175
+
1176
+ ### Cache Features
1177
+ - Tracks files across Story Protocol, Sequentias, Avalanche, S3, and local storage
1178
+ - Preserves local file paths and metadata
1179
+ - Smart merge strategy prevents data loss
1180
+ - Statistics tracking (total, tokenized, shared, by location type)
1181
+
1182
+ ## 🔄 Updated Commands
1183
+
1184
+ ### `biofs login`
1185
+ - Now automatically discovers and caches all biofiles after authentication
1186
+ - Displays: "Discovered X BioFiles" confirmation
1187
+
1188
+ ### `biofs files`
1189
+ - Cache-first listing (instant response)
1190
+ - Shows cache timestamp
1191
+ - Add `--update` flag to force refresh
1192
+
1193
+ ### `biofs share`
1194
+ - Checks cache first for file metadata (faster resolution)
1195
+ - Updates cache with BioCID, IP Asset ID, and sharing info
1196
+
1197
+ ### `biofs tokenize`
1198
+ - Updates cache after successful tokenization
1199
+ - Stores BioCID, IP Asset ID, fingerprint, and license info
1200
+
1201
+ ## 📦 New Modules
1202
+
1203
+ - `src/lib/storage/biofiles-cache.ts` - BioFilesCacheManager (310 lines)
1204
+
1205
+ ## 🔧 Modified Files
1206
+
1207
+ - `src/commands/login.ts` - Cache initialization
1208
+ - `src/commands/biofiles.ts` - Cache-first listing
1209
+ - `src/commands/share.ts` - Cache lookup and update
1210
+ - `src/commands/tokenize.ts` - Cache update after tokenization
1211
+
1212
+ ## 📊 Cache Structure
1213
+
1214
+ ```json
1215
+ {
1216
+ "wallet_address": "0x...",
1217
+ "last_updated": "2025-01-03T17:30:00Z",
1218
+ "biofiles": [
1219
+ {
1220
+ "filename": "sample.vcf",
1221
+ "locations": {
1222
+ "s3": "production/users/0x.../sample.vcf",
1223
+ "biocid": "biocid://0x.../sequentias/abc",
1224
+ "story_ip": "0x...",
1225
+ "local_path": "/path/to/file.vcf"
1226
+ },
1227
+ "metadata": {
1228
+ "file_type": "variant",
1229
+ "tokenized": true,
1230
+ "fingerprint": "0xabc...",
1231
+ "shared_with": ["0xLab..."]
1232
+ }
1233
+ }
1234
+ ]
1235
+ }
1236
+ ```
1237
+
1238
+ ## 🎯 Discovery Sources
1239
+
1240
+ The cache aggregates biofiles from:
1241
+ 1. **Story Protocol** - IP Assets on Odyssey testnet
1242
+ 2. **Avalanche** - Biosample NFTs on Fuji testnet
1243
+ 3. **S3 Storage** - GenoBank uploaded files
1244
+ 4. **BioIP Grants** - Files shared via license tokens
1245
+ 5. **Local Files** - Tracked by local_path
1246
+
1247
+ ## ⚡ Breaking Changes
1248
+
1249
+ None - fully backward compatible
1250
+
1251
+ ## 🐛 Bug Fixes
1252
+
1253
+ - Fixed TypeScript type mismatch in source field
1254
+ - Improved error handling for cache operations
1255
+
1256
+ ## 📝 Total Changes
1257
+
1258
+ - **New code**: ~460 lines of TypeScript
1259
+ - **Files created**: 1
1260
+ - **Files modified**: 4
1060
1261
 
1061
1262