@nervur.org/genome 0.0.0-stage → 0.37.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1075) hide show
  1. package/LICENSE +105 -0
  2. package/README.md +28 -2
  3. package/SECURITY.md +8 -0
  4. package/cage/cells/cells.d.ts +25 -0
  5. package/cage/cells/cells.js +114 -0
  6. package/cage/cells/index.d.ts +4 -0
  7. package/cage/cells/index.js +5 -0
  8. package/cage/cells/over.d.ts +5 -0
  9. package/cage/cells/over.js +46 -0
  10. package/cage/cells/range.d.ts +31 -0
  11. package/cage/cells/range.js +226 -0
  12. package/cage/cells/reader.d.ts +17 -0
  13. package/cage/cells/reader.js +20 -0
  14. package/cage/codec/codec.d.ts +2 -0
  15. package/cage/codec/codec.js +5 -0
  16. package/cage/codec/index.d.ts +1 -0
  17. package/cage/codec/index.js +2 -0
  18. package/cage/collation/check.d.ts +7 -0
  19. package/cage/collation/check.js +24 -0
  20. package/cage/collation/collation.d.ts +9 -0
  21. package/cage/collation/collation.js +118 -0
  22. package/cage/collation/index.d.ts +3 -0
  23. package/cage/collation/index.js +4 -0
  24. package/cage/collation/order.d.ts +1 -0
  25. package/cage/collation/order.js +9 -0
  26. package/cage/fill.d.ts +8 -0
  27. package/cage/fill.js +30 -0
  28. package/cage/index.d.ts +6 -0
  29. package/cage/index.js +78 -0
  30. package/cage/lobe/apart.d.ts +34 -0
  31. package/cage/lobe/apart.js +91 -0
  32. package/cage/lobe/calls.d.ts +8 -0
  33. package/cage/lobe/calls.js +35 -0
  34. package/cage/lobe/charges.d.ts +10 -0
  35. package/cage/lobe/charges.js +42 -0
  36. package/cage/lobe/decoder.d.ts +15 -0
  37. package/cage/lobe/decoder.js +159 -0
  38. package/cage/lobe/host.d.ts +27 -0
  39. package/cage/lobe/host.js +107 -0
  40. package/cage/lobe/index.d.ts +7 -0
  41. package/cage/lobe/index.js +32 -0
  42. package/cage/lobe/quo.d.ts +3 -0
  43. package/cage/lobe/quo.js +30 -0
  44. package/cage/lobe/read.d.ts +11 -0
  45. package/cage/lobe/read.js +18 -0
  46. package/cage/lobe/runner.d.ts +45 -0
  47. package/cage/lobe/runner.js +242 -0
  48. package/cage/lobe/seams.d.ts +2 -0
  49. package/cage/lobe/seams.js +124 -0
  50. package/cage/published.d.ts +1 -0
  51. package/cage/published.js +27 -0
  52. package/cage/run/cells.d.ts +9 -0
  53. package/cage/run/cells.js +80 -0
  54. package/cage/run/codes.d.ts +19 -0
  55. package/cage/run/codes.js +101 -0
  56. package/cage/run/given.d.ts +49 -0
  57. package/cage/run/given.js +145 -0
  58. package/cage/run/host.d.ts +13 -0
  59. package/cage/run/host.js +37 -0
  60. package/cage/run/index.d.ts +4 -0
  61. package/cage/run/index.js +5 -0
  62. package/cage/run/input.d.ts +14 -0
  63. package/cage/run/input.js +138 -0
  64. package/cage/run/nest.d.ts +31 -0
  65. package/cage/run/nest.js +187 -0
  66. package/cage/run/run.d.ts +12 -0
  67. package/cage/run/run.js +79 -0
  68. package/cage/run/suspend.d.ts +14 -0
  69. package/cage/run/suspend.js +57 -0
  70. package/contracts/bridge/contract.d.ts +2 -0
  71. package/contracts/bridge/contract.js +57 -0
  72. package/contracts/bridge/index.d.ts +1 -0
  73. package/contracts/bridge/index.js +2 -0
  74. package/contracts/carriers/contract.d.ts +4 -0
  75. package/contracts/carriers/contract.js +485 -0
  76. package/contracts/carriers/index.d.ts +2 -0
  77. package/contracts/carriers/index.js +3 -0
  78. package/contracts/carriers/web.d.ts +2 -0
  79. package/contracts/carriers/web.js +231 -0
  80. package/contracts/chance/contract.d.ts +2 -0
  81. package/contracts/chance/contract.js +25 -0
  82. package/contracts/chance/index.d.ts +1 -0
  83. package/contracts/chance/index.js +2 -0
  84. package/contracts/codec/contract.d.ts +2 -0
  85. package/contracts/codec/contract.js +124 -0
  86. package/contracts/codec/index.d.ts +1 -0
  87. package/contracts/codec/index.js +2 -0
  88. package/contracts/crypto/contract.d.ts +2 -0
  89. package/contracts/crypto/contract.js +204 -0
  90. package/contracts/crypto/index.d.ts +1 -0
  91. package/contracts/crypto/index.js +2 -0
  92. package/contracts/crypto/mlkem.d.ts +2 -0
  93. package/contracts/crypto/mlkem.js +21 -0
  94. package/contracts/crypto/signatures.d.ts +2 -0
  95. package/contracts/crypto/signatures.js +165 -0
  96. package/contracts/crypto/vector.d.ts +73 -0
  97. package/contracts/crypto/vector.js +93 -0
  98. package/contracts/crypto/vectors.d.ts +2 -0
  99. package/contracts/crypto/vectors.js +107 -0
  100. package/contracts/door/contract.d.ts +13 -0
  101. package/contracts/door/contract.js +94 -0
  102. package/contracts/door/index.d.ts +1 -0
  103. package/contracts/door/index.js +2 -0
  104. package/contracts/engine/contract.d.ts +2 -0
  105. package/contracts/engine/contract.js +251 -0
  106. package/contracts/engine/held.d.ts +3 -0
  107. package/contracts/engine/held.js +52 -0
  108. package/contracts/engine/index.d.ts +1 -0
  109. package/contracts/engine/index.js +2 -0
  110. package/contracts/engine/judge.d.ts +5 -0
  111. package/contracts/engine/judge.js +28 -0
  112. package/contracts/engine/sources.d.ts +17 -0
  113. package/contracts/engine/sources.js +67 -0
  114. package/contracts/index.d.ts +14 -0
  115. package/contracts/index.js +15 -0
  116. package/contracts/lobes/contract.d.ts +8 -0
  117. package/contracts/lobes/contract.js +186 -0
  118. package/contracts/lobes/index.d.ts +1 -0
  119. package/contracts/lobes/index.js +2 -0
  120. package/contracts/page-layer/contract.d.ts +2 -0
  121. package/contracts/page-layer/contract.js +218 -0
  122. package/contracts/page-layer/index.d.ts +1 -0
  123. package/contracts/page-layer/index.js +2 -0
  124. package/contracts/queues/contract.d.ts +2 -0
  125. package/contracts/queues/contract.js +281 -0
  126. package/contracts/queues/index.d.ts +1 -0
  127. package/contracts/queues/index.js +2 -0
  128. package/contracts/queues/steps.d.ts +11 -0
  129. package/contracts/queues/steps.js +68 -0
  130. package/contracts/run/contract.d.ts +2 -0
  131. package/contracts/run/contract.js +151 -0
  132. package/contracts/run/index.d.ts +1 -0
  133. package/contracts/run/index.js +2 -0
  134. package/contracts/run/sources.d.ts +6 -0
  135. package/contracts/run/sources.js +45 -0
  136. package/contracts/time/contract.d.ts +2 -0
  137. package/contracts/time/contract.js +113 -0
  138. package/contracts/time/index.d.ts +1 -0
  139. package/contracts/time/index.js +2 -0
  140. package/contracts/unlocker/contract.d.ts +2 -0
  141. package/contracts/unlocker/contract.js +25 -0
  142. package/contracts/unlocker/index.d.ts +1 -0
  143. package/contracts/unlocker/index.js +2 -0
  144. package/contracts/vitals/contract.d.ts +2 -0
  145. package/contracts/vitals/contract.js +50 -0
  146. package/contracts/vitals/index.d.ts +1 -0
  147. package/contracts/vitals/index.js +2 -0
  148. package/docs/authoring.md +1985 -0
  149. package/docs/changelog.md +11 -0
  150. package/docs/guide.md +429 -0
  151. package/engine/bytecode.d.ts +17 -0
  152. package/engine/bytecode.js +170 -0
  153. package/engine/context.d.ts +3 -0
  154. package/engine/context.js +271 -0
  155. package/engine/decoder.d.ts +10 -0
  156. package/engine/decoder.js +286 -0
  157. package/engine/engine.d.ts +21 -0
  158. package/engine/engine.js +271 -0
  159. package/engine/heap.d.ts +5 -0
  160. package/engine/heap.js +47 -0
  161. package/engine/held.d.ts +8 -0
  162. package/engine/held.js +32 -0
  163. package/engine/helpers.d.ts +27 -0
  164. package/engine/helpers.js +177 -0
  165. package/engine/host.d.ts +3 -0
  166. package/engine/host.js +78 -0
  167. package/engine/index.d.ts +1 -0
  168. package/engine/index.js +2 -0
  169. package/engine/loader.d.ts +6 -0
  170. package/engine/loader.js +72 -0
  171. package/engine/lock.d.ts +2 -0
  172. package/engine/lock.js +17 -0
  173. package/engine/state.d.ts +55 -0
  174. package/engine/state.js +107 -0
  175. package/engine/vendor/LICENSE +24 -0
  176. package/engine/vendor/emscripten-module.d.mts +5 -0
  177. package/engine/vendor/emscripten-module.mjs +2 -0
  178. package/engine/vendor/emscripten-module.wasm +0 -0
  179. package/engine/vendor/index.d.ts +1 -0
  180. package/engine/vendor/index.js +2 -0
  181. package/engine/watcher.d.ts +2 -0
  182. package/engine/watcher.js +4 -0
  183. package/engine/writer.d.ts +4 -0
  184. package/engine/writer.js +84 -0
  185. package/engine/written.d.ts +3 -0
  186. package/engine/written.js +86 -0
  187. package/evidence/index.d.ts +2 -0
  188. package/evidence/index.js +3 -0
  189. package/evidence/read.d.ts +42 -0
  190. package/evidence/read.js +210 -0
  191. package/evidence/replay.d.ts +17 -0
  192. package/evidence/replay.js +184 -0
  193. package/faculty/base/faculty.d.ts +24 -0
  194. package/faculty/base/faculty.js +300 -0
  195. package/faculty/base/host.d.ts +140 -0
  196. package/faculty/base/host.js +82 -0
  197. package/faculty/base/index.d.ts +6 -0
  198. package/faculty/base/index.js +29 -0
  199. package/faculty/base/objects.d.ts +82 -0
  200. package/faculty/base/objects.js +79 -0
  201. package/faculty/base/run.d.ts +63 -0
  202. package/faculty/base/run.js +52 -0
  203. package/faculty/base/source.d.ts +18 -0
  204. package/faculty/base/source.js +55 -0
  205. package/faculty/base/text.d.ts +1 -0
  206. package/faculty/base/text.js +3 -0
  207. package/faculty/index.d.ts +2 -0
  208. package/faculty/index.js +52 -0
  209. package/faculty/nervur-faculty.d.ts +28 -0
  210. package/faculty/published.d.ts +1 -0
  211. package/faculty/published.js +34 -0
  212. package/faculty/read/index.d.ts +1 -0
  213. package/faculty/read/index.js +15 -0
  214. package/faculty/read/read.d.ts +32 -0
  215. package/faculty/read/read.js +109 -0
  216. package/genome/backup/backup.d.ts +35 -0
  217. package/genome/backup/backup.js +278 -0
  218. package/genome/backup/file.d.ts +19 -0
  219. package/genome/backup/file.js +66 -0
  220. package/genome/backup/form.d.ts +11 -0
  221. package/genome/backup/form.js +339 -0
  222. package/genome/backup/held.d.ts +14 -0
  223. package/genome/backup/held.js +123 -0
  224. package/genome/backup/index.d.ts +6 -0
  225. package/genome/backup/index.js +29 -0
  226. package/genome/backup/kept.d.ts +117 -0
  227. package/genome/backup/kept.js +386 -0
  228. package/genome/backup/named.d.ts +6 -0
  229. package/genome/backup/named.js +70 -0
  230. package/genome/boot/anchor.d.ts +4 -0
  231. package/genome/boot/anchor.js +35 -0
  232. package/genome/boot/boot.d.ts +33 -0
  233. package/genome/boot/boot.js +223 -0
  234. package/genome/boot/channel.d.ts +11 -0
  235. package/genome/boot/channel.js +32 -0
  236. package/genome/boot/core.d.ts +17 -0
  237. package/genome/boot/core.js +80 -0
  238. package/genome/boot/given.d.ts +15 -0
  239. package/genome/boot/given.js +59 -0
  240. package/genome/boot/index.d.ts +5 -0
  241. package/genome/boot/index.js +6 -0
  242. package/genome/boot/invitation.d.ts +9 -0
  243. package/genome/boot/invitation.js +40 -0
  244. package/genome/boot/moved.d.ts +17 -0
  245. package/genome/boot/moved.js +133 -0
  246. package/genome/boot/organs.d.ts +8 -0
  247. package/genome/boot/organs.js +62 -0
  248. package/genome/boot/present.d.ts +34 -0
  249. package/genome/boot/present.js +136 -0
  250. package/genome/boot/renew.d.ts +13 -0
  251. package/genome/boot/renew.js +24 -0
  252. package/genome/boot/shelf.d.ts +16 -0
  253. package/genome/boot/shelf.js +60 -0
  254. package/genome/boot/skin.d.ts +14 -0
  255. package/genome/boot/skin.js +66 -0
  256. package/genome/brain/accept.d.ts +12 -0
  257. package/genome/brain/accept.js +120 -0
  258. package/genome/brain/addresses.d.ts +4 -0
  259. package/genome/brain/addresses.js +32 -0
  260. package/genome/brain/anchor.d.ts +22 -0
  261. package/genome/brain/anchor.js +155 -0
  262. package/genome/brain/askers.d.ts +5 -0
  263. package/genome/brain/askers.js +25 -0
  264. package/genome/brain/assets-method.d.ts +3 -0
  265. package/genome/brain/assets-method.js +28 -0
  266. package/genome/brain/assets.d.ts +4 -0
  267. package/genome/brain/assets.js +61 -0
  268. package/genome/brain/blueprint.d.ts +5 -0
  269. package/genome/brain/blueprint.js +528 -0
  270. package/genome/brain/brain.d.ts +19 -0
  271. package/genome/brain/brain.js +291 -0
  272. package/genome/brain/cede.d.ts +7 -0
  273. package/genome/brain/cede.js +179 -0
  274. package/genome/brain/changes.d.ts +23 -0
  275. package/genome/brain/changes.js +91 -0
  276. package/genome/brain/character.d.ts +8 -0
  277. package/genome/brain/character.js +55 -0
  278. package/genome/brain/children.d.ts +7 -0
  279. package/genome/brain/children.js +37 -0
  280. package/genome/brain/clock.d.ts +18 -0
  281. package/genome/brain/clock.js +91 -0
  282. package/genome/brain/ended.d.ts +3 -0
  283. package/genome/brain/ended.js +21 -0
  284. package/genome/brain/ends.d.ts +9 -0
  285. package/genome/brain/ends.js +109 -0
  286. package/genome/brain/expiry.d.ts +21 -0
  287. package/genome/brain/expiry.js +87 -0
  288. package/genome/brain/faculties.d.ts +16 -0
  289. package/genome/brain/faculties.js +88 -0
  290. package/genome/brain/far.d.ts +53 -0
  291. package/genome/brain/far.js +330 -0
  292. package/genome/brain/fields.d.ts +1 -0
  293. package/genome/brain/fields.js +5 -0
  294. package/genome/brain/genome.d.ts +8 -0
  295. package/genome/brain/genome.js +46 -0
  296. package/genome/brain/given.d.ts +4 -0
  297. package/genome/brain/given.js +15 -0
  298. package/genome/brain/granting.d.ts +23 -0
  299. package/genome/brain/granting.js +98 -0
  300. package/genome/brain/grants.d.ts +20 -0
  301. package/genome/brain/grants.js +70 -0
  302. package/genome/brain/guide.d.ts +2 -0
  303. package/genome/brain/guide.js +5 -0
  304. package/genome/brain/holds.d.ts +48 -0
  305. package/genome/brain/holds.js +197 -0
  306. package/genome/brain/index.d.ts +34 -0
  307. package/genome/brain/index.js +35 -0
  308. package/genome/brain/invitations.d.ts +6 -0
  309. package/genome/brain/invitations.js +80 -0
  310. package/genome/brain/kept.d.ts +32 -0
  311. package/genome/brain/kept.js +189 -0
  312. package/genome/brain/kit.d.ts +85 -0
  313. package/genome/brain/kit.js +101 -0
  314. package/genome/brain/landing.d.ts +6 -0
  315. package/genome/brain/landing.js +45 -0
  316. package/genome/brain/lapses.d.ts +8 -0
  317. package/genome/brain/lapses.js +53 -0
  318. package/genome/brain/letters.d.ts +8 -0
  319. package/genome/brain/letters.js +67 -0
  320. package/genome/brain/life.d.ts +24 -0
  321. package/genome/brain/life.js +205 -0
  322. package/genome/brain/limits.d.ts +14 -0
  323. package/genome/brain/limits.js +159 -0
  324. package/genome/brain/lined.d.ts +23 -0
  325. package/genome/brain/lined.js +90 -0
  326. package/genome/brain/marks.d.ts +22 -0
  327. package/genome/brain/marks.js +47 -0
  328. package/genome/brain/methods.d.ts +7 -0
  329. package/genome/brain/methods.js +243 -0
  330. package/genome/brain/mouth.d.ts +38 -0
  331. package/genome/brain/mouth.js +302 -0
  332. package/genome/brain/moves.d.ts +14 -0
  333. package/genome/brain/moves.js +81 -0
  334. package/genome/brain/nerves.d.ts +12 -0
  335. package/genome/brain/nerves.js +267 -0
  336. package/genome/brain/next.d.ts +6 -0
  337. package/genome/brain/next.js +25 -0
  338. package/genome/brain/notes.d.ts +9 -0
  339. package/genome/brain/notes.js +73 -0
  340. package/genome/brain/occupants.d.ts +7 -0
  341. package/genome/brain/occupants.js +79 -0
  342. package/genome/brain/old.d.ts +4 -0
  343. package/genome/brain/old.js +44 -0
  344. package/genome/brain/organ.d.ts +42 -0
  345. package/genome/brain/organ.js +248 -0
  346. package/genome/brain/organs.d.ts +28 -0
  347. package/genome/brain/organs.js +100 -0
  348. package/genome/brain/owed.d.ts +30 -0
  349. package/genome/brain/owed.js +58 -0
  350. package/genome/brain/owners.d.ts +15 -0
  351. package/genome/brain/owners.js +112 -0
  352. package/genome/brain/paged.d.ts +10 -0
  353. package/genome/brain/paged.js +26 -0
  354. package/genome/brain/pieces.d.ts +15 -0
  355. package/genome/brain/pieces.js +74 -0
  356. package/genome/brain/presence.d.ts +14 -0
  357. package/genome/brain/presence.js +111 -0
  358. package/genome/brain/reclaim.d.ts +7 -0
  359. package/genome/brain/reclaim.js +28 -0
  360. package/genome/brain/recovery.d.ts +34 -0
  361. package/genome/brain/recovery.js +165 -0
  362. package/genome/brain/reference-methods.d.ts +4 -0
  363. package/genome/brain/reference-methods.js +62 -0
  364. package/genome/brain/references.d.ts +22 -0
  365. package/genome/brain/references.js +128 -0
  366. package/genome/brain/reflex.d.ts +19 -0
  367. package/genome/brain/reflex.js +64 -0
  368. package/genome/brain/relations.d.ts +61 -0
  369. package/genome/brain/relations.js +320 -0
  370. package/genome/brain/road.d.ts +3 -0
  371. package/genome/brain/road.js +30 -0
  372. package/genome/brain/roll.d.ts +27 -0
  373. package/genome/brain/roll.js +144 -0
  374. package/genome/brain/schemas.d.ts +23 -0
  375. package/genome/brain/schemas.js +296 -0
  376. package/genome/brain/silence.d.ts +9 -0
  377. package/genome/brain/silence.js +30 -0
  378. package/genome/brain/space.d.ts +17 -0
  379. package/genome/brain/space.js +70 -0
  380. package/genome/brain/standing-methods.d.ts +4 -0
  381. package/genome/brain/standing-methods.js +78 -0
  382. package/genome/brain/standings.d.ts +57 -0
  383. package/genome/brain/standings.js +161 -0
  384. package/genome/brain/state.d.ts +66 -0
  385. package/genome/brain/state.js +322 -0
  386. package/genome/brain/still.d.ts +33 -0
  387. package/genome/brain/still.js +84 -0
  388. package/genome/brain/switch.d.ts +6 -0
  389. package/genome/brain/switch.js +24 -0
  390. package/genome/brain/tear.d.ts +14 -0
  391. package/genome/brain/tear.js +114 -0
  392. package/genome/brain/toward.d.ts +3 -0
  393. package/genome/brain/toward.js +21 -0
  394. package/genome/brain/upgrade.d.ts +3 -0
  395. package/genome/brain/upgrade.js +18 -0
  396. package/genome/brain/uses.d.ts +12 -0
  397. package/genome/brain/uses.js +62 -0
  398. package/genome/brain/version.d.ts +33 -0
  399. package/genome/brain/version.js +405 -0
  400. package/genome/brain/waiting.d.ts +3 -0
  401. package/genome/brain/waiting.js +27 -0
  402. package/genome/brain/wake.d.ts +26 -0
  403. package/genome/brain/wake.js +112 -0
  404. package/genome/brain/warded.d.ts +7 -0
  405. package/genome/brain/warded.js +67 -0
  406. package/genome/brain/wards.d.ts +14 -0
  407. package/genome/brain/wards.js +52 -0
  408. package/genome/brain/whole.d.ts +3 -0
  409. package/genome/brain/whole.js +136 -0
  410. package/genome/bridge/again.d.ts +9 -0
  411. package/genome/bridge/again.js +111 -0
  412. package/genome/bridge/carried.d.ts +10 -0
  413. package/genome/bridge/carried.js +165 -0
  414. package/genome/bridge/frames.d.ts +3 -0
  415. package/genome/bridge/frames.js +7 -0
  416. package/genome/bridge/gear.d.ts +19 -0
  417. package/genome/bridge/gear.js +26 -0
  418. package/genome/bridge/half.d.ts +12 -0
  419. package/genome/bridge/half.js +144 -0
  420. package/genome/bridge/index.d.ts +4 -0
  421. package/genome/bridge/index.js +5 -0
  422. package/genome/cache/cache.d.ts +20 -0
  423. package/genome/cache/cache.js +213 -0
  424. package/genome/cache/index.d.ts +3 -0
  425. package/genome/cache/index.js +4 -0
  426. package/genome/cache/snapshot.d.ts +17 -0
  427. package/genome/cache/snapshot.js +164 -0
  428. package/genome/cache/spaces.d.ts +14 -0
  429. package/genome/cache/spaces.js +91 -0
  430. package/genome/cage/index.d.ts +2 -0
  431. package/genome/cage/index.js +3 -0
  432. package/genome/cage/output.d.ts +3 -0
  433. package/genome/cage/output.js +75 -0
  434. package/genome/cage/reader.d.ts +10 -0
  435. package/genome/cage/reader.js +65 -0
  436. package/genome/cage/runner.d.ts +5 -0
  437. package/genome/cage/runner.js +157 -0
  438. package/genome/carry/apart.d.ts +24 -0
  439. package/genome/carry/apart.js +170 -0
  440. package/genome/carry/before.d.ts +22 -0
  441. package/genome/carry/before.js +86 -0
  442. package/genome/carry/carry.d.ts +6 -0
  443. package/genome/carry/carry.js +447 -0
  444. package/genome/carry/count.d.ts +72 -0
  445. package/genome/carry/count.js +142 -0
  446. package/genome/carry/dead.d.ts +17 -0
  447. package/genome/carry/dead.js +53 -0
  448. package/genome/carry/disconnect.d.ts +3 -0
  449. package/genome/carry/disconnect.js +21 -0
  450. package/genome/carry/durable.d.ts +36 -0
  451. package/genome/carry/durable.js +148 -0
  452. package/genome/carry/flight.d.ts +50 -0
  453. package/genome/carry/flight.js +338 -0
  454. package/genome/carry/flush.d.ts +12 -0
  455. package/genome/carry/flush.js +37 -0
  456. package/genome/carry/gear.d.ts +91 -0
  457. package/genome/carry/gear.js +164 -0
  458. package/genome/carry/held.d.ts +66 -0
  459. package/genome/carry/held.js +174 -0
  460. package/genome/carry/index.d.ts +15 -0
  461. package/genome/carry/index.js +38 -0
  462. package/genome/carry/letters.d.ts +31 -0
  463. package/genome/carry/letters.js +222 -0
  464. package/genome/carry/moving.d.ts +21 -0
  465. package/genome/carry/moving.js +179 -0
  466. package/genome/carry/organ.d.ts +25 -0
  467. package/genome/carry/organ.js +97 -0
  468. package/genome/carry/read.d.ts +4 -0
  469. package/genome/carry/read.js +24 -0
  470. package/genome/carry/ready.d.ts +26 -0
  471. package/genome/carry/ready.js +78 -0
  472. package/genome/carry/run.d.ts +22 -0
  473. package/genome/carry/run.js +146 -0
  474. package/genome/carry/shown.d.ts +4 -0
  475. package/genome/carry/shown.js +66 -0
  476. package/genome/carry/sick.d.ts +5 -0
  477. package/genome/carry/sick.js +37 -0
  478. package/genome/carry/span.d.ts +1 -0
  479. package/genome/carry/span.js +3 -0
  480. package/genome/carry/stamp.d.ts +3 -0
  481. package/genome/carry/stamp.js +19 -0
  482. package/genome/carry/standing.d.ts +7 -0
  483. package/genome/carry/standing.js +37 -0
  484. package/genome/carry/status.d.ts +12 -0
  485. package/genome/carry/status.js +36 -0
  486. package/genome/carry/still.d.ts +29 -0
  487. package/genome/carry/still.js +76 -0
  488. package/genome/carry/trace.d.ts +8 -0
  489. package/genome/carry/trace.js +24 -0
  490. package/genome/carry/waits.d.ts +20 -0
  491. package/genome/carry/waits.js +138 -0
  492. package/genome/carry/wire.d.ts +23 -0
  493. package/genome/carry/wire.js +47 -0
  494. package/genome/carry/words.d.ts +1 -0
  495. package/genome/carry/words.js +3 -0
  496. package/genome/carry/zero.d.ts +6 -0
  497. package/genome/carry/zero.js +27 -0
  498. package/genome/cells/digest.d.ts +8 -0
  499. package/genome/cells/digest.js +86 -0
  500. package/genome/cells/index.d.ts +2 -0
  501. package/genome/cells/index.js +15 -0
  502. package/genome/cells/rows.d.ts +18 -0
  503. package/genome/cells/rows.js +63 -0
  504. package/genome/cells/sum.d.ts +6 -0
  505. package/genome/cells/sum.js +35 -0
  506. package/genome/commits/commits.d.ts +20 -0
  507. package/genome/commits/commits.js +77 -0
  508. package/genome/commits/index.d.ts +1 -0
  509. package/genome/commits/index.js +2 -0
  510. package/genome/configuration/configuration.d.ts +2 -0
  511. package/genome/configuration/configuration.js +98 -0
  512. package/genome/configuration/index.d.ts +1 -0
  513. package/genome/configuration/index.js +2 -0
  514. package/genome/defaults/index.d.ts +4 -0
  515. package/genome/defaults/index.js +12 -0
  516. package/genome/entry/entry.d.ts +4 -0
  517. package/genome/entry/entry.js +27 -0
  518. package/genome/entry/halves.d.ts +6 -0
  519. package/genome/entry/halves.js +43 -0
  520. package/genome/entry/index.d.ts +2 -0
  521. package/genome/entry/index.js +3 -0
  522. package/genome/faculties/defaults/index.d.ts +5 -0
  523. package/genome/faculties/defaults/index.js +11 -0
  524. package/genome/faculties/ear/blueprint.d.ts +2 -0
  525. package/genome/faculties/ear/blueprint.js +254 -0
  526. package/genome/faculties/ear/ear.d.ts +18 -0
  527. package/genome/faculties/ear/ear.js +775 -0
  528. package/genome/faculties/ear/index.d.ts +2 -0
  529. package/genome/faculties/ear/index.js +3 -0
  530. package/genome/faculties/ear/source.d.ts +1 -0
  531. package/genome/faculties/ear/source.js +5 -0
  532. package/genome/faculties/ear/text.d.ts +1 -0
  533. package/genome/faculties/ear/text.js +3 -0
  534. package/genome/faculties/library/blueprint.d.ts +2 -0
  535. package/genome/faculties/library/blueprint.js +271 -0
  536. package/genome/faculties/library/index.d.ts +4 -0
  537. package/genome/faculties/library/index.js +5 -0
  538. package/genome/faculties/library/library.d.ts +26 -0
  539. package/genome/faculties/library/library.js +1227 -0
  540. package/genome/faculties/library/shelf.d.ts +15 -0
  541. package/genome/faculties/library/shelf.js +20 -0
  542. package/genome/faculties/library/source.d.ts +1 -0
  543. package/genome/faculties/library/source.js +5 -0
  544. package/genome/faculties/library/text.d.ts +1 -0
  545. package/genome/faculties/library/text.js +3 -0
  546. package/genome/faculties/mouth/blueprint.d.ts +2 -0
  547. package/genome/faculties/mouth/blueprint.js +171 -0
  548. package/genome/faculties/mouth/index.d.ts +2 -0
  549. package/genome/faculties/mouth/index.js +3 -0
  550. package/genome/faculties/mouth/mouth.d.ts +16 -0
  551. package/genome/faculties/mouth/mouth.js +543 -0
  552. package/genome/faculties/mouth/source.d.ts +1 -0
  553. package/genome/faculties/mouth/source.js +5 -0
  554. package/genome/faculties/mouth/text.d.ts +1 -0
  555. package/genome/faculties/mouth/text.js +3 -0
  556. package/genome/faculties/scheduler/blueprint.d.ts +2 -0
  557. package/genome/faculties/scheduler/blueprint.js +92 -0
  558. package/genome/faculties/scheduler/index.d.ts +2 -0
  559. package/genome/faculties/scheduler/index.js +3 -0
  560. package/genome/faculties/scheduler/scheduler.d.ts +13 -0
  561. package/genome/faculties/scheduler/scheduler.js +253 -0
  562. package/genome/faculties/scheduler/source.d.ts +1 -0
  563. package/genome/faculties/scheduler/source.js +5 -0
  564. package/genome/faculties/scheduler/text.d.ts +1 -0
  565. package/genome/faculties/scheduler/text.js +3 -0
  566. package/genome/header/file.d.ts +33 -0
  567. package/genome/header/file.js +121 -0
  568. package/genome/header/header.d.ts +11 -0
  569. package/genome/header/header.js +86 -0
  570. package/genome/header/index.d.ts +2 -0
  571. package/genome/header/index.js +19 -0
  572. package/genome/ids/ids.d.ts +11 -0
  573. package/genome/ids/ids.js +23 -0
  574. package/genome/ids/index.d.ts +1 -0
  575. package/genome/ids/index.js +2 -0
  576. package/genome/index.d.ts +11 -0
  577. package/genome/index.js +32 -0
  578. package/genome/key/arrivals.d.ts +7 -0
  579. package/genome/key/arrivals.js +148 -0
  580. package/genome/key/asks.d.ts +7 -0
  581. package/genome/key/asks.js +92 -0
  582. package/genome/key/blueprint.d.ts +3 -0
  583. package/genome/key/blueprint.js +149 -0
  584. package/genome/key/door.d.ts +12 -0
  585. package/genome/key/door.js +94 -0
  586. package/genome/key/forms.d.ts +11 -0
  587. package/genome/key/forms.js +45 -0
  588. package/genome/key/handed.d.ts +7 -0
  589. package/genome/key/handed.js +81 -0
  590. package/genome/key/index.d.ts +9 -0
  591. package/genome/key/index.js +18 -0
  592. package/genome/key/key.d.ts +9 -0
  593. package/genome/key/key.js +34 -0
  594. package/genome/key/kit.d.ts +27 -0
  595. package/genome/key/kit.js +85 -0
  596. package/genome/key/records.d.ts +12 -0
  597. package/genome/key/records.js +70 -0
  598. package/genome/key/row.d.ts +4 -0
  599. package/genome/key/row.js +22 -0
  600. package/genome/key/shapes.d.ts +54 -0
  601. package/genome/key/shapes.js +160 -0
  602. package/genome/key/standing.d.ts +19 -0
  603. package/genome/key/standing.js +108 -0
  604. package/genome/log/frame.d.ts +11 -0
  605. package/genome/log/frame.js +40 -0
  606. package/genome/log/index.d.ts +3 -0
  607. package/genome/log/index.js +12 -0
  608. package/genome/log/open.d.ts +31 -0
  609. package/genome/log/open.js +243 -0
  610. package/genome/log/pairs.d.ts +8 -0
  611. package/genome/log/pairs.js +187 -0
  612. package/genome/log/record.d.ts +8 -0
  613. package/genome/log/record.js +72 -0
  614. package/genome/log/store.d.ts +31 -0
  615. package/genome/log/store.js +291 -0
  616. package/genome/map/declare.d.ts +4 -0
  617. package/genome/map/declare.js +52 -0
  618. package/genome/map/handler.d.ts +4 -0
  619. package/genome/map/handler.js +37 -0
  620. package/genome/map/index.d.ts +8 -0
  621. package/genome/map/index.js +9 -0
  622. package/genome/map/kin.d.ts +12 -0
  623. package/genome/map/kin.js +63 -0
  624. package/genome/map/map.d.ts +40 -0
  625. package/genome/map/map.js +217 -0
  626. package/genome/map/nodes.d.ts +9 -0
  627. package/genome/map/nodes.js +35 -0
  628. package/genome/map/off.d.ts +3 -0
  629. package/genome/map/off.js +10 -0
  630. package/genome/map/order.d.ts +9 -0
  631. package/genome/map/order.js +105 -0
  632. package/genome/map/read.d.ts +4 -0
  633. package/genome/map/read.js +32 -0
  634. package/genome/map/remove.d.ts +3 -0
  635. package/genome/map/remove.js +30 -0
  636. package/genome/map/rows.d.ts +48 -0
  637. package/genome/map/rows.js +146 -0
  638. package/genome/map/skin.d.ts +10 -0
  639. package/genome/map/skin.js +35 -0
  640. package/genome/map/stands.d.ts +5 -0
  641. package/genome/map/stands.js +17 -0
  642. package/genome/map/unwired.d.ts +7 -0
  643. package/genome/map/unwired.js +36 -0
  644. package/genome/map/wires.d.ts +9 -0
  645. package/genome/map/wires.js +103 -0
  646. package/genome/network/blueprint.d.ts +4 -0
  647. package/genome/network/blueprint.js +111 -0
  648. package/genome/network/index.d.ts +3 -0
  649. package/genome/network/index.js +4 -0
  650. package/genome/network/network.d.ts +18 -0
  651. package/genome/network/network.js +248 -0
  652. package/genome/network/sent.d.ts +4 -0
  653. package/genome/network/sent.js +225 -0
  654. package/genome/network/served.d.ts +4 -0
  655. package/genome/network/served.js +162 -0
  656. package/genome/network/still.d.ts +26 -0
  657. package/genome/network/still.js +46 -0
  658. package/genome/network/web.d.ts +59 -0
  659. package/genome/network/web.js +74 -0
  660. package/genome/organism/body.d.ts +53 -0
  661. package/genome/organism/body.js +256 -0
  662. package/genome/organism/halves.d.ts +22 -0
  663. package/genome/organism/halves.js +181 -0
  664. package/genome/organism/index.d.ts +5 -0
  665. package/genome/organism/index.js +6 -0
  666. package/genome/organism/made.d.ts +73 -0
  667. package/genome/organism/made.js +414 -0
  668. package/genome/organism/organism.d.ts +9 -0
  669. package/genome/organism/organism.js +203 -0
  670. package/genome/organism/reclaim.d.ts +10 -0
  671. package/genome/organism/reclaim.js +41 -0
  672. package/genome/organism/still.d.ts +12 -0
  673. package/genome/organism/still.js +38 -0
  674. package/genome/organism/thaw.d.ts +10 -0
  675. package/genome/organism/thaw.js +23 -0
  676. package/genome/organism/told.d.ts +10 -0
  677. package/genome/organism/told.js +140 -0
  678. package/genome/pages/codes.d.ts +13 -0
  679. package/genome/pages/codes.js +16 -0
  680. package/genome/pages/file.d.ts +23 -0
  681. package/genome/pages/file.js +174 -0
  682. package/genome/pages/index.d.ts +2 -0
  683. package/genome/pages/index.js +3 -0
  684. package/genome/pages/vfs.d.ts +13 -0
  685. package/genome/pages/vfs.js +186 -0
  686. package/genome/presence/index.d.ts +1 -0
  687. package/genome/presence/index.js +2 -0
  688. package/genome/presence/organs.d.ts +8 -0
  689. package/genome/presence/organs.js +13 -0
  690. package/genome/pure/entry.d.ts +16 -0
  691. package/genome/pure/entry.js +76 -0
  692. package/genome/pure/frozen.d.ts +9 -0
  693. package/genome/pure/frozen.js +273 -0
  694. package/genome/pure/halves.d.ts +8 -0
  695. package/genome/pure/halves.js +62 -0
  696. package/genome/pure/index.d.ts +7 -0
  697. package/genome/pure/index.js +8 -0
  698. package/genome/queues/index.d.ts +1 -0
  699. package/genome/queues/index.js +2 -0
  700. package/genome/queues/queues.d.ts +2 -0
  701. package/genome/queues/queues.js +210 -0
  702. package/genome/self/blueprint.d.ts +5 -0
  703. package/genome/self/blueprint.js +36 -0
  704. package/genome/self/index.d.ts +2 -0
  705. package/genome/self/index.js +3 -0
  706. package/genome/self/self.d.ts +9 -0
  707. package/genome/self/self.js +49 -0
  708. package/genome/sqlite/database.d.ts +24 -0
  709. package/genome/sqlite/database.js +243 -0
  710. package/genome/sqlite/decoder.d.ts +10 -0
  711. package/genome/sqlite/decoder.js +92 -0
  712. package/genome/sqlite/imports.d.ts +9 -0
  713. package/genome/sqlite/imports.js +93 -0
  714. package/genome/sqlite/index.d.ts +6 -0
  715. package/genome/sqlite/index.js +7 -0
  716. package/genome/sqlite/memory.d.ts +14 -0
  717. package/genome/sqlite/memory.js +79 -0
  718. package/genome/sqlite/sqlite.d.ts +30 -0
  719. package/genome/sqlite/sqlite.js +77 -0
  720. package/genome/sqlite/table.d.ts +8 -0
  721. package/genome/sqlite/table.js +66 -0
  722. package/genome/sqlite/vendor/LICENSE +21 -0
  723. package/genome/sqlite/vendor/sqlite3.wasm +0 -0
  724. package/genome/store/index.d.ts +6 -0
  725. package/genome/store/index.js +16 -0
  726. package/genome/store/landing.d.ts +6 -0
  727. package/genome/store/landing.js +50 -0
  728. package/genome/store/open.d.ts +37 -0
  729. package/genome/store/open.js +301 -0
  730. package/genome/store/outside.d.ts +30 -0
  731. package/genome/store/outside.js +164 -0
  732. package/genome/store/reading.d.ts +2 -0
  733. package/genome/store/reading.js +121 -0
  734. package/genome/store/rescue.d.ts +15 -0
  735. package/genome/store/rescue.js +168 -0
  736. package/genome/store/salvage.d.ts +18 -0
  737. package/genome/store/salvage.js +158 -0
  738. package/genome/store/schema.d.ts +17 -0
  739. package/genome/store/schema.js +77 -0
  740. package/genome/store/store.d.ts +53 -0
  741. package/genome/store/store.js +531 -0
  742. package/genome/store/unwritten.d.ts +2 -0
  743. package/genome/store/unwritten.js +57 -0
  744. package/genome/store/witness.d.ts +17 -0
  745. package/genome/store/witness.js +87 -0
  746. package/genome/timer/index.d.ts +1 -0
  747. package/genome/timer/index.js +2 -0
  748. package/genome/timer/timer.d.ts +10 -0
  749. package/genome/timer/timer.js +167 -0
  750. package/kit/brain/organs.d.ts +6 -0
  751. package/kit/brain/organs.js +33 -0
  752. package/kit/brain/rig.d.ts +58 -0
  753. package/kit/brain/rig.js +259 -0
  754. package/kit/brain/shelf.d.ts +3 -0
  755. package/kit/brain/shelf.js +42 -0
  756. package/kit/core/answers.d.ts +7 -0
  757. package/kit/core/answers.js +23 -0
  758. package/kit/core/chance.d.ts +4 -0
  759. package/kit/core/chance.js +18 -0
  760. package/kit/core/clock.d.ts +8 -0
  761. package/kit/core/clock.js +39 -0
  762. package/kit/core/configuration.d.ts +2 -0
  763. package/kit/core/configuration.js +17 -0
  764. package/kit/core/data.d.ts +3 -0
  765. package/kit/core/data.js +41 -0
  766. package/kit/core/foundation.d.ts +30 -0
  767. package/kit/core/foundation.js +139 -0
  768. package/kit/core/held.d.ts +11 -0
  769. package/kit/core/held.js +82 -0
  770. package/kit/core/index.d.ts +10 -0
  771. package/kit/core/index.js +26 -0
  772. package/kit/core/puppets.d.ts +8 -0
  773. package/kit/core/puppets.js +17 -0
  774. package/kit/core/stamp.d.ts +2 -0
  775. package/kit/core/stamp.js +10 -0
  776. package/kit/core/wasm.d.ts +3 -0
  777. package/kit/core/wasm.js +11 -0
  778. package/kit/faculty/base/rig.d.ts +22 -0
  779. package/kit/faculty/base/rig.js +97 -0
  780. package/kit/index.d.ts +11 -0
  781. package/kit/index.js +22 -0
  782. package/kit/organism/bakery.d.ts +31 -0
  783. package/kit/organism/bakery.js +223 -0
  784. package/kit/organism/carriers.d.ts +25 -0
  785. package/kit/organism/carriers.js +93 -0
  786. package/kit/organism/forms.d.ts +10 -0
  787. package/kit/organism/forms.js +31 -0
  788. package/kit/organism/heard.d.ts +4 -0
  789. package/kit/organism/heard.js +42 -0
  790. package/kit/organism/laid.d.ts +8 -0
  791. package/kit/organism/laid.js +32 -0
  792. package/kit/organism/link.d.ts +14 -0
  793. package/kit/organism/link.js +130 -0
  794. package/kit/organism/notes.d.ts +2 -0
  795. package/kit/organism/notes.js +45 -0
  796. package/kit/organism/peer.d.ts +7 -0
  797. package/kit/organism/peer.js +34 -0
  798. package/kit/organism/rig.d.ts +59 -0
  799. package/kit/organism/rig.js +252 -0
  800. package/kit/organism/vitals.d.ts +9 -0
  801. package/kit/organism/vitals.js +44 -0
  802. package/kit/pages/index.d.ts +1 -0
  803. package/kit/pages/index.js +2 -0
  804. package/kit/pages/memory.d.ts +23 -0
  805. package/kit/pages/memory.js +264 -0
  806. package/kit/presence/console-half.d.ts +6 -0
  807. package/kit/presence/console-half.js +27 -0
  808. package/kit/presence/home.d.ts +33 -0
  809. package/kit/presence/home.js +192 -0
  810. package/kit/presence/pipe.d.ts +15 -0
  811. package/kit/presence/pipe.js +66 -0
  812. package/kit/presence/screen-half.d.ts +16 -0
  813. package/kit/presence/screen-half.js +180 -0
  814. package/kit/presence/skins.d.ts +17 -0
  815. package/kit/presence/skins.js +99 -0
  816. package/kit/puppet/boundary.d.ts +11 -0
  817. package/kit/puppet/boundary.js +103 -0
  818. package/kit/puppet/class.d.ts +3 -0
  819. package/kit/puppet/class.js +56 -0
  820. package/kit/puppet/defaults.d.ts +2 -0
  821. package/kit/puppet/defaults.js +14 -0
  822. package/kit/puppet/engine.d.ts +3 -0
  823. package/kit/puppet/engine.js +50 -0
  824. package/kit/puppet/index.d.ts +3 -0
  825. package/kit/puppet/index.js +4 -0
  826. package/kit/puppet/puppet.d.ts +41 -0
  827. package/kit/puppet/puppet.js +229 -0
  828. package/package.json +114 -4
  829. package/quo/box/box.d.ts +34 -0
  830. package/quo/box/box.js +137 -0
  831. package/quo/box/index.d.ts +4 -0
  832. package/quo/box/index.js +5 -0
  833. package/quo/box/reply.d.ts +12 -0
  834. package/quo/box/reply.js +64 -0
  835. package/quo/box/room.d.ts +3 -0
  836. package/quo/box/room.js +27 -0
  837. package/quo/box/sizes.d.ts +7 -0
  838. package/quo/box/sizes.js +10 -0
  839. package/quo/crypto/ed25519.d.ts +1 -0
  840. package/quo/crypto/ed25519.js +44 -0
  841. package/quo/crypto/index.d.ts +1 -0
  842. package/quo/crypto/index.js +2 -0
  843. package/quo/crypto/noble.d.ts +2 -0
  844. package/quo/crypto/noble.js +46 -0
  845. package/quo/door/door.d.ts +36 -0
  846. package/quo/door/door.js +207 -0
  847. package/quo/door/index.d.ts +2 -0
  848. package/quo/door/index.js +3 -0
  849. package/quo/door/occupant.d.ts +17 -0
  850. package/quo/door/occupant.js +55 -0
  851. package/quo/door/payload.d.ts +9 -0
  852. package/quo/door/payload.js +67 -0
  853. package/quo/frame/frame.d.ts +23 -0
  854. package/quo/frame/frame.js +160 -0
  855. package/quo/frame/index.d.ts +1 -0
  856. package/quo/frame/index.js +2 -0
  857. package/quo/index.d.ts +7 -0
  858. package/quo/index.js +55 -0
  859. package/quo/published.d.ts +1 -0
  860. package/quo/published.js +51 -0
  861. package/quo/standing/index.d.ts +3 -0
  862. package/quo/standing/index.js +4 -0
  863. package/quo/standing/once.d.ts +14 -0
  864. package/quo/standing/once.js +66 -0
  865. package/quo/standing/reading.d.ts +28 -0
  866. package/quo/standing/reading.js +99 -0
  867. package/quo/standing/standing.d.ts +44 -0
  868. package/quo/standing/standing.js +235 -0
  869. package/quo/value/address.d.ts +2 -0
  870. package/quo/value/address.js +89 -0
  871. package/quo/value/fields.d.ts +2 -0
  872. package/quo/value/fields.js +14 -0
  873. package/quo/value/index.d.ts +3 -0
  874. package/quo/value/index.js +4 -0
  875. package/quo/value/json.d.ts +16 -0
  876. package/quo/value/json.js +194 -0
  877. package/quo/ward/index.d.ts +6 -0
  878. package/quo/ward/index.js +19 -0
  879. package/quo/ward/invitation.d.ts +16 -0
  880. package/quo/ward/invitation.js +100 -0
  881. package/quo/ward/link.d.ts +38 -0
  882. package/quo/ward/link.js +94 -0
  883. package/quo/ward/lock.d.ts +1 -0
  884. package/quo/ward/lock.js +17 -0
  885. package/quo/ward/qr.d.ts +5 -0
  886. package/quo/ward/qr.js +279 -0
  887. package/quo/ward/vouch.d.ts +5 -0
  888. package/quo/ward/vouch.js +33 -0
  889. package/quo/ward/ward.d.ts +19 -0
  890. package/quo/ward/ward.js +63 -0
  891. package/screen/access.d.ts +32 -0
  892. package/screen/access.js +40 -0
  893. package/screen/compose.d.ts +14 -0
  894. package/screen/compose.js +137 -0
  895. package/screen/diff.d.ts +19 -0
  896. package/screen/diff.js +152 -0
  897. package/screen/digest.d.ts +1 -0
  898. package/screen/digest.js +60 -0
  899. package/screen/drawn.d.ts +35 -0
  900. package/screen/drawn.js +89 -0
  901. package/screen/fill.d.ts +12 -0
  902. package/screen/fill.js +91 -0
  903. package/screen/hydrate.d.ts +14 -0
  904. package/screen/hydrate.js +67 -0
  905. package/screen/index.d.ts +15 -0
  906. package/screen/index.js +26 -0
  907. package/screen/laid.d.ts +29 -0
  908. package/screen/laid.js +157 -0
  909. package/screen/match.d.ts +13 -0
  910. package/screen/match.js +63 -0
  911. package/screen/motion.d.ts +18 -0
  912. package/screen/motion.js +65 -0
  913. package/screen/press.d.ts +12 -0
  914. package/screen/press.js +63 -0
  915. package/screen/region.d.ts +6 -0
  916. package/screen/region.js +23 -0
  917. package/screen/route.d.ts +13 -0
  918. package/screen/route.js +74 -0
  919. package/screen/screen.d.ts +15 -0
  920. package/screen/screen.js +55 -0
  921. package/screen/sheet.d.ts +20 -0
  922. package/screen/sheet.js +145 -0
  923. package/screen/told.d.ts +14 -0
  924. package/screen/told.js +38 -0
  925. package/seams/bridge/bridge.d.ts +26 -0
  926. package/seams/bridge/bridge.js +31 -0
  927. package/seams/bridge/in-process.d.ts +13 -0
  928. package/seams/bridge/in-process.js +112 -0
  929. package/seams/bridge/index.d.ts +2 -0
  930. package/seams/bridge/index.js +3 -0
  931. package/seams/carriers/carriers.d.ts +112 -0
  932. package/seams/carriers/carriers.js +315 -0
  933. package/seams/carriers/index.d.ts +2 -0
  934. package/seams/carriers/index.js +29 -0
  935. package/seams/carriers/proof.d.ts +13 -0
  936. package/seams/carriers/proof.js +45 -0
  937. package/seams/chance/chance.d.ts +6 -0
  938. package/seams/chance/chance.js +8 -0
  939. package/seams/chance/index.d.ts +1 -0
  940. package/seams/chance/index.js +2 -0
  941. package/seams/codec/codec.d.ts +12 -0
  942. package/seams/codec/codec.js +9 -0
  943. package/seams/codec/index.d.ts +1 -0
  944. package/seams/codec/index.js +2 -0
  945. package/seams/contract/bytes.d.ts +1 -0
  946. package/seams/contract/bytes.js +4 -0
  947. package/seams/contract/contract.d.ts +10 -0
  948. package/seams/contract/contract.js +26 -0
  949. package/seams/contract/index.d.ts +2 -0
  950. package/seams/contract/index.js +3 -0
  951. package/seams/crypto/crypto.d.ts +29 -0
  952. package/seams/crypto/crypto.js +30 -0
  953. package/seams/crypto/index.d.ts +1 -0
  954. package/seams/crypto/index.js +2 -0
  955. package/seams/engine/engine.d.ts +44 -0
  956. package/seams/engine/engine.js +55 -0
  957. package/seams/engine/index.d.ts +1 -0
  958. package/seams/engine/index.js +2 -0
  959. package/seams/entry/configuration.d.ts +74 -0
  960. package/seams/entry/configuration.js +81 -0
  961. package/seams/entry/entry.d.ts +124 -0
  962. package/seams/entry/entry.js +144 -0
  963. package/seams/entry/index.d.ts +2 -0
  964. package/seams/entry/index.js +24 -0
  965. package/seams/index.d.ts +16 -0
  966. package/seams/index.js +86 -0
  967. package/seams/page-layer/index.d.ts +1 -0
  968. package/seams/page-layer/index.js +2 -0
  969. package/seams/page-layer/page-layer.d.ts +32 -0
  970. package/seams/page-layer/page-layer.js +29 -0
  971. package/seams/published.d.ts +1 -0
  972. package/seams/published.js +85 -0
  973. package/seams/queues/index.d.ts +2 -0
  974. package/seams/queues/index.js +3 -0
  975. package/seams/queues/queues.d.ts +36 -0
  976. package/seams/queues/queues.js +50 -0
  977. package/seams/run/index.d.ts +1 -0
  978. package/seams/run/index.js +2 -0
  979. package/seams/run/run.d.ts +7 -0
  980. package/seams/run/run.js +8 -0
  981. package/seams/time/index.d.ts +1 -0
  982. package/seams/time/index.js +2 -0
  983. package/seams/time/time.d.ts +10 -0
  984. package/seams/time/time.js +14 -0
  985. package/seams/unlocker/index.d.ts +1 -0
  986. package/seams/unlocker/index.js +2 -0
  987. package/seams/unlocker/unlocker.d.ts +17 -0
  988. package/seams/unlocker/unlocker.js +15 -0
  989. package/seams/vitals/index.d.ts +1 -0
  990. package/seams/vitals/index.js +2 -0
  991. package/seams/vitals/vitals.d.ts +24 -0
  992. package/seams/vitals/vitals.js +19 -0
  993. package/seams/webassembly.d.ts +36 -0
  994. package/standard/answer/answer.d.ts +16 -0
  995. package/standard/answer/answer.js +38 -0
  996. package/standard/answer/index.d.ts +1 -0
  997. package/standard/answer/index.js +2 -0
  998. package/standard/blueprint/blueprint.d.ts +21 -0
  999. package/standard/blueprint/blueprint.js +123 -0
  1000. package/standard/blueprint/index.d.ts +2 -0
  1001. package/standard/blueprint/index.js +3 -0
  1002. package/standard/blueprint/method.d.ts +21 -0
  1003. package/standard/blueprint/method.js +208 -0
  1004. package/standard/data/base64.d.ts +1 -0
  1005. package/standard/data/base64.js +39 -0
  1006. package/standard/data/data.d.ts +10 -0
  1007. package/standard/data/data.js +147 -0
  1008. package/standard/data/fields.d.ts +16 -0
  1009. package/standard/data/fields.js +68 -0
  1010. package/standard/data/guards.d.ts +9 -0
  1011. package/standard/data/guards.js +12 -0
  1012. package/standard/data/hex.d.ts +12 -0
  1013. package/standard/data/hex.js +74 -0
  1014. package/standard/data/index.d.ts +7 -0
  1015. package/standard/data/index.js +8 -0
  1016. package/standard/data/text.d.ts +19 -0
  1017. package/standard/data/text.js +222 -0
  1018. package/standard/data/utf8.d.ts +2 -0
  1019. package/standard/data/utf8.js +85 -0
  1020. package/standard/half/frames.d.ts +10 -0
  1021. package/standard/half/frames.js +115 -0
  1022. package/standard/half/half.d.ts +23 -0
  1023. package/standard/half/half.js +89 -0
  1024. package/standard/half/index.d.ts +2 -0
  1025. package/standard/half/index.js +14 -0
  1026. package/standard/index.d.ts +9 -0
  1027. package/standard/index.js +93 -0
  1028. package/standard/names/blueprint.d.ts +2 -0
  1029. package/standard/names/blueprint.js +18 -0
  1030. package/standard/names/code.d.ts +5 -0
  1031. package/standard/names/code.js +21 -0
  1032. package/standard/names/id.d.ts +3 -0
  1033. package/standard/names/id.js +11 -0
  1034. package/standard/names/index.d.ts +5 -0
  1035. package/standard/names/index.js +6 -0
  1036. package/standard/names/method.d.ts +2 -0
  1037. package/standard/names/method.js +19 -0
  1038. package/standard/names/version.d.ts +1 -0
  1039. package/standard/names/version.js +5 -0
  1040. package/standard/pattern/compile.d.ts +25 -0
  1041. package/standard/pattern/compile.js +153 -0
  1042. package/standard/pattern/index.d.ts +3 -0
  1043. package/standard/pattern/index.js +4 -0
  1044. package/standard/pattern/match.d.ts +2 -0
  1045. package/standard/pattern/match.js +75 -0
  1046. package/standard/pattern/parse.d.ts +39 -0
  1047. package/standard/pattern/parse.js +259 -0
  1048. package/standard/presence.d.ts +5 -0
  1049. package/standard/presence.js +69 -0
  1050. package/standard/published.d.ts +1 -0
  1051. package/standard/published.js +57 -0
  1052. package/standard/schema/admits.d.ts +10 -0
  1053. package/standard/schema/admits.js +189 -0
  1054. package/standard/schema/index.d.ts +3 -0
  1055. package/standard/schema/index.js +4 -0
  1056. package/standard/schema/known.d.ts +2 -0
  1057. package/standard/schema/known.js +23 -0
  1058. package/standard/schema/subset.d.ts +11 -0
  1059. package/standard/schema/subset.js +140 -0
  1060. package/standard/tree/allow.d.ts +22 -0
  1061. package/standard/tree/allow.js +229 -0
  1062. package/standard/tree/check.d.ts +3 -0
  1063. package/standard/tree/check.js +227 -0
  1064. package/standard/tree/forms.d.ts +9 -0
  1065. package/standard/tree/forms.js +121 -0
  1066. package/standard/tree/html.d.ts +11 -0
  1067. package/standard/tree/html.js +59 -0
  1068. package/standard/tree/index.d.ts +6 -0
  1069. package/standard/tree/index.js +46 -0
  1070. package/standard/tree/model.d.ts +7 -0
  1071. package/standard/tree/model.js +58 -0
  1072. package/standard/tree/tree.d.ts +44 -0
  1073. package/standard/tree/tree.js +58 -0
  1074. package/standard/version.d.ts +1 -0
  1075. package/standard/version.js +2 -0
@@ -0,0 +1,1985 @@
1
+ # Building on Nervur
2
+
3
+ How to install, own and build with Nervur as it stands at this version: each path from nothing to running, with the
4
+ commands and the code it takes. It is written for an agent that builds on Nervur, and for the person beside it. Read
5
+ Nervur's guide first, `guide.md` beside this file: it holds the model, and this holds the how.
6
+
7
+ Every command, method, field and file named here exists as written. Where a shape is not built yet, this paper says so.
8
+
9
+ ## The map
10
+
11
+ **What exists.** The genome is the kernel every organism runs, on every host. The floor is only what the genome and
12
+ the ports cannot work without, the default skins of the organs a port lays: the console's terminal, the screen's
13
+ window and the floor's look and design it draws with, and the repo faculties, the jailer `nervur.repos` and the repo
14
+ lobe `nervur.repo`, which keep your repos on a host with a body. A port lays them on one kind of host. Everything else
15
+ is yours, built in repos of your own as faculties, organs, designs and apps: Where Nervur stops, below, says what that
16
+ is and how.
17
+
18
+ | Package | What it is |
19
+ | ------------------------------- | ----------------------------------------------------------------------------------- |
20
+ | `nervur` | the `nervur` command, for a machine |
21
+ | `@nervur.org/installer-node` | the Node port: Mac, Linux, a Pi, a NAS, a server; and the edge's cargo |
22
+ | `@nervur.org/installer-browser` | the browser port: files a website serves, its visitors' organisms in their tabs |
23
+ | `@nervur.org/installer-phone` | the phone port: the browser port inside an app, with its keychain and its push |
24
+ | `@nervur.org/genome` | the kernel; its `faculty`, `standard`, `evidence` and `kit` exports are a builder's |
25
+ | `@nervur.org/floor` | the floor's faculties, the repo faculties among them, and the design kit |
26
+
27
+ Every package stands on npm, and none needs a token to be read.
28
+
29
+ **What each host gives.**
30
+
31
+ | Host | Body (`shell`, `disk`) | Dialed by others | Runs in the background | Woken by |
32
+ | ---------------------- | ---------------------- | ------------------------ | -------------------------- | ------------ |
33
+ | Mac, Linux desktop | yes | where no router hides it | a service, at every boot | - |
34
+ | Server, Pi, NAS | yes | yes, with `--public` | a service, always on | - |
35
+ | Browser (a site's tab) | no | never | asleep when no tab is open | Web Push |
36
+ | Phone (an app) | no | never | no | APNs or FCM |
37
+ | Edge (a Worker) | no | yes, at its domain | woken by what arrives | what arrives |
38
+
39
+ Only a host with a body keeps repos, runs programs and builds organs. A host without one takes faculties alone, by its
40
+ library's standing on a far repo lobe, and the organs its port brings. An organism nobody can dial, a
41
+ browser, a phone or a laptop behind a router, holds a line to one always on, and is reached through it.
42
+
43
+ **Where each step is proven today.** The Node port runs on a Mac and on Linux; a clean Linux machine, a real Pi and
44
+ Windows are not proven yet. The browser port is proven on Chromium; on Safari, on a Mac and on an iPhone in the
45
+ simulator, its seams hold in a worker, an organism stands from a link, a tab left and opened again keeps it, and a far
46
+ side asks it down a held line; a link taken and a press are not proven there yet, nor a real iPhone. A browser session
47
+ that keeps nothing, a private window, gives the port no store, so no organism stands there. No pilot is published: an
48
+ edge is laid by hand (An edge, by hand) or by a pilot you write (Pilots).
49
+
50
+ ## Where Nervur stops
51
+
52
+ Nervur gives what no one could build alone: an organism and its keys, an invitation taken and its keys kept in the
53
+ cells, asks one way over it, the owner as root, the cage and the store, backups, moves and the hand of a standing, the
54
+ screen's safety, and the ports. It builds nothing a faculty, an organ, a design or an app of yours could build on
55
+ those, however often it is asked, because each such thing is one way among many and the first built into the kernel
56
+ would close the others. Before you ask Nervur for something, ask the guide's one question: without it, with no design
57
+ and no app, does something Nervur already promises break, or could no one build it on what is published? It is a gap
58
+ only where nothing published reaches it, where building it leaves a promise unproven, or where your only way breaks a
59
+ promise; then it comes with a test, played from outside, that fails today. Otherwise it is yours to build, and the
60
+ table below says how. A request that fails this question is answered with this section, never with a change.
61
+
62
+ **Your own window is the road to most of it.** The screen's present lobe, the floor's `nervur.window`, is a faculty
63
+ like any other. Each host names the one an organism is born wearing: a desktop's first install by
64
+ `nervur install --faculties <package>`, a package of yours exporting `WINDOW` in the shape `@nervur.org/floor` exports
65
+ it; a site by its own `/.well-known/quo`, and a phone's app by its `quo.json`, as A site that serves the browser port
66
+ and A phone tell. The person present then moves it to any faculty by `version`.
67
+ Write your own, standing on what the floor's stands on, the screen's organ, the brain's asks and the window's contract
68
+ this paper tells whole (A window of your own), or wrap the floor's behind a design. The floor's
69
+ window is the least that lets a person live with no design: it draws the organism and each place by what they
70
+ describe, carries a press past the person's yes where the press binds them, takes a link only with a yes that knows who
71
+ invites and what they say, and has one leave, at a place it took. Whatever else a person meets at their home, its
72
+ pages, its words, its lists, its choices, is that lobe's and its design's, never Nervur's.
73
+
74
+ | You want | Build it as | On what Nervur gives |
75
+ | ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
76
+ | a place a person can block, and refuse it again | your window keeps the wards and the domains it refused in its cells, and refuses a link of one before it is taken | a link's card names its ward and its domain before anything is spent |
77
+ | a report of a place | your window or design links to where you send reports, with the place's ward | the standing's ward, read by your window |
78
+ | a page of what a person can do with a place | your design draws it, its presses asked of your window, which asks the brain | the brain's `drop`, `note`, `reinvite`, `hand`; a press is the window's |
79
+ | a name the person goes by at each place | your window gives the note it wants at the yes: `accept` takes a `note`, kept beside the standing and never sent to the place, and the brain's `note` sets it anew | `accept`'s `note`, the brain's `note`, kept beside the standing and never sent |
80
+ | a place named as the person would | your window reads the standing's note and the domain that vouched for it, and keeps the name it gives in its cells | the brain's `note` and `accept`'s `note` |
81
+ | the places the person stands on, together | your window reads the relations it holds and draws them as it likes | relations are standings, the brain's `ends`; a press is the window's |
82
+ | a board of widgets of many places | your design lays `slot`s naming placeholders of your window, each wired to a place's lobe | a slot draws the lobe its placeholder is wired to |
83
+ | a page of parts made from what a lobe says of its methods | your design draws components named for shapes you choose, from a field of your own your faculties' seats carry | the describe and its free seat fields, the tree, a press the window carries |
84
+ | a theme, a language, a name kept for the person | your window keeps them in its cells and draws by them | what the host tells: the device's language and theme, the screen's size |
85
+ | the home's words in many languages | a design on the owners' road words itself by key, in any language | a design's words by key, handed the person's language |
86
+ | a page of the organism's state, lobes and library, laid out as you like | your design's `organism` component draws what the window hands it, or your window asks the brain's `state`, `lobes` and `ends` and the library's `list` and draws them | the organism's describe, the brain's asks, the library's `list` |
87
+ | a site's pages that draw what its visitor holds | the site's pages ask the standings the browser holds and draw the answers with their own markup | the browser port's page module, `standings()`, `ask`, `watch`; the vouch |
88
+ | a phone app's screen | the app's page draws in your window and your design | the page module, `data-quo-link`, the window's `accept` |
89
+ | a hand-off to the web | your window shows a link a method answers, as the home's own words, opening only on a yes | a link of the world with its ask, `world {say, yes, no}` |
90
+ | a far lobe that tells a window "my answers changed" | your window invites the lobe by the ear's `invite` and hands it the invitation; the lobe accepts it through its mouth and, at each change, asks over it a method your window declares, which draws again | the ear's `invite` (`through` where your home cannot be dialed), the mouth's `accept`, asks over a relation |
91
+ | a lobe that asks for another over some of its standings | a faculty that invites to itself, is granted the standings the owner `order`s it, and forwards the device's asks over them | the ear's `invite` and `refer`, the brain's `order`, a lobe's `nerves` |
92
+ | the places of another home you own, seen here | your window asks that home's brain, which you own, and draws what it answers | an owner's asks afar, the brain's `state` and `ends` there |
93
+ | a consent screen that says more | your design draws it from what the window hands it, or your own window draws its own landing; the yes is the window's `accept`, with the note you want | the link's offer, read before the yes, spending nothing |
94
+ | a keeper of a server's boot key | a faculty that keeps each device's key in its cells and answers the unlocker's four asks, `keep`, `open`, `admit` and `rewrap`, as A server tells | the remote boot mode and the asks its unlocker makes |
95
+ | a copy of a home kept safe, on a drive or afar | a faculty or an app that asks `backup` and `backupPiece` and keeps the sealed bytes where it likes; `nervur restore` or a port's `lay` brings it back as an older life | the brain's `backup`, `backupPiece`, a named key; the ports' restore |
96
+
97
+ Nervur keeps the screen safe whatever window you write: a design's tree is checked and reaches nothing of the organism,
98
+ and a press is carried by the window and never forged by a tree. What your window hands the host to lay above the page,
99
+ `way` (A window of your own), stands outside every tree, and no place's tree or sheet covers or presses it. Whether a
100
+ press waits for the person's yes, and what stands above the page, are your window's own. Everything else is yours.
101
+
102
+ ## Installing and owning
103
+
104
+ ### A machine: Mac, Linux, a Pi
105
+
106
+ One script lays Nervur on a machine with nothing on it, Node included: `install/install.sh` for a Mac, Linux or a Pi,
107
+ `install/install.ps1` for Windows, both in the package `nervur`. Run from a copy of it:
108
+
109
+ ```sh
110
+ sh install.sh
111
+ ```
112
+
113
+ On Windows, in PowerShell:
114
+
115
+ ```powershell
116
+ powershell -NoProfile -ExecutionPolicy Bypass -File install.ps1
117
+ ```
118
+
119
+ No address of ours serves the scripts yet: take them from the package `nervur` on npm, its `install/` folder. What the
120
+ scripts do:
121
+
122
+ - They take Node's own distribution for the machine from Node's site, `nodejs.org`, or from a mirror of it that
123
+ `NERVUR_NODE` names, checked against the digest Node publishes for it, which the script pins. Nervur publishes no
124
+ Node: the digest, not the address, is what is trusted.
125
+ - The Node they lay moves with Nervur. They mark its folder with an empty `.nervur-node`, and an update that lays a
126
+ version pinning another Node lays that one first, taken as the script takes it, from Node's site or the mirror
127
+ `NERVUR_NODE` names (for an update, a `file:` address names a folder), and checked against the digest that version
128
+ pins. It becomes the one that runs only once it stands whole beside, so a cut leaves the old Node or the new; on
129
+ Windows, where a cut in the instant the program moves can leave the new one beside, running the script again lays
130
+ it. A Node that does not match the digest, or a site that gives none, refuses the update, nothing changed. A Node of
131
+ your own, as under `npm install -g nervur`, never moves; remove the mark to keep the script's Node as it stands.
132
+ - They pack `nervur` from the channel, npm's own registry unless `NERVUR_CHANNEL` names another, and install that file
133
+ with Nervur's scope alone mapped to the channel, so every other package comes from npm's own registry. npm's own
134
+ registry is sent no token. A channel you name that reads with one is given it as `NPM_TOKEN`, named to npm for that
135
+ channel alone and kept nowhere.
136
+ - They lay both at `NERVUR_ROOT`: `~/.local/share/nervur` by default, `%LOCALAPPDATA%\Nervur\command` on Windows, whole
137
+ or not at all, and put the command on the `PATH` of every later shell (`$NERVUR_ROOT/bin` in `~/.profile`, and in
138
+ `~/.zprofile` on a Mac; the folder itself in the user's `Path` on Windows). A second run finds the command laid and
139
+ lays nothing again. What the script lays every account reads and runs, and a folder above it that stood before is
140
+ left as it was.
141
+ - They run `nervur install` with the words given them: `sh install.sh --boot file`, and after `sh -s --` where the
142
+ script is piped. Piped, the script asks a passphrase at the terminal it runs in (`/dev/tty`).
143
+ - With no terminal at all, under cloud-init or another program, the boot mode is still the host's default: `file` where
144
+ no person sits, a server, a Pi, Linux over `ssh`, so it installs asking nothing; `present` on a Mac or Linux inside a
145
+ graphical session, which reads its passphrase from standard input and is refused with none, so name `--boot file` or
146
+ another mode there.
147
+ - They keep a token nowhere, so a later `nervur update` reads a channel you named with the token npm's configuration
148
+ names.
149
+
150
+ **With Node 22 or any newer already**, its newest patch, npm is the road. Nervur runs on every Node line Node itself
151
+ still supports, and each version is proven on the oldest of them:
152
+
153
+ ```sh
154
+ npm install -g nervur
155
+ nervur install
156
+ nervur state
157
+ ```
158
+
159
+ `nervur install` takes the package from the registry your npm names, npm's own by default, and the organism moves
160
+ itself as new versions come: it asks that registry as it starts and every hour. `--channel <registry>` names another
161
+ registry for one install or update, a mirror of your own, and the organism then asks that one.
162
+
163
+ Where Node belongs to root, make npm's global folder your account's first: `npm config set prefix ~/.nervur/installer`,
164
+ with `~/.nervur/installer/bin` on your `PATH`.
165
+
166
+ `nervur install` lays the organism in `~/.nervur/organism/`, listening on port 9110 on loopback, and a service of your
167
+ account: a launchd agent on a Mac, a systemd user unit on Linux and a Pi. Whoever is present at the account owns it.
168
+
169
+ **A design to be born in.** `nervur install --design <quo.json>` hands the installer the file a site writes for its
170
+ organism: its `organism.design` names the design, and `design.json` with `design/` stand beside it. It is read and
171
+ checked as a site's is, refused whole where it fails, and the organism wears it from its first screen; with none handed
172
+ it wears the floor's, and an owner's `wear` moves either. Handed again over an organism already laid, it lays the
173
+ design too: the organism starts again and wears it, unless an owner's `wear` chose another. The same file may name the
174
+ class of the screen's size, `size`, as a site's does: the organism's folder keeps it, and the screen is drawn and told
175
+ in that class whatever the window's width; with none named the class is the width's. A file that names a `size` and no
176
+ design is taken too: the organism wears the floor's design under it.
177
+
178
+ **The boot mode** is how the organism gets its boot key at each boot, chosen at the first install, moved by any later
179
+ `nervur install --boot <mode>`:
180
+
181
+ | Mode | What it is | Its price |
182
+ | ---------- | ------------------------------------------------------------ | ----------------------------------------------------------------- |
183
+ | `present` | a passphrase, asked twice; the default where a person sits | after every reboot it waits for `nervur start` and the passphrase |
184
+ | `file` | `boot.key` in the organism's folder; the default on a server | whoever reads that file owns the organism: keep a copy off it |
185
+ | `keyring` | the login keychain on a Mac, Secret Service on Linux | the account's keychain holds the key |
186
+ | `hardware` | sealed to a Mac's Secure Enclave; refused elsewhere | the organism opens on that Mac alone |
187
+ | `remote` | keepers over Quo, each `--keeper <invitation-file>`, `--end` | a keeper answers it; else the chain ends at `--end`, `present` |
188
+
189
+ A keeper is any organism, built of whatever you choose, that draws the invitation the device takes and answers the
190
+ device's unlocker over the relation it gives, each device apart by the relation that asks. Its four methods take text
191
+ args, the key as the 64 hexadecimal digits of its 32 bytes and the fingerprint as the device words it: `keep {key,
192
+ fingerprint}` takes the device's key and the first fingerprint it boots, once; `open {fingerprint}` answers the key to a
193
+ fingerprint admitted and refuses any other; `admit {key, fingerprint}` admits one more, as after an upgrade, and
194
+ `rewrap {key, next}` moves the key, each for whoever shows the key the keeper holds. A refusal is the error `refused`,
195
+ and an ask taken answers null, `open` aside. A keeper's check stops a changed device, not a thief: a fingerprint is the
196
+ device's own word for what it runs.
197
+
198
+ ### A server
199
+
200
+ A server is a machine with many accounts, and Nervur keeps three parts of it apart. The **machine** is its
201
+ administrator's, whoever holds root: its accounts, ports, firewall, domain, TLS and services are laid by that person,
202
+ outside the graph, never by an organism. The **self** is the organism's own account: it boots the organism and keeps
203
+ its folder, its store and its boot key to itself. The **body** is a second account, the **work account**, where every
204
+ organ runs but the self's own, `shell`, `disk`, `network` and every repo's organ, and whatever they start, git, npm
205
+ or an agent. Nothing the body starts reads the self's folder, its store or its boot key.
206
+
207
+ One account holds one organism. Another organism on the same machine takes another account, and its own body, and the
208
+ two never see each other. Which of these are you?
209
+
210
+ - **You own the machine.** You are its administrator and every person on it, with one organism or several: _You own the
211
+ machine_.
212
+ - **Another person administers it, and you install.** A company's server, where you hold an account and no root: _You
213
+ hold an account_, after _What the administrator prepares_, which is that person's page.
214
+ - **Someone lays your organism for you,** and you may never log in to the machine: _Laid for you_.
215
+
216
+ #### What the administrator prepares
217
+
218
+ Root prepares each person once, and installs no Nervur. Nothing below is written by an organism: an organism that
219
+ could make accounts could make any account.
220
+
221
+ 1. **The person's account**, an ordinary one: its own home, its own group, no `sudo`. This is the self.
222
+ 2. **The work account**, another, with no login shell and no password, named by you: `bob-work` for `bob`. This is the
223
+ body. It is a second account of the machine, never a second login: nobody signs in as it, by a password, a key or
224
+ `su`, and the person's organism alone starts programs as it.
225
+ 3. **One rule**, so the person's account starts programs as the work account, asking no password, and never the other
226
+ way. In a file of `/etc/sudoers.d/`, mode `0440`, checked with `visudo -c`:
227
+
228
+ ```text
229
+ bob ALL=(bob-work) NOPASSWD: ALL
230
+ ```
231
+
232
+ 4. **Lingering**, so the person's organism starts at every boot with no one logged in, and after the machine restarts:
233
+ `loginctl enable-linger bob`. Without it the install says so and the organism starts only while its account has a
234
+ session.
235
+
236
+ On Debian and the systems that follow it the accounts are made so:
237
+
238
+ ```sh
239
+ useradd --create-home --shell /bin/bash bob
240
+ useradd --create-home --shell /usr/sbin/nologin bob-work
241
+ ```
242
+
243
+ Besides these, the person needs:
244
+
245
+ - **A Node every account runs**, 24 or newer, laid by the machine, such as the distribution's own or one under
246
+ `/usr/local`: the body runs on the Node the install runs on, so a Node kept in a person's home would close the body
247
+ out.
248
+ - **A way in:** their public key in the account's `~/.ssh/authorized_keys`, and, where the machine limits who may sign
249
+ in, their name in `AllowUsers`. Nervur asks nothing more of SSH.
250
+ - **A port block**: an organism takes the port it is given, its web the one after it and its WebSocket the one after
251
+ that, `9120`, `9121` and `9122`. Two organisms cannot hold one port, and the second says so plainly, naming the port,
252
+ so give each person a block of their own.
253
+
254
+ Give each person, in one message: the machine's name, their account and their work account's name, their port, and what
255
+ is open to the world. The machine's other parts stay yours: opening a port, routing a domain to it,
256
+ TLS and a proxy.
257
+
258
+ What stays yours, and is worth a line each: the machine's **swap and memory**, an organism at rest holding some 650 MiB
259
+ resident and its body more under work, so budget each person's organism that, and cap each account with the machine's
260
+ own tools if one must not starve the others; **`hidepid`** on `/proc`, so an account sees no other account's
261
+ processes, which it otherwise sees by their command lines; and **every person's leaving**, below.
262
+
263
+ #### You own the machine
264
+
265
+ You hold root, so you prepare for yourself what an administrator prepares for others, and install as that account.
266
+ Never as root: the organism would be root, and so would everything its body starts. The install says so where the
267
+ account is root, and lays it all the same.
268
+
269
+ - **One organism, and nothing on the machine you do not trust:** an ordinary account is enough. Install with no
270
+ `--work`: the body runs as the same account, and the install says what that costs, that any program `shell` starts may
271
+ read the organism's folder, its store and its boot key.
272
+ - **Anything you do not fully trust runs on it**, an agent, a repo's build, a faculty someone else wrote: lay the closed
273
+ body. Prepare the two accounts as above, then install with `--work`.
274
+ - **Several organisms:** one account each, a pair for each if you want each body closed, each with its own port block.
275
+ They never see each other, whoever lays them. The accounts are yours to name: `ops` and `ops-work`, `lab` and
276
+ `lab-work`.
277
+
278
+ Then the same steps as the person's, below, as that account.
279
+
280
+ #### You hold an account
281
+
282
+ An administrator prepared your account. Log in as it, then:
283
+
284
+ ```sh
285
+ npm config set prefix ~/.nervur/installer
286
+ export PATH="$HOME/.nervur/installer/bin:$PATH"
287
+ npm install -g nervur
288
+ nervur install --port 9120 --work bob-work
289
+ nervur state
290
+ ```
291
+
292
+ The first two lines make npm's global folder your own, where the machine's Node belongs to root. The install proves,
293
+ before it lays anything, that your work account starts programs for you and runs the Node, and refuses naming what is
294
+ missing: the rule the administrator lays, or the folder the work account does not pass. It opens your home to be passed
295
+ and never listed, as it does its own folder, and nothing else of yours. What it lays is yours and the work account's:
296
+ no other account of the machine lists or reads the organism's folder, its store, its key or its service's files, and
297
+ none lists the folders of code beside them, which the work account reads by name.
298
+
299
+ Your home stays as private as the folders in it: the install opens only the way through, so keep what is private in
300
+ folders of mode `700`.
301
+
302
+ From then on the organism is yours alone: `nervur state`, `nervur stop`, `nervur start`, `nervur backup`,
303
+ `nervur update`, and `nervur wipe` to end it, which removes the organism and the body's folder it made and nothing of
304
+ anyone else's. Whoever is present at your account owns it. It starts again by itself when the machine restarts, and an
305
+ administrator who removes you ends it with you.
306
+
307
+ #### Reaching it
308
+
309
+ A server is reached by others: `nervur install --public <host>` listens on every interface and announces
310
+ `tcp://<host>:9110`. Organisms that cannot be dialed hold lines to it over a WebSocket: `--ws ws://<host>:9112/quo` with
311
+ that port open, or `--ws wss://<host>/quo` behind a TLS proxy of the machine forwarding to `ws://127.0.0.1:9112/quo`.
312
+ Both ports follow the organism's own: with `--port 9120` they are 9120 and 9122. Opening them, DNS, TLS and the proxy
313
+ are the administrator's, never the organism's.
314
+
315
+ #### Laid for you
316
+
317
+ The administrator may also lay the organism for a person who never logs in to the machine, a colleague, a team, an
318
+ agent, or a customer's server laid by cloud-init or a pilot. The administrator prepares the accounts as above, then
319
+ runs the person's install as the person's account, with a claim. A server laid from afar is claimed as an edge is: its
320
+ layer draws a claim and names its file at the first install, and whoever names that claim takes the anchor from
321
+ wherever it stands.
322
+
323
+ ```sh
324
+ openssl rand -hex 32 > claim.txt # drawn by whoever lays the server, kept until the anchor is taken
325
+ nervur install --boot file --claim claim.txt
326
+ ```
327
+
328
+ No one is present then, so the configuration names no present lobe and no anchor, and the console holds nothing of the
329
+ brain. The organism serves its web from its first boot, on the port after `--port`, 9111, and answers
330
+ `POST /.nervur/claim` with `Authorization: Bearer <claim>` with its newest first invitation, `{"invitation": "…"}`;
331
+ every other asker, and the claim before the first invitation is handed, hears a path that is none, so it is asked
332
+ again. Whoever accepts that invitation holds the anchor; the anchor passed on, the claim gives no one the organism. The
333
+ web listens on loopback unless `--public` names a host, so from afar the machine's proxy forwards `https://<host>` to
334
+ `http://127.0.0.1:9111` with TLS: over plain http the claim and the invitation cross in clear. Until the anchor is taken
335
+ whoever reads the claim holds the organism, wherever the layer put it, user data a cloud's metadata service serves among
336
+ them. The claim is a first install's word: a later install names the same claim or none. A `nervur reclaim` at the
337
+ machine forgets it, and the console is present and the anchor again.
338
+
339
+ #### When a person leaves
340
+
341
+ The person ends their own organism with `nervur wipe`, which asks them to type `wipe`, then removes it, its store and
342
+ the body's folder it made. The machine is the administrator's to clear, in this order, so nothing of the person still
343
+ runs when their account goes:
344
+
345
+ 1. Turn lingering off and end the account's session: `loginctl disable-linger bob`, then `loginctl terminate-user bob`.
346
+ 2. Remove both accounts and their homes: `userdel -r bob`, `userdel -r bob-work`.
347
+ 3. Remove the rule: the file of `/etc/sudoers.d/` made for them.
348
+
349
+ An account removed without its person's `wipe` takes the organism with it, store and key, and no one holds a copy: a
350
+ person who may be asked takes a `nervur backup` first, and every other organism on the machine stands as it did.
351
+
352
+ ### A browser
353
+
354
+ A browser holds its visitor's organism, a home in a tab, in a worker of the site; the site serves the browser port as
355
+ plain files. See The browser and the web.
356
+
357
+ ### A phone
358
+
359
+ An app embeds the browser port in its web view: it adds `@nervur.org/installer-phone` and Capacitor, runs
360
+ `nervur-phone-lay www organs.json` before `cap sync`, and loads `nervur/page.js` as a site does. The store stands in the
361
+ app's own files, the boot key in the iOS keychain or the Android Keystore; native organs are the app's plugins, named in
362
+ `organs.json` by digest. The design the app's organism is born in is named as a site names it, `organism.design`, in a
363
+ `quo.json` handed to the same command, each file told by its name, `nervur-phone-lay www organs.json quo.json`, or
364
+ `nervur-phone-lay www quo.json` for an app with no organ, with the design's files laid in `www/nervur` as a site lays
365
+ them; the same `quo.json` names the class of the screen's size, `size`, as a site's file does. The window the organism
366
+ wears is named there too, `organism.window`, as a site names it, its source handed to the same command as a file named
367
+ `window.js`, `nervur-phone-lay www quo.json window.js`, which lays it at `www/nervur/window/faculty.js`. It needs iOS
368
+ 17.4 or a current Android System WebView. Whoever holds the app is present and owns it; the package's `sample/` is a
369
+ whole app.
370
+
371
+ The app's page is the organism's own screen: `<div data-quo-screen></div>` is the person's screen, what the window lays
372
+ above the page standing there as on a desktop. Beside it the page holds `<div data-quo-link></div>` and takes a link
373
+ the device hands it after its `#`, at its load or while open: the consent is drawn there, a yes redeems and accepts and
374
+ the screen draws what the window's `accept` answers, a no keeps nothing, and the element is left empty, saying `none`,
375
+ the link taken out of the address, with no load of the page.
376
+
377
+ ### An edge, and any host laid from afar
378
+
379
+ Where no one is present, an organism is laid from another machine. The Node port gives the edge's cargo: a Cloudflare
380
+ Worker whose organism lives in one Durable Object. Whoever lays it draws one secret and sets it on the Worker, `CLAIM`,
381
+ with `DOMAIN` and, where wanted, `PLACE` or `WITHIN`. The boot key is the object's own: drawn at its first boot and kept
382
+ in its storage, the same at every boot after, so no layer holds it, and whoever holds the Cloudflare account holds the
383
+ organism. No one is present, so the organism names no anchor: it keeps its first invitation and answers it to whoever
384
+ names the claim, and whoever accepts that invitation holds the anchor. It keeps that same invitation through every
385
+ restart of its object, an eviction after a few idle seconds among them, so one fetched and accepted is still the one to
386
+ knock on whenever its owner first asks; another is drawn only where the organism comes to be reached at other addresses,
387
+ and that one ends the one before. The Worker answers these routes, each by
388
+ `Authorization: Bearer <CLAIM>`, and to anyone else as a path that is none:
389
+
390
+ | Route | What it does |
391
+ | ----------------------- | -------------------------------------------------------------------------------------------- |
392
+ | `POST /.nervur/claim` | the newest first invitation |
393
+ | `POST /.nervur/lay` | a backup's bytes, with `x-nervur-key`, or a move's file with none; `?over` replaces a store |
394
+ | `POST /.nervur/arrive` | draws the key a move is sealed to, answering `{"key": "<hex>"}` |
395
+ | `POST /.nervur/stay` | the old copy's word that the new one never ran |
396
+ | `POST /.nervur/reclaim` | `{"challenge"}`; then again with `x-nervur-signature`, a recovery key's signature as 128 hex |
397
+
398
+ An edge moves to a version by being laid again, the store tried and kept or brought back, and is wiped
399
+ by deleting what was laid. A machine laid from afar is a machine, claimed by `nervur install --claim` (A server).
400
+
401
+ **An edge, by hand.** The cargo stands in the published `@nervur.org/installer-node`, under `cargo/`: `worker.js`, the
402
+ main module, beside the WebAssembly modules it imports, every file named by `cargo/manifest.json`
403
+ (`{"main": "worker.js", "files": [...]}`). The Worker binds one SQLite Durable Object, the class `Edge`, as `EDGE`, and
404
+ runs without Node compatibility. It takes Cloudflare's own tool, `wrangler`, signed in to your account:
405
+ `npx wrangler login` opens a browser to sign in, or, on a machine with none, `CLOUDFLARE_API_TOKEN` names an API token
406
+ made in the dashboard from its template "Edit Cloudflare Workers", with `CLOUDFLARE_ACCOUNT_ID` your account's ID. An
407
+ account answers at `<your subdomain>.workers.dev` once its subdomain is chosen, once, in the dashboard's Workers page;
408
+ `workers_dev = true` serves the Worker there. In a folder holding the cargo's files:
409
+
410
+ ```sh
411
+ npm pack @nervur.org/installer-node && tar -xzf nervur.org-installer-node-*.tgz
412
+ cd package/cargo
413
+ npx wrangler login # or: export CLOUDFLARE_API_TOKEN=... CLOUDFLARE_ACCOUNT_ID=...
414
+ cat > wrangler.toml <<'EOF'
415
+ name = "acme-edge"
416
+ main = "worker.js"
417
+ compatibility_date = "2026-07-01"
418
+ workers_dev = true
419
+ no_bundle = true
420
+ find_additional_modules = true
421
+ rules = [{ type = "CompiledWasm", globs = ["**/*.wasm"] }]
422
+
423
+ [[durable_objects.bindings]]
424
+ name = "EDGE"
425
+ class_name = "Edge"
426
+
427
+ [[migrations]]
428
+ tag = "v1"
429
+ new_sqlite_classes = ["Edge"]
430
+
431
+ [vars]
432
+ DOMAIN = "acme-edge.<your subdomain>.workers.dev"
433
+ EOF
434
+ openssl rand -hex 32 > claim.txt # keep it off this machine too
435
+ npx wrangler deploy
436
+ npx wrangler secret put CLAIM < claim.txt
437
+ until curl -fsS -X POST -H "Authorization: Bearer $(cat claim.txt)" https://acme-edge.<your subdomain>.workers.dev/.nervur/claim > claimed.json; do sleep 5; done
438
+ node -pe 'JSON.parse(require("fs").readFileSync("claimed.json", "utf8")).invitation' > invitation.txt
439
+ nervur accept edge --text invitation=invitation.txt # on your machine: you hold the anchor
440
+ nervur ask edge state
441
+ ```
442
+
443
+ `DOMAIN` is the host the Worker answers at, a domain of your own routed to it or its `workers.dev` name. Where wanted,
444
+ `[vars]` names where the organism lives: `PLACE`, a Durable Object location hint, one of `wnam`, `enam`, `sam`, `weur`,
445
+ `eeur`, `apac`, `oc`, `afr`, `me`, the region the object is placed nearest at its first ask, where it stays for life, a
446
+ later `PLACE` moving nothing; or `WITHIN`, a jurisdiction, `eu` or `fedramp`, whose data never leaves it. `WITHIN` names
447
+ the object itself, so changing it later reaches another, empty object, never the organism: set it before the first
448
+ deploy, and never after. The claim is a path that is none until the organism has booted and handed its first invitation,
449
+ so it is asked again. `claim.txt` lays, moves and reclaims the edge by the routes above, and opens no backup: one
450
+ carried off to open elsewhere names a public key of yours, the brain's `backup {keys}`, whose secret opens it there, on
451
+ another edge as `x-nervur-key`. A new version is the same `wrangler deploy` in a newer package's cargo, with the same
452
+ `wrangler.toml`; the claim and the boot key stay.
453
+
454
+ ### A container
455
+
456
+ A container with a disk that outlives it is a machine: install as on Linux, `--boot file` or `keyring`, the folder
457
+ `~/.nervur` on its volume. Nervur ships no image.
458
+
459
+ ### Owning from afar
460
+
461
+ An organism invites an owner by the brain's `invite`, and the other organism accepts it under a name of its own:
462
+
463
+ ```sh
464
+ nervur ask brain invite '{"waits":null,"lives":null}' > invitation.txt # on the server
465
+ nervur accept server --text invitation=invitation.txt # on the laptop
466
+ nervur ask server state
467
+ ```
468
+
469
+ `waits` is how long the invitation waits for its knock and `lives` how long the relation lives, in milliseconds, `null`
470
+ for no end. `"anchor": true` makes the next anchor, who passes the anchor on. The person present may
471
+ always take a far anchor back by dropping it.
472
+
473
+ ## Using an organism
474
+
475
+ ### The command
476
+
477
+ `nervur` alone prints every command. On a machine:
478
+
479
+ | Command | What it does |
480
+ | ------------------------------------------- | ------------------------------------------------------------------------------- |
481
+ | `install [version] [digest]`, `update` | one act: lays the organism, or moves it to a version, tried before it is kept |
482
+ | `start [--floor]`, `stop` | starts and stops it; `--floor` lays the shipped console and window again |
483
+ | `state`, `card`, `version`, `screen` | the state in full; its card; the versions; the screen's address on this machine |
484
+ | `ask <placeholder> [method] [args]` | asks over a placeholder the console holds, `brain` the organism's own |
485
+ | `lobe <lobe> [method] [args]` | asks a lobe through the brain; no method describes it |
486
+ | `accept <placeholder> <invitation> [note]` | accepts an invitation; `accept <link> [placeholder] [note]` takes a link |
487
+ | `offer <link>` | reads a link's offer, what it says and its spans, and spends nothing |
488
+ | `forget <placeholder>`, `relations`, `ends` | ends an accepted relation; lists them; every occupant and standing |
489
+ | `backup [file]`, `salvage [file]` | a backup to a file of yours; what still opens of a damaged store |
490
+ | `restore <file> [salt]` | a backup restored where no organism stands, as a new life |
491
+ | `arrive`, `move <key> [file]`, `stay` | a move to another device (Life across devices) |
492
+ | `rewrap`, `rekey [--cipher <name>]` | a new boot key; a new boot key and data key |
493
+ | `reclaim` | reclaims the organism by a recovery key |
494
+ | `repos` | lays the jailer, the first time you want a repo |
495
+ | `mcp` | serves MCP on standard input and output to a model present at the device |
496
+ | `wipe` | destroys the organism and all it holds, once you type `wipe` |
497
+
498
+ `args` is one word of JSON: `'{"lives": null}'`. `--text <field>=<file>` gives a file's text as one field of the args,
499
+ so a secret stays out of the shell's history:
500
+ `nervur lobe <repo> setToken '{"name":"NPM_TOKEN"}' --text value=token.txt`. `--json` prints each answer as data, for
501
+ programs. `--follow`, on `ask` and `lobe`, waits for the end of a job the answer names, printing the job whole and
502
+ exiting on its code. `--home <folder>` names another organism's folder, for tests.
503
+
504
+ ### The brain's asks
505
+
506
+ An owner reaches the organism through the brain; each is `nervur ask brain <method> '<args>'`, or the same ask over a
507
+ placeholder of an organism owned from afar:
508
+
509
+ | Group | Methods |
510
+ | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
511
+ | Faculties and lobes | `create {faculty, wiring?, cells?, sealed?}`, `version {lobe, faculty, settled?}`, `settle`, `switchOff`, `switchOn`, `tearDown`, `lobes` |
512
+ | Organs | `addOrgan {id, blueprint, reach, half}`, `removeOrgan`, `settleOrgan` |
513
+ | Wiring | `order {node, order: {termination, placeholder?, until?}, note?}`, `unwire` |
514
+ | Reaching | `ask {lobe, method, args, timeout}` |
515
+ | Owners | `invite {waits, lives, anchor?, refer?, public?, through?, note?}`, `drop`, `recoveryKeys {keys}` |
516
+ | Keys | `rewrap`, `rekey`, `move {to}` |
517
+ | Who and where | `ward`, `addresses {at}`, `hand {far, at}`; `card` reads them |
518
+ | Ends | `accept {relation, invitation?, link?, note?, lobe?}`, `note`, `reinvite`, `drop`; `taking`, `cede {far, to}`, `take {handed, key, relation}` |
519
+ | Life | `backup {keys?}`, `backupPiece {mark, at, length}`, `upgrade {version, digest}`, `time {at}` |
520
+ | Limits | `limit {name, lobe?, value?}`, `limits` |
521
+ | Letters | `repost`, `forget`, `cancel` |
522
+ | State and character | `state {cursor?}`, `ends`, `card`, `character`, `setCharacter`, `portrait` |
523
+
524
+ Each method's blueprint says the rest: `nervur ask brain` describes them all. `lobe <id> ...` is the brain's `ask`.
525
+
526
+ **Limits are defaults.** Every bound an owner meets moves by `limit`: for one lobe, or for every lobe with no
527
+ word of its own. Among them `longestBudget`, `longestTimeout`, `lobeMemory`, `queue.share`, `letters.attempts`, `space`,
528
+ `invitations`, `note`, `still`, `within`, `migrate`, `changes` and `tree.nodes`. `limits` reads the words kept. The
529
+ organism's time is set by `time {at}`, milliseconds since 1970.
530
+
531
+ ### The console, the screen and a model
532
+
533
+ The console is the terminal's lines: whatever `nervur` types after the command is a line to the console's present lobe.
534
+ The screen is the window: `nervur screen` names its page on `127.0.0.1`, open to this account's programs alone: this
535
+ home's own, asked of the organism where it runs, or in words why this home's screen is not available, as when another
536
+ organism of the account holds its port. It shows the organism, its lobes, the library and the place the person stands
537
+ on; a lobe is at `/~/<ID>`. What more a person is offered there, other homes, devices let in, lists and choices, is a
538
+ window's of your own (Where Nervur stops). Only a host where a person sits holds a screen: a Mac, Windows, Linux inside
539
+ a graphical session, or any machine whose first install said `--screen`; on a server, a Pi
540
+ or Linux over `ssh`, `nervur screen` answers that the host holds none, and the organism is owned at its console or from
541
+ afar. A browser draws in the site's page, a phone in its app; an edge draws nothing.
542
+
543
+ A model is present at the console as a person is, and holds no more: `nervur mcp` serves it the tools `ask` and `lobe`,
544
+ each typed at the console, and the resources `nervur://portrait`, `nervur://guide` and `nervur://state`. A method marked
545
+ `irreversible` is hinted destructive. `portrait` answers Nervur's guide, the organism's character and each lobe with its
546
+ own guide.
547
+
548
+ ## Life across devices and years
549
+
550
+ - **A backup** carries the self, never the body: `nervur backup <file>`, never written over, says how it opens: by the
551
+ passphrase and the salt it names, or by a copy of `boot.key`. The brain's `backup {keys}` adds public keys, as
552
+ `nervur arrive` shows them, whose secrets open it too. A repo with no lobe elsewhere stays behind, and the backup
553
+ names it first: keep a lobe of every repo on a second organism.
554
+ - **Taking a backup by asks**, from a faculty, an app or afar: `backup` answers at once `{sequence, mark}`, and the
555
+ organism writes on, however large it is. Ask `backupPiece {mark, at, length}` from `at: 0`, each `at` the one before
556
+ plus the bytes it gave: a piece answers once its bytes are written, so no ask waits on the whole. The piece that
557
+ holds the last byte adds `bytes`, the size, `unread`, each cell left out, and `lost`; then `backupPiece` at `bytes`
558
+ answers no bytes and takes the backup from beside the store. A writing that failed answers the next piece with why.
559
+ A move's pieces go the same way, and its ask at `bytes` answers the last piece and stops the old copy.
560
+ - **A restore** is a new life: `nervur restore <file> [salt]` where no organism stands. With the salt the
561
+ backup named, it asks the passphrase it was made under; without, it reads the boot key it was made under as hex on
562
+ standard input, `nervur restore <file> < boot.key`. Lobes, cells and wiring stand, and its repos are laid under its
563
+ own home; every relation the organism gave is dropped, listed by `ends` and `state` as `ungiven` until it is
564
+ reinvited or dropped; standings it holds go on.
565
+ - **A move** is the same life elsewhere, every relation whole: `nervur arrive` on the new device shows a key;
566
+ `nervur move <key> [file]` on the old seals the organism to it and stops the old copy for good;
567
+ `nervur restore <file>` on the new opens it. `nervur stay` on the old undoes the stop while the new copy never ran.
568
+ From afar, the brain's `move {to}` then `backupPiece` carry it; an edge arrives by `POST /.nervur/arrive` and
569
+ `/.nervur/lay`. The key is the whole of what decides where the organism goes: whoever swaps it on its way gets the
570
+ organism. So the person compares the key the new device shows with the one the move names before it goes; an app
571
+ that carries the key can make that easy, showing both sides a few words or digits drawn from the key's SHA-256 for
572
+ the person to match, and refusing until they match.
573
+ - **A standing handed** moves one relation the organism holds to another organism its owner asks, the place told
574
+ nothing: the brain's `taking` there answers `{key, until}`, a key that stands until then beside any other drawn,
575
+ `cede {far, to}` here forgets the standing and answers it sealed to that key, the same bytes again for
576
+ `removedKeysSpan`, and `take {handed, key, relation, lobe?, note?}` there keeps and grants it as `accept` does, its
577
+ numbers going on; a backup of this copy from before the hand is a stranger at the place once the new holder had two
578
+ asks answered.
579
+ - **Keys.** `nervur rewrap` changes the boot key alone; `nervur rekey` changes the data key too, so a former holder of
580
+ the key opens nothing written after.
581
+ - **Recovery keys** prove the right to reclaim and open nothing:
582
+ `nervur ask brain recoveryKeys '{"keys":["<ed25519 public key, hex>"]}'`. A set replacing another holds only after a
583
+ week by default, the install's word `recoveryKeyDelay` moving it, so whoever took a device cannot replace them before
584
+ the owners reclaim. `nervur reclaim` shows a challenge; sign it with a key's secret off the device and type
585
+ the signature back, taking whatever time signing needs: the challenge stands until its signature or a refusal ends
586
+ it, even where the host lets the organism go meanwhile, as an edge does when idle. Every relation to the brain ends,
587
+ and the anchor is taken anew.
588
+ - **An update** is tried before it is kept: `nervur update [version] [digest]` stops the organism, a run going lost
589
+ to it as to a crash, keeps the old package and store aside, boots the new version in place on a copy of the store
590
+ as a trial with the world held, and keeps it or brings the old back by itself; that boot moves the installer's
591
+ organs and the lobes on its faculties, and the update says what moved and what stayed, run again where one stayed.
592
+ It is the same on a
593
+ machine no one is present at, laid with `--claim`. A version older than the one running is a move onto it. From
594
+ afar: `upgrade {version, digest}`. Until 1.0.0 every organism updates itself too: its process asks the registry it was
595
+ laid from or last updated by, npm's own unless `--channel` named another for an act, as it starts and every hour, and
596
+ runs `nervur update` onto a newer version, its outcome in `organism.log`; one laid from a package at hand
597
+ (`--package`) has no channel and checks nothing. A start, a trial and a stop wait on the process's silence, so an
598
+ organism whose store takes long to open is waited for. A browser and a phone try each version at its first boot
599
+ against a copy of the store, an edge when laid again.
600
+ - **The way back** always stands: `nervur stop`, then `nervur start --floor`, lays the console and window the installer
601
+ ships, whatever skin was chosen, and the window wears the installer's design again, whatever design was worn: the
602
+ design lobe that was worn stands, and is worn again from the home.
603
+ - **A damaged store** is read by `nervur salvage [file]`, with no boot. `nervur wipe` ends the organism for
604
+ good.
605
+
606
+ ## A repo to build in
607
+
608
+ Everything you build stands in a repo, kept by a repo lobe on your organism, on a host with a body: the floor's repo
609
+ faculties, which the Node port lays the first time you want a repo.
610
+
611
+ **What it holds**:
612
+
613
+ ```text
614
+ package.json its version, and its scripts: gate and conform always
615
+ tools/conform.mjs the repo's own rules, run over what would enter main
616
+ faculties/<label>/ a faculty each: faculty.js, versions.json, its tests and evidence
617
+ organs/<id>/ an organ each: graph.json, host/build
618
+ designs/<name>/ a design each: design.json, tokens/, skin/, components/, versions.json
619
+ README.md, LICENSE.md, .gitignore
620
+ ```
621
+
622
+ Any other folder is its owners' own, packages among them, and Nervur reads none of it. No `package.json` names
623
+ `@nervur.org/genome`, and `@nervur.org/floor` names none among its dependencies, so nothing installed shadows the lent
624
+ one: the organism lends the genome it runs at `repos/node_modules/@nervur.org/genome`, one folder up from every repo, so
625
+ `import { replay } from '@nervur.org/genome/evidence'` resolves in its tests and build. The lent genome
626
+ carries Nervur's guide, this paper and the changelog in its `docs/`: an agent authoring a repo reads them at
627
+ `../node_modules/@nervur.org/genome/docs/`, at the organism's version. `.env` is written from the copy's keys before
628
+ each run, so `.gitignore` names it, and every `dist/`.
629
+
630
+ **Its scripts** are the only commands a repo lobe runs: `gate`, run before each commit, and `conform`, the
631
+ repo's own rules; by convention also `format`, `lint`, `types`, `test`, `build`, `release`, `text` (writes each
632
+ faculty's `faculty.js` and `versions.json`) and, for a design repo, `design`.
633
+
634
+ **Making one.** One command makes the repo and its repo lobe, on a host with a body, and answers the lobe:
635
+
636
+ ```sh
637
+ field() { node -pe "JSON.parse(require('fs').readFileSync(0,'utf8')).result$1"; }
638
+ repo=$(nervur repo acme --starter --json | field .lobe)
639
+ ```
640
+
641
+ `nervur repo acme` lays the jailer, `nervur.repos`, the lobe that alone runs git, where the organism has none (a first
642
+ repo is the first time anyone wants one, and no install lays it), set up at the disk's folder; creates a repo lobe on the
643
+ faculty `nervur.repo`, wired to the jailer and to the organism's ear, mouth, scheduler and library; grants it the folder
644
+ `acme`, a lowercase name that begins with a letter and may carry its domain, as `example.com`; and begins it with its
645
+ `init`, waiting for that job's end as `--follow` does. Said in a line, it names the repo lobe; with `--json` it answers
646
+ `{"result": {"folder", "jailer", "lobe", "init"}}`, `init` the job whole. It exits on the code the `init` ended on, and
647
+ a repo lobe holding the folder then is yours to begin again by the same command. `nervur repos` alone lays the jailer.
648
+
649
+ Run again, it makes nothing twice: a jailer that stands is used, a folder a repo lobe holds already answers that lobe,
650
+ and a repo lobe whose `init` failed begins again. A folder the jailer holds granted to no lobe is refused, and a name the
651
+ jailer refuses leaves no lobe made.
652
+
653
+ `--starter` lays a `package.json` with `gate` and `conform`, `tools/conform.mjs`, one faculty, `com.example.acme`, and
654
+ a `.gitignore` keeping out `.env` and `node_modules/`, as the first commit; `README.md` and `LICENSE.md` are yours to
655
+ write; without it the repo begins empty, for the first commit to fill. The folder is `repos/acme` under the disk's
656
+ folder; author it there with your own editor and agent, or write through the lobe.
657
+
658
+ **Committing.** `commit {message, files?, paths?, executable?, gate?}` writes `files` (path to text), runs the gate,
659
+ then the two checks: Nervur's check of the parts and your `conform`. Any red refuses the whole and puts every
660
+ file back. A commit with no `files` commits what the folder holds. Name `paths` instead, each a file or a folder of the
661
+ repo, and it commits the changes of those paths alone, added, changed or removed, leaving the rest of the folder as it
662
+ stands: the way for a session to commit its own work where another works in the same folder. The gate still runs on the
663
+ folder as it stands, the two checks on the repo as that commit leaves it, and `paths` holding no change refuse it. The
664
+ gate runs after `npm ci` where a
665
+ `package-lock.json` stands, so `node_modules` is the lockfile's, and nothing patched there by hand survives. A commit is
666
+ a job: it answers `{job}` at once, and `job {job}` reads it whole, its `ended` `{code, out, err}` once it ends, code 0
667
+ committed. `--follow` waits for that end, told by the organism and never asked again, prints the job whole and exits on
668
+ its code:
669
+
670
+ ```sh
671
+ nervur lobe "$repo" commit '{"message":"reminders"}' --follow
672
+ ```
673
+
674
+ A `build`, a `pull`, a `push` and an `init` are jobs alike.
675
+
676
+ **Telling a version.** The repo's version is its root `package.json`'s `version`. A commit that raises it is tagged
677
+ `v<version>`, and the tag tells every faculty, organ and design version its commit holds; from then those bytes never
678
+ change. A part's version stays in progress, free to change, until a tag tells it. A told version that
679
+ must change takes a new version.
680
+
681
+ **Into the library.** The library takes a told version from the repo lobe, by its label, checks the digest, and keeps it
682
+ under the road `<repo lobe>@<version>`. A lobe is then created on its digest:
683
+
684
+ ```sh
685
+ offer='{"road":"'"$repo"'","kind":"faculty","label":"com.example.reminders","version":"0.1.0"}'
686
+ digest=$(nervur lobe library add "$offer" --json | field .digest)
687
+ lobe=$(nervur ask brain create '{"faculty":"'"$digest"'","wiring":{"scheduler":"scheduler"}}' --json | field .id)
688
+ ```
689
+
690
+ A faculty's text held in a file enters by your hand instead:
691
+ `nervur lobe library add "$(node -p 'JSON.stringify({source: require("fs").readFileSync("faculty.js", "utf8")})')"`,
692
+ kept under `hand@<version>`, by the Node every install lays. Before a lobe stands, the floor's window and terminal show
693
+ the faculty as the library keeps it: its placeholders, the organs it becomes a skin lobe of, whether it talks to the
694
+ world.
695
+
696
+ ## A faculty
697
+
698
+ A faculty is one module of JavaScript: its default export a class extending `Faculty` from `nervur:faculty`, its static
699
+ `blueprint` naming its name and version. Its source is named by its SHA-256, the digest. Each ask runs on
700
+ a fresh instance, in a cage with no clock, no chance and no I/O: time and chance come from the stamp, the world only by
701
+ asks. Whatever must last stands in its cells. The cage holds the language's own objects and nothing of a browser's or
702
+ Node's: no `URL`, no `TextEncoder`, no `Intl`, no timer. What `@nervur.org/genome/standard` gives works there as on the
703
+ host, so a faculty that bundles it checks a tree as the screen does; any other module it bundles must reach for no more.
704
+
705
+ ### A whole example
706
+
707
+ A reminder faculty: it keeps reminders, sets an alarm with the scheduler by a letter, is rung once, and draws itself.
708
+
709
+ ```js
710
+ import { Faculty } from 'nervur:faculty';
711
+
712
+ export default class Reminders extends Faculty {
713
+ static blueprint = {
714
+ name: 'com.example.reminders',
715
+ version: '0.1.0',
716
+ description: 'Keeps reminders and rings each once, at its time.',
717
+ guide: 'Ask `add` with a text and a wall time in milliseconds; `list` reads them; the screen draws them.',
718
+ methods: {
719
+ add: {
720
+ description: 'Keeps a reminder and sets its alarm. Answers its id.',
721
+ kind: 'writing',
722
+ args: {
723
+ type: 'object',
724
+ properties: { text: { type: 'string', minLength: 1, maxLength: 200 }, at: { type: 'integer', minimum: 0 } },
725
+ required: ['text', 'at'],
726
+ additionalProperties: false,
727
+ },
728
+ result: { type: 'object', properties: { id: { type: 'integer' } }, required: ['id'] },
729
+ errors: ['refused'],
730
+ },
731
+ list: { description: 'Every reminder, the rung ones marked.', kind: 'reading' },
732
+ ring: { description: "The scheduler's alone: a reminder's time came.", kind: 'writing', askers: ['scheduler'] },
733
+ draw: { description: 'The reminders as a tree.', kind: 'reading' },
734
+ },
735
+ placeholders: { scheduler: 'nervur.scheduler' },
736
+ };
737
+
738
+ *add(args) {
739
+ const refused = this.checked('add', args);
740
+ if (refused !== undefined) return refused;
741
+ if (args.at <= this.stamp.time) return this.error('refused', 'a reminder rings later than now');
742
+ const id = (this.cells.get(['next']) ?? 0) + 1;
743
+ this.cells.set(['next'], id);
744
+ this.cells.set(['reminder', id], { text: args.text, at: args.at, rung: false });
745
+ // A letter: the alarm is set exactly once, whatever happens after this answer.
746
+ yield {
747
+ placeholder: 'scheduler',
748
+ method: 'set',
749
+ args: { at: args.at, method: 'ring', args: { id } },
750
+ letter: { lives: 86_400_000 },
751
+ };
752
+ return { id };
753
+ }
754
+
755
+ list() {
756
+ return this.cells.range({ prefix: ['reminder'] }).cells.map(({ key, value }) => ({ id: key[1], ...value }));
757
+ }
758
+
759
+ ring(args) {
760
+ const kept = this.cells.get(['reminder', args.id]);
761
+ if (kept === undefined) return null;
762
+ this.cells.set(['reminder', args.id], { ...kept, rung: true });
763
+ return null;
764
+ }
765
+
766
+ draw() {
767
+ const rows = this.list().map((one) => ({
768
+ t: 'li',
769
+ a: {},
770
+ k: String(one.id),
771
+ c: [one.rung ? `${one.text} (rung)` : one.text],
772
+ }));
773
+ return {
774
+ t: 'main',
775
+ a: {},
776
+ c: [
777
+ { t: 'h1', a: {}, c: ['Reminders'] },
778
+ { t: 'ul', a: {}, c: rows },
779
+ ],
780
+ };
781
+ }
782
+ }
783
+ ```
784
+
785
+ Saved as `faculties/com.example.reminders/faculty.js`, with `versions.json` naming its digest, committed under a raised
786
+ version, added to the library and created with `wiring: {"scheduler": "scheduler"}`, it runs:
787
+ `nervur lobe <ID> add '{"text":"Call home","at":1893456000000}'`, and the screen shows it at `/~/<ID>`.
788
+
789
+ ### The blueprint
790
+
791
+ A blueprint holds `name`, `version`, `methods`, and where wanted `description`, `guide`, `openGuide`, `placeholders`
792
+ and `assets`; the standard refuses any other field.
793
+
794
+ - **`name`**: a publisher's reverse domain of two labels or more, then the capability, lowercase:
795
+ `com.example.reminders`. The folder under `faculties/` is its label, the same name.
796
+ - **`version`**: three whole numbers. One name and version names one digest for ever.
797
+ - **`guide`**: prose on how the faculty is run and used, read by its owners, by a lobe wired to it and by whoever holds
798
+ a standing on its lobe, never by a stranger unless `openGuide` is true. Say there what a skill would say:
799
+ how it is run is the guide's, never a harness's.
800
+ - **`placeholders`**: each need, a fixed ID (lowercase words joined by dashes) to the blueprint name it expects, or
801
+ `null` for any. A declaration wires nothing: the owner names each wire at `create` or by `order`.
802
+ - **`methods`**: each by a camelCase name, never one opening with `#`, nor `then`, nor a base class name (`stamp`,
803
+ `cells`, `nerves`, `codec`, `crypto`, `quo`, `cage`, `memory`, `ask`, `error`, `describe`, `checked`). Each method
804
+ holds `kind` (`reading` or `writing`, required), and where wanted `description`, `args` and `result` (JSON Schema of
805
+ the standard's subset; `args` an object schema), `errors` (its own codes, none of the genome's), `budget` (ms, only
806
+ where its work must be bounded shorter: with none it works up to the longest budget), `askers` (the fixed IDs alone
807
+ that may ask it, held by the brain), `irreversible` (`true`, or the name of the arg naming what it ends) and `seat`
808
+ (data beside it for a person, below).
809
+
810
+ A schema's `pattern` is an I-Regexp (RFC 9485): no `(?:…)`, no lookaround, no `\d`, `\w`, `\s` or `\b`; write `[0-9]`.
811
+
812
+ **A seat** is data a method carries for whoever draws it for a person: `{for, label, ...}`. `for` is `person`,
813
+ `machine` or `both`; `label` an object of language tag to text, at most 32 tags of at most 500 characters each. Any
814
+ other field is free data the genome gives no meaning, for a window or a design of yours to read; the whole seat, as
815
+ text, holds at most 16,384 characters. An organ's method carries none. The floor's window draws only the methods
816
+ seated `for` a `person` or `both`, each by its `label` in the person's language, else its primary subtag, else the
817
+ first the seat holds, and never one seated for a `machine`; a window of your own reads the seat as it chooses.
818
+
819
+ **The person's language.** The floor's window picks the seat's words. What a method answers is the place's to word: a
820
+ place that declares a writing method `told` is asked it, `told({size, language, standard})`, when a person first walks
821
+ to it and again only where one moved; it keeps them by `this.stamp.occupant`, the standing that told them. A place that
822
+ draws hears the same three as `args.told` of each draw. `size` is the class of the screen's size, `compact`, `medium`
823
+ or `expanded`; the language is the one the person's screen tells; `standard` the standard's version. The host tells a
824
+ place nothing else of the screen.
825
+
826
+ ### A door of another kit
827
+
828
+ A door of any Quo kit is shown as a Nervur place is where its describe speaks this language. The describe is Quo's,
829
+ `{lang, asks}`, with `lang` the text `nervur.blueprint`; beside them it may hold `name`, `version` and `description`,
830
+ as a blueprint does. Each entry of `asks` holds `method` and, as a blueprint's method does, `kind`, `description`,
831
+ `args`, `result`, `irreversible` and `seat`:
832
+
833
+ ```json
834
+ {
835
+ "lang": "nervur.blueprint",
836
+ "name": "com.example.accounts",
837
+ "version": "1.0.0",
838
+ "asks": [
839
+ { "method": "balance", "kind": "reading", "seat": { "for": "person", "label": { "en": "Balance" } } },
840
+ {
841
+ "method": "closeAccount",
842
+ "kind": "writing",
843
+ "irreversible": true,
844
+ "seat": { "for": "person", "label": { "en": "Close the account" } }
845
+ }
846
+ ]
847
+ }
848
+ ```
849
+
850
+ `kind` says what an ask does: a `reading` changes nothing, a `writing` may, and `irreversible` says it cannot be
851
+ undone; an entry that says no `kind`, as a describe of no `lang` does, is an ask whose effect its door did not say.
852
+ The floor's window asks a `reading` by itself, to draw and to draw again, a `writing` only by the person's press, one
853
+ declared `irreversible` only past its consent, and one with no `kind` only by the person's own press, said first as
854
+ an ask that may change something, one press one ask. `args` is a flat object schema of the standard's subset.
855
+
856
+ ### Methods, cells and the stamp
857
+
858
+ - A method takes its args and answers data, or `this.error(code, message)`. An error code is lowercase words
859
+ joined by dashes. The genome's own codes are `timeout`, `unavailable`, `busy`, `fault`, `silent`, `removed`,
860
+ `repeated`; a method that throws is a `fault`.
861
+ - **The brain checks no args**. Open a method with `this.checked(method, args)`, which answers `refused` where
862
+ the args do not meet the blueprint's schema, and nothing where they do.
863
+ - **Writing and reading.** A writing method runs alone, and its writes land in one batch when it answers: an answer
864
+ always means it happened, and a timeout, fault or `busy` leaves nothing written. A reading method writes no
865
+ cell, may ask any node and runs beside others. An ask that could start only once a run waiting on it ended hears
866
+ `refused` at once: one back to its own lobe, through a wire to itself, another lobe or the brain, unless both are
867
+ reading and it can start beside the run; and one that meets another run waiting the other way, two lobes asking
868
+ each other or a loop through more. A writing method that needs its own lobe's answer reads its cells instead, or
869
+ posts a letter, which is never waited on. A run may have several asks in flight: racing them (`Promise.race`) is
870
+ never refused for the one it may not need, and awaiting all of them (`Promise.all`) where one would wait on a run
871
+ that waits on you hears that one `refused` the moment the others have answered. A move of a lobe's version, or a
872
+ settle, asked while a run of that lobe waits on you, is refused at once.
873
+ - **Waiting.** A run that must pause, before a retry or while it holds its lobe, asks its own `nerves`:
874
+ `await this.ask('nerves', 'wait', { ms })`, answered `null` once `ms` has passed, or `timeout` where the ask's time
875
+ ends first. It spends none of the run's budget, and the run keeps its place in its lobe. Never pause by asking your
876
+ own lobe and letting the timeout run out: that ask is refused at once.
877
+ - **Cells.** `this.cells.get(key)`, `set(key, value)`, `delete(key)` and
878
+ `range({prefix?, from?, to?, limit?, cursor?})`, a page of at most 1,000, 100 by default, with its `cursor`. A key
879
+ is a tuple of scalars, kept in order. Size what you read at once by `this.memory`, the lobe memory, never a number of
880
+ your own.
881
+ - **The stamp**: `this.stamp.asker`, the ID of who asks (`brain` for an owner); `time`, ms since 1970; `seed`,
882
+ 32 fresh bytes, the only chance; `occupant`, `{far, note}` on an ask from far, else null; `memory`.
883
+ - **Tools.** `this.codec` (`text`, `read`, `base64`, `utf8`, `utf8Text`, in place of `TextEncoder`), `this.crypto`
884
+ (`sha256`, `hkdf`, Ed25519, X25519, ML-KEM, AES), `this.quo` (`readInvitation(text, schemes)`, which checks the
885
+ invitation's signature in the cryptography Nervur ships, the same on every host: an invitation from an organism whose
886
+ port brought another for new invitations reads as none here, and only that organism's own accept reads it),
887
+ `this.cage.run`.
888
+ - **Imports.** The module imports `nervur:faculty` alone; bundle every other module into it.
889
+
890
+ ### Asking
891
+
892
+ A method asks a node over one of its placeholders, and the brain carries it. Two forms answer alike:
893
+
894
+ ```js
895
+ const answer = await this.ask('scheduler', 'now', {}); // in an async method
896
+ const answer = yield { placeholder: 'scheduler', method: 'now', args: {} }; // in a generator method
897
+ ```
898
+
899
+ An answer is `{result}` or `{error: {code, message}}`. An ask names a `timeout` in ms only where an answer is worth no
900
+ longer. Options: `letter: {lives}` posts it as a letter to a lobe; `durable: true` marks it durable to an
901
+ organ's method so marked. `this.nerves.read()` answers its placeholders, their wires and statuses, its relations and the
902
+ organism's level; `this.nerves.order({termination, placeholder?, until?})` orders a wire, only to its own children and
903
+ to who asked it; `this.nerves.unwire(placeholder)` lets one go.
904
+
905
+ ### Signals, letters and alarms
906
+
907
+ - **A signal** lives in memory and is lost in a crash. **A letter** is kept until the lobe takes it, exactly once: its
908
+ asker hears `null` at once, and the answer reaches no one. An ask whose loss matters is a letter.
909
+ - **Alarms** are the scheduler's: `set {at, method, args?}` rings the asker's own `method` with `args` at the
910
+ wall time `at`, as a letter, exactly once through any reboot. Post `set` as a letter. `cancel {id}`, `list`, `now`. A
911
+ ring answered `{again: <time>}` sets the same ring again at that time. Name the ringing method's
912
+ `askers: ["scheduler"]`, as the example does, so no one else rings it.
913
+ - **An ask back, a letter taken again or a durable ask sent again is a cue to read cells,** never proof that something
914
+ happened once.
915
+
916
+ ### Long work, jobs and pieces
917
+
918
+ Work longer than one ask answers at once. Where the node can ask its asker back, it orders a wire back through
919
+ `nerves` and asks it when the work ends; where it cannot, as for an owner, it answers `{job}`, and the asker reads
920
+ `job {job}`, `ended` null while it runs, then holding its exit code. One ask back tells how a job ended:
921
+ `done {job, kind, code, out, err}`. What is longer still is cut into pieces, each its own ask, judged by progress: a
922
+ piece that times out is asked again, and the whole fails only once it stood still for its span. A lobe working
923
+ step by step keeps its next step in its cells and starts it by an alarm.
924
+
925
+ ### The brain's words
926
+
927
+ The base class answers each of these by doing nothing. Declare in your blueprint each one you act on: but `migrate`,
928
+ the brain asks a word only of a lobe whose blueprint declares it, so a method of that name the blueprint leaves out is
929
+ never run. None but the brain asks them:
930
+
931
+ | Word | When |
932
+ | ----------------------------- | --------------------------------------------------------------------------------- |
933
+ | `migrate {from}` | a move to this version, `from` the digest left; it converts the old cells |
934
+ | `left {far, note}` | an occupant this lobe gave ended: forget what you kept of it |
935
+ | `silent {placeholder, since}` | a standing it holds fell silent |
936
+ | `back {placeholder}` | a far organism's line, an organ, or a lobe it reaches is back: deliver what waits |
937
+ | `line {far, up}` | the line an occupant it gave is reached through came up or went down |
938
+ | `restored {at, commit}` | the organism came back from a backup |
939
+
940
+ Every word the brain adds after 1.0.0 opens with `#`, which no method takes.
941
+
942
+ ### Describe and draw
943
+
944
+ - **`describe()`** answers an ask naming no method: the blueprint by default. Define your own to answer by state or by
945
+ who asks; the brain strips the guide for whoever may not read it (`guide`, above).
946
+ - **`draw(args)`**, a reading method, answers a tree the screen draws: `{t, a, k?, press?, c}`, `t` an
947
+ allowed element, `a` its attributes, `k` a key unique among siblings, `c` its children, each a tree or a text. A draw
948
+ reads its cells and its args alone: the brain refuses every ask it makes. A lobe that declares `draw` a reading is
949
+ drawn by it; one without is drawn by the window from its describe, a page of its methods, its reading ones with what
950
+ they answered and its writing ones each a form with a field for each arg. See What a tree may hold for the elements,
951
+ presses and inputs, and A window of your own for who carries a press.
952
+
953
+ ### Evidence and tests
954
+
955
+ A faculty proves itself by evidence: pieces of its world, each `{says, cells, asks, yields}`, each ask
956
+ `{stamp, method, args, given, answer}`, `given` the asks the lobe makes, in order, each
957
+ `{placeholder, method, args, answer}`. Replayed in a fresh runtime, every answer and the cells it yields must be
958
+ those it says. A stamp is `{asker, time, seed, occupant?, memory?}`, `seed` 32 bytes. A given ask the lobe posts as a
959
+ letter carries its `letter: {lives}`, held to the letter it posts; a run of `this.cage.run` the host cut stands among
960
+ `given` as `{cut: n}`, the ask's `n`th run from 1. Evidence is data, so write it as data, never as the
961
+ `Piece` or `Asked` types of `@nervur.org/genome/evidence`, which are what the replay reads it into.
962
+
963
+ It ships as an asset: `faculties/<label>/assets/evidence.json`, whose asset path is `evidence.json`, so the proof
964
+ outlives its repo; one with none is allowed and shown `unproven`. Its text is data's one text, RFC 8785, bytes
965
+ written as `{"$bytes":"<lowercase hex>"}`: write it by `dataText` and read it by `readText`, both of
966
+ `@nervur.org/genome/standard`. The evidence, beside the faculty:
967
+
968
+ ```js
969
+ // faculties/com.example.reminders/evidence.mjs
970
+ const stamp = (asker, time) => ({ asker, time, seed: new Uint8Array(32) });
971
+ const set = {
972
+ placeholder: 'scheduler',
973
+ method: 'set',
974
+ args: { at: 5000, method: 'ring', args: { id: 1 } },
975
+ letter: { lives: 86_400_000 },
976
+ };
977
+
978
+ export default [
979
+ {
980
+ says: 'A reminder is kept, its alarm set by a letter, and its ring marks it rung.',
981
+ cells: [],
982
+ asks: [
983
+ {
984
+ stamp: stamp('brain', 1000),
985
+ method: 'add',
986
+ args: { text: 'Call home', at: 5000 },
987
+ given: [{ ...set, answer: { result: null } }],
988
+ answer: { result: { id: 1 } },
989
+ },
990
+ {
991
+ stamp: stamp('brain', 1001),
992
+ method: 'add',
993
+ args: { text: 'Late', at: 10 },
994
+ given: [],
995
+ answer: { error: { code: 'refused' } },
996
+ },
997
+ { stamp: stamp('scheduler', 5000), method: 'ring', args: { id: 1 }, given: [], answer: { result: null } },
998
+ ],
999
+ yields: [
1000
+ { key: ['next'], value: 1 },
1001
+ { key: ['reminder', 1], value: { text: 'Call home', at: 5000, rung: true } },
1002
+ ],
1003
+ },
1004
+ ];
1005
+ ```
1006
+
1007
+ Its test replays what ships, the asset:
1008
+
1009
+ ```js
1010
+ // faculties/com.example.reminders/reminders.test.mjs
1011
+ import assert from 'node:assert/strict';
1012
+ import { readFileSync } from 'node:fs';
1013
+ import { test } from 'node:test';
1014
+ import { replay } from '@nervur.org/genome/evidence';
1015
+ import { readText } from '@nervur.org/genome/standard';
1016
+
1017
+ const text = (path) => readFileSync(new URL(path, import.meta.url), 'utf8');
1018
+
1019
+ test('The reminders hold their evidence', () => {
1020
+ const evidence = readText(text('./assets/evidence.json'));
1021
+ assert.ok('data' in evidence, evidence.why);
1022
+ assert.deepEqual(replay(text('./faculty.js'), evidence.data).missed, []);
1023
+ });
1024
+ ```
1025
+
1026
+ `replay(source, evidence)` answers `{missed, made}`: each piece that did not hold, with why, and every ask the lobe
1027
+ made, its timeout and letter with it, for a test to read. `readSkin(source)` reads a source as the first install does,
1028
+ its blueprint and digest or why it is refused. `@nervur.org/genome/kit` holds more: `rigOver` runs organisms on the real
1029
+ engine, `hosting` and `lobeOf` a class on a recording host. A gate runs the tests,
1030
+ `"gate": "node tools/conform.mjs && node --test"`.
1031
+
1032
+ **Assets.** Every file under `assets/`, a hidden name aside, is an asset by its path there. A faculty with any names
1033
+ their digest in its blueprint as `assets`, a string of 64 lowercase hex: the SHA-256 of the canonical JSON of the
1034
+ `[path, sha256]` pairs sorted by path, each `sha256` that of the file's bytes, a text's with LF line ends.
1035
+ Nervur's check of the parts refuses a blueprint whose `assets` is not that digest, and assets with none. The repo lobe
1036
+ tells and serves them, so a faculty that comes by a repo arrives proven, each version with the assets it was told with,
1037
+ however a later version changes them; one added by hand carries them,
1038
+ `add {source, assets}`, each asset `{path, digest, text}` or `{path, digest, base64}`.
1039
+
1040
+ ### Its text and its versions
1041
+
1042
+ `faculty.js` is the text as it ships, committed; `versions.json` maps each version to the SHA-256 of that text, in
1043
+ lowercase hex. Nervur's check of the parts refuses a `faculty.js` that is not the text `versions.json` names at its
1044
+ version, and a told entry changed. A faculty written in plain JavaScript is its own text; one written
1045
+ in TypeScript, or in many modules, is bundled into one module by the repo's `text` script, `nervur:faculty` kept
1046
+ external, `@nervur.org/genome/faculty` aliased to it. Every other module is bundled in, what it takes of
1047
+ `@nervur.org/genome/standard` among them, so the text is all the code the faculty runs, and a genome whose bundled code
1048
+ moved moves the text: a version a tag told keeps its committed `faculty.js`, and a text rebuilt otherwise takes a new
1049
+ version, as the check refuses the told one changed. The assets digest stands
1050
+ inside the text, so it is written first, then the text's digest. The steps after any bundling, for a blueprint that
1051
+ holds `assets: '<64 hex>'`, any at first, where the faculty has assets:
1052
+
1053
+ ```js
1054
+ // tools/text.mjs, the script "text": each faculty's evidence asset, its blueprint's assets digest, its versions.json
1055
+ import { createHash } from 'node:crypto';
1056
+ import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
1057
+ import { pathToFileURL } from 'node:url';
1058
+ import { dataText } from '@nervur.org/genome/standard';
1059
+
1060
+ const sha = (bytes) => createHash('sha256').update(bytes).digest('hex');
1061
+ const canonical = (bytes) =>
1062
+ bytes.includes(0) ? bytes : Buffer.from(bytes.toString('latin1').replace(/\r\n?/gu, '\n'), 'latin1');
1063
+ const filesIn = (at, below = '') =>
1064
+ readdirSync(`${at}/${below}`, { withFileTypes: true })
1065
+ .filter((entry) => !entry.name.startsWith('.'))
1066
+ .flatMap((entry) => {
1067
+ const path = below === '' ? entry.name : `${below}/${entry.name}`;
1068
+ return entry.isDirectory() ? filesIn(at, path) : [path];
1069
+ });
1070
+
1071
+ for (const label of readdirSync('faculties')) {
1072
+ const at = `faculties/${label}`;
1073
+ if (existsSync(`${at}/evidence.mjs`)) {
1074
+ const { default: evidence } = await import(pathToFileURL(`${at}/evidence.mjs`).href);
1075
+ mkdirSync(`${at}/assets`, { recursive: true });
1076
+ writeFileSync(`${at}/assets/evidence.json`, `${dataText(evidence)}\n`);
1077
+ }
1078
+ let text = readFileSync(`${at}/faculty.js`, 'utf8');
1079
+ if (existsSync(`${at}/assets`)) {
1080
+ const pairs = filesIn(`${at}/assets`)
1081
+ .map((path) => [path, sha(canonical(readFileSync(`${at}/assets/${path}`)))])
1082
+ .toSorted((one, other) => (one[0] < other[0] ? -1 : 1));
1083
+ const named = /\bassets\s*:\s*['"][0-9a-f]{64}['"]/u;
1084
+ if (!named.test(text)) throw new Error(`${at}: its blueprint names no assets: '<64 hex>'`);
1085
+ text = text.replace(named, `assets: '${sha(JSON.stringify(pairs))}'`);
1086
+ writeFileSync(`${at}/faculty.js`, text);
1087
+ }
1088
+ const blueprint = text.slice(text.search(/\bstatic\s+blueprint\s*=/u));
1089
+ const version = /\bversion\s*:\s*['"]([^'"\n]+)['"]/u.exec(blueprint)[1];
1090
+ const path = `${at}/versions.json`;
1091
+ const versions = existsSync(path) ? JSON.parse(readFileSync(path, 'utf8')) : {};
1092
+ versions[version] = sha(text);
1093
+ writeFileSync(path, `${JSON.stringify(versions, null, 2)}\n`);
1094
+ }
1095
+ ```
1096
+
1097
+ ### Moving a lobe
1098
+
1099
+ A lobe outlives its faculty's versions: its ID, wires, relations and cells stay. An owner moves it by
1100
+ `version {lobe, faculty}`, `faculty` the new digest; the new version's `migrate {from}` runs once, and a failure leaves
1101
+ the lobe where it stood. The move keeps one step back until `settle`, a move back, or another move; a
1102
+ lobe too big to keep twice moves with `settled: true`. A placeholder the new version declares anew stands unwired for
1103
+ the owner to wire. Lay what a lobe serves, a table, a content, a model, in its cells by `migrate` or by asks, never in
1104
+ its source, so a version carries only what changed of the logic; a `migrate` that reads `assets` reads the new
1105
+ version's.
1106
+
1107
+ ### Patterns
1108
+
1109
+ - **A plain lobe composing skin lobes.** The shape that repeats: skin lobes hold what reaches the world and its secrets,
1110
+ and a plain lobe holds the use case, asking them and beings. A new use case is a new plain lobe, seldom a new organ.
1111
+ - **Signal or letter.** Asked again anyway: a signal. Its loss matters: a letter. A node that owes an ask back and meets
1112
+ `unavailable` drops it, the asker's cells staying the truth, or posts it as a letter.
1113
+ - **Once, far.** What an ask sent far did stays done, and only the far side's own answer says what happened there. An
1114
+ ask that must not run twice, a payment, carries a key of its asker's, which the far lobe keeps and answers once. On a
1115
+ window of one, an ask answered closes every earlier box, which then hears `repeated`.
1116
+ - **Skin lobes.** Every use of an organ is a skin lobe of its own. A secret reaches its organ only as an ask's
1117
+ input. An organ's long work answers at once and asks its skin lobe back; the skin lobe never asks its organ again from
1118
+ inside that ask back, which waits on its answer: it keeps what follows in its cells and starts it by an alarm.
1119
+ - **Choosing by the nerves.** Read your statuses and answer `unavailable`, take another path, or order your wiring
1120
+ again; at `left`, forget what you kept of that far organism.
1121
+ - **Children.** A lobe raises children through its `nerves`; a child reaches nothing its parent does not.
1122
+ - **Roles are a lobe's**: a relation to a brain is owning; to a lobe, belonging, buying or following, allowed
1123
+ by the lobe's cells and the end's note.
1124
+
1125
+ ## An organ
1126
+
1127
+ An organ is a driver: its judgment lives in its skin lobes, and it holds no cells and declares no placeholder.
1128
+ Build one only for what no lobe can do: a device, a program, heavy computation. On a host with a body an organ comes
1129
+ only from a repo of the organism's own, pulled and built in its body, then admitted by an owner; a host
1130
+ without one runs the halves its embedder's build brought.
1131
+
1132
+ **Its shape** is `{blueprint, reach, half: {form, digest}}`. Its blueprint names its methods with no `kind`,
1133
+ and `durable: true` where an ask should be sent again at each reconnect. `reach` is free data the half reads, given at
1134
+ `addOrgan`. The half is a WebAssembly `component`, given exactly the imports its reach names, or a `native` program for
1135
+ one host. The Node port runs native halves alone today; a component is refused there.
1136
+
1137
+ **In a repo**: `organs/<id>/graph.json`, its blueprint (as `{blueprint}` or the blueprint itself), and
1138
+ `organs/<id>/host/`, one standalone program in any language whose executable `build` leaves it at `host/half`.
1139
+ A native half speaks the bridge: one JSON value a line on its standard input and output, each bytes in it
1140
+ written `{"$bytes":n}` and its n bytes following the newline as they are, its reach as its one argument. Its first frame
1141
+ is its blueprint; it is asked `{"ask": n, "asker", "method", "args"}` and answers `{"answer": n, "result"}` or
1142
+ `{"answer": n, "error": {"code", "message"}}`; it asks its skin lobes
1143
+ `{"ask": n, "placeholder", "method", "args", "timeout"}`; and it may say its status, `{"status": "unavailable"}`,
1144
+ `not ready` or `connected`.
1145
+
1146
+ ```text
1147
+ organs/lamp/graph.json {"blueprint":{"name":"com.example.lamp","version":"0.1.0","methods":{"ping":{}}}}
1148
+ organs/lamp/host/half.sh
1149
+ organs/lamp/host/build #!/bin/sh
1150
+ cp half.sh half
1151
+ ```
1152
+
1153
+ ```sh
1154
+ #!/bin/sh
1155
+ # organs/lamp/host/half.sh: answers every ask "pong"
1156
+ printf '%s\n' '{"blueprint":{"name":"com.example.lamp","version":"0.1.0","methods":{"ping":{}}}}'
1157
+ while IFS= read -r line; do
1158
+ n=$(printf '%s' "$line" | sed -n 's/.*"ask":\([0-9]*\).*/\1/p')
1159
+ [ -n "$n" ] && printf '{"answer":%s,"result":"pong"}\n' "$n"
1160
+ done
1161
+ ```
1162
+
1163
+ **Building and adding it.** Commit it with `host/build` executable and the version raised, so the tag tells it; build it
1164
+ in the body; read its half's digest; add it under its fixed ID:
1165
+
1166
+ ```sh
1167
+ nervur lobe "$repo" commit '{"message":"the lamp","files":{...},"executable":["organs/lamp/host/build"]}'
1168
+ nervur lobe "$repo" build '{"organ":"lamp","version":"0.1.0"}'
1169
+ nervur lobe "$repo" get '{"kind":"organ","label":"lamp","version":"0.1.0"}' # its half names the digest
1170
+ nervur ask brain addOrgan '{"id":"lamp","blueprint":{...},"reach":{"account":"<the shell account>"},"half":{"form":"native","digest":"<digest>"}}'
1171
+ ```
1172
+
1173
+ A reach naming `account` runs the half in the body, as that account; `nervur state` shows the shell's. `addOrgan` again
1174
+ under the same ID is a release: its wires, skin lobes and durable asks stay. A half that fails shows
1175
+ unavailable and restarts alone.
1176
+
1177
+ **Its skin lobe** declares a placeholder named by the organ's ID, expecting its blueprint name, and is wired to
1178
+ it at `create`:
1179
+
1180
+ ```js
1181
+ static blueprint = {
1182
+ name: 'com.example.lamp-skin',
1183
+ version: '0.1.0',
1184
+ methods: { ping: { kind: 'reading' } },
1185
+ placeholders: { lamp: 'com.example.lamp' },
1186
+ };
1187
+ async ping() {
1188
+ const answer = await this.ask('lamp', 'ping', {});
1189
+ return 'result' in answer ? answer.result : this.error(answer.error.code, answer.error.message);
1190
+ }
1191
+ ```
1192
+
1193
+ The organs Nervur holds: `network`, for Quo and the web, every host; `shell` runs programs as the body and `disk` keeps
1194
+ files under one folder, on a host with a body; the console and the screen, presence.
1195
+
1196
+ ## Designs and looks
1197
+
1198
+ A **design** is a repo's design system: tokens, themes, skin and components. Its components build into a **look**, a
1199
+ faculty the window wears, by the design kit `@nervur.org/floor/design`.
1200
+
1201
+ ### A design folder
1202
+
1203
+ ```text
1204
+ designs/plain/design.json {"name":"plain","version":"0.1.0","publisher":"com.acme",
1205
+ "themes":["light","dark"],"tints":["red"],
1206
+ "densities":{"regular":1},"defaults":{"tint":"red","density":"regular"},
1207
+ "classes":["plain-badge"]}
1208
+ designs/plain/tokens/light.json {"--plain-text":"#111111","--plain-surface":"#ffffff"}
1209
+ designs/plain/tokens/dark.json {"--plain-text":"#eeeeee","--plain-surface":"#000000"}
1210
+ designs/plain/tokens/tints.json {"red":{"light":{"--plain-accent":"#b00020"},"dark":{"--plain-accent":"#ff6b81"}}}
1211
+ designs/plain/skin/layers.json {"lobes":["base.css"],"home":[]}
1212
+ designs/plain/skin/base.css .plain-badge { color: var(--plain-accent); }
1213
+ designs/plain/components/badge.ts export default (args, theme) => ({ t: 'span', a: { class: 'plain-badge' }, c: [args.label] });
1214
+ designs/plain/words/en.json {"back":"Back","read":"You are read as {name}.",
1215
+ "days":{"1":"{count} day","other":"{count} days"}}
1216
+ designs/plain/versions.json {"0.1.0":{"data":"<digest>","look":"<digest>"}}
1217
+ designs/plain/DESIGN.md its story
1218
+ ```
1219
+
1220
+ Optional: `fonts/`, with `fonts/fonts.json` as
1221
+ `{"faces":[{"family":"Serif","weight":"400","style":"normal","range":"U+0000-00FF","file":"serif.woff2","licence":"OFL.txt"}]}`,
1222
+ each `file` and `licence` a file of `fonts/` named from there; `icons/` and `figures/`, its pictures.
1223
+
1224
+ **A figure in a component.** The window serves every picture of the design it wears by its digest and its kind, the
1225
+ SHA-256 of the file's bytes and its extension, one of `avif`, `gif`, `jpg`, `png`, `webp` (no SVG, which would run its
1226
+ scripts at the screen's address). A component names one in `img{src}` by both, never by path:
1227
+
1228
+ ```ts
1229
+ // designs/plain/components/logo.ts: figures/logo.png, its digest from `shasum -a 256 figures/logo.png`
1230
+ const LOGO = { asset: '<sha256 of figures/logo.png>', ext: 'png' };
1231
+ export default (args) => ({ t: 'img', a: { src: LOGO, alt: args.label, width: 120, height: 40 }, c: [] });
1232
+ ```
1233
+
1234
+ A font is laid by its face in `fonts/fonts.json`, the screen writing its `@font-face`. A sheet's `url()` may name a
1235
+ file of the design from `skin/`, `url('../figures/grain.png')`: the screen lays it as that file, by its digest, as an
1236
+ `img` names one.
1237
+
1238
+ - **Tokens** stand in both themes, tints as accents over both. The light tokens lie on the root, the dark where the
1239
+ device prefers it, and either where `data-theme` names it, as a site sets it on its pages, so a sheet that reads the
1240
+ tokens follows it with nothing more.
1241
+ - **The skin** has two layers: `lobes`, what every lobe's root wears, whose every selector names a class, an attribute
1242
+ or `:host` and never an element alone; and `home`, the home's own chrome. A class a component writes is declared in
1243
+ `classes` and styled by some rule. A class is a lowercase letter, then lowercase letters, digits and dashes, forty
1244
+ characters at most, so `plain-badge` and never `plain_badge` or `plain__row`, and a tree names eight at most; the
1245
+ build refuses any other, naming it. A sheet loads nothing outside the design: no `@import`, no `url()` but `data:`, a
1246
+ fragment or a file of the design.
1247
+ - **A component** is a file directly in `components/`, its default export a plain function
1248
+ `(args, theme, state, words)` that answers a tree from its args alone; `theme` is `light` or `dark`, `state` the
1249
+ region's local state. A file opening with `_` is a helper; a component may draw another by importing it.
1250
+ - **Words** are optional: `words/`, a file for each language `design.json` names in `languages`, as
1251
+ `"languages":["en","ro"]`, the first the design's own. A key is a letter, then letters, digits, dots, dashes and
1252
+ underscores. A word is a text with places, `{name}`, or a count's forms keyed `other`, whole numbers and the plural
1253
+ categories `zero`, `one`, `two`, `few` and `many`: a count takes its number's form, else the one its language's rule
1254
+ names (Romanian's `few` for 2 to 19, Russian's `few` and `many`), else `other`; the look carries the rules, by primary
1255
+ subtag, and a language it knows not takes a number's form or `other`. A component names a key, never a text:
1256
+ `words('read', { name })` is that word in the person's language, else its primary subtag, else the design's own, its
1257
+ places filled, and `words('days', { count })` the form of that count. A month is a word, `month.1`. What the args hold
1258
+ is drawn as it is. Words build into the look beside the components and are no asset. A design on a stranger's road is
1259
+ handed no language, so its words are empty.
1260
+ - **What the floor's window asks of a design.** It wears only a design that draws `surround`, `organism` and `lobe`,
1261
+ with the args `SCREEN_COMPONENTS` of `@nervur.org/floor/design` gives as data: for each component its `args` as a
1262
+ schema, the `presses` the window answers from its tree, the `slots` it lays and whether wearing `required` it. Each
1263
+ draw is `draw {component, args, theme, state?, lang?}`, `lang` the person's language. `surround {title, route, back?,
1264
+ warnings, main, consent?}` is what the floor's window draws around a page where it has something to say: `route` each
1265
+ step `{label, path}`, `warnings` lines in the home's words, `main` the args its slot `main` carries, laid as
1266
+ `{t: 'slot', a: {placeholder: 'main'}, args: main, c: []}`, and `consent {say, yes, no, yesSay?, noSay?}` the consent
1267
+ the window asks, `yes` and `no` two presses the surround lays as they are handed. `organism` is the organism's page,
1268
+ its `state`, `organs`, `lobes` and, at home, its `relations`, `faculties` and `about`, with the presses
1269
+ `about {faculty}`, `create {faculty}` and `page {cursor}`; a far organism's page is its own, whole, with no press.
1270
+ `lobe` is a lobe's page, its `reading` methods with what each answered and its `writing` methods with their `args`,
1271
+ each with its seat's `label` where it has one, and `written`, what the last press that wrote answered, with the
1272
+ presses `read {path, method}` and `write {path, method}`. A design on a stranger's road writes no word of its own, so
1273
+ the window hands it every word it needs, the home's, English: the surround's, the consent's `yesSay` and `noSay`, and
1274
+ a seat's `label` in the person's language. A window of your own asks of its designs what it chooses.
1275
+
1276
+ ### Building its look
1277
+
1278
+ The kit builds the look from the folder's files, as text or bytes; a design repo's `design` script runs it, and the
1279
+ repo lobe asks it as `npm run --silent design -- designs/<name> --look <file>`, reading the look's source from that
1280
+ file:
1281
+
1282
+ ```js
1283
+ // tools/design.mjs, the script "design": "node tools/design.mjs"
1284
+ import { readdirSync, readFileSync, writeFileSync } from 'node:fs';
1285
+ import { stripTypeScriptTypes } from 'node:module';
1286
+ import { join } from 'node:path';
1287
+ import { buildLook } from '@nervur.org/floor/design';
1288
+
1289
+ const [folder, flag, out] = process.argv.slice(2);
1290
+ const filesIn = (within = '') =>
1291
+ readdirSync(join(folder, within), { withFileTypes: true }).flatMap((entry) => {
1292
+ const path = within === '' ? entry.name : `${within}/${entry.name}`;
1293
+ return entry.isDirectory() ? filesIn(path) : [path];
1294
+ });
1295
+ // The kit takes each file as text or bytes: bytes here, so fonts and figures travel whole.
1296
+ const files = Object.fromEntries(filesIn().map((path) => [path, readFileSync(join(folder, path))]));
1297
+ const look = buildLook(files, (typescript) => stripTypeScriptTypes(typescript, { mode: 'strip' }));
1298
+ if ('why' in look) {
1299
+ console.error(look.why);
1300
+ process.exit(1);
1301
+ }
1302
+ if (flag === '--look') writeFileSync(out, look.source);
1303
+ else writeFileSync(join(folder, 'versions.json'), look.versions);
1304
+ ```
1305
+
1306
+ `buildLook(files, strip)` answers `{name, version, label, text, source, versions, screen}`, or `{why}`: the look's name
1307
+ `<publisher>.<name>-look` (`com.acme.plain-look`), its library label `<name>.look` (`plain.look`), its source, and
1308
+ `screen`, whether it draws `surround`, `organism` and `lobe`, which the floor's window wears it by.
1309
+ `designAssets(files)` answers `{assets, digest}`. `versions` is the text of the design's `versions.json`, its version
1310
+ naming `data`, that digest, and `look`, the SHA-256 of the look's source; `npm run design -- designs/<name>` writes it,
1311
+ and the tag tells it. Then the repo lobe builds it and the library takes it:
1312
+
1313
+ ```sh
1314
+ nervur lobe "$repo" build '{"design":"plain","version":"0.1.0"}'
1315
+ nervur lobe library add '{"road":"'"$repo"'","kind":"faculty","label":"plain.look","version":"0.1.0"}'
1316
+ ```
1317
+
1318
+ The kit puts `draw {component, args, theme, state?, lang?}`, `files`, `set {tint?, density?}` and `design` into every
1319
+ look; no author writes them. The kit takes each file as text or bytes, so `fonts/`, `icons/` and `figures/` travel as
1320
+ assets by digest, which a component names by digest (A figure in a component).
1321
+
1322
+ ### How a design is worn
1323
+
1324
+ Wearing is wiring. The window wears the design lobe wired to its `design`, the one its port gave at birth until
1325
+ the person chooses another, by the window's `wear {design}` naming a look's digest; it creates every design lobe sealed,
1326
+ so a design, a stranger's above all, draws and reaches nothing of the organism. Before it wears one it judges the
1327
+ look's sheets: one that `@import`s, or whose `url()` names an address that is no `data:` URI, no fragment and no file of
1328
+ the design, is refused, saying the sheet and the address. Whatever design it wears, the floor's window keeps every
1329
+ warning and confirm in the home's own words, and lays its way out above every page.
1330
+
1331
+ **What the host lays outside every tree.** Two roots stand above the page, each a shadow root under a host of its own
1332
+ beside `body`. Each wears what the window's own surround wears of the design the home wears, its tokens and fonts, its
1333
+ `lobes` sheets, then its `home` sheets, and no sheet of a place:
1334
+
1335
+ | Host | What stands in its root |
1336
+ | ---------------- | --------------------------------------------------------------------- |
1337
+ | `nervur-way-out` | the way out, a `button` holding `svg` |
1338
+ | `nervur-said` | what the home answered of a press it refused: a `p` of `role="alert"` |
1339
+
1340
+ They hold standard elements and no class. The floor's design dresses them by its `lobes` sheet, whose rules name each
1341
+ element under `:host`, here the host itself. A design whose sheets style classes alone leaves them as the device draws
1342
+ them, legible and bare: it dresses `:host button` and the rest in a `lobes` sheet, or names the two hosts in a `home`
1343
+ sheet. The home places each host on the screen by the host's own style, which no sheet moves.
1344
+
1345
+ ### What a tree may hold
1346
+
1347
+ A tree is data: no script, handler, style or address can be written in it. The allowlist, `ATTRIBUTES` of the
1348
+ kit, names:
1349
+
1350
+ - **Plain elements**:
1351
+ `div span p h1 h2 h3 h4 header footer main nav aside section article ul dl dt dd strong em small mark s sub sup`,
1352
+ `abbr q blockquote br hr figure figcaption legend table caption thead tbody tfoot tr summary`.
1353
+ - **With attributes of their own**: `ol{start}`, `li{value}`, `img{src, alt, width, height}` (a picture by its digest),
1354
+ `audio{src, controls}`, `time{datetime, deadline, shows}`, `data{value, ref, field}`, `a{href}`, `pre`, `code`,
1355
+ `meter{value min max low high}`, `progress{value max}`, `button{disabled copies}`, `label{for}`,
1356
+ `input{type name autocomplete value placeholder min max step maxlength minlength checked disabled required readonly
1357
+ enter}`, `textarea{name autocomplete placeholder rows maxlength minlength disabled required readonly}`, both with
1358
+ the typing hints `autocorrect` (`on off`), `autocapitalize` (`off none on sentences words characters`),
1359
+ `spellcheck` (`true false`), `inputmode` (`none text decimal numeric tel search email url`) and `enterkeyhint`
1360
+ (`enter done go next previous search send`), `select{name disabled}`, `option{value selected}`, `fieldset{disabled}`,
1361
+ `th{scope colspan}`, `td{colspan}`, `details{open}`, `slot{placeholder}`, and a subset of SVG. There is no `form`
1362
+ element: a `fieldset` is a form, and a press sends the named fields of the nearest one it stands in, or, standing in
1363
+ none, those of its root that stand in none.
1364
+ - **Global attributes**: `class id title lang dir hidden role aria-label aria-hidden aria-current aria-live aria-busy`,
1365
+ `aria-pressed` (`true false mixed`), `aria-expanded` and `aria-invalid` (`true false`), `aria-describedby` (an id),
1366
+ the gestures `swipe-left swipe-right swipe-up swipe-down hold drag drop`, `morph` and `opens`.
1367
+ `opens`, a flag, marks the element a page opens at: a page drawn whole, and the first draw of a place walked to, is
1368
+ brought into view at the first element that carries it once its design has laid it out, its sheets and its faces
1369
+ read, and again as they land, until the person scrolls, presses or types; any other patch never moves
1370
+ the page, so a person's own scrolling stays theirs. With no element marked, the page opens where the engine opens it.
1371
+ - **Inputs**: `text search number range checkbox radio date time email tel color file`.
1372
+
1373
+ **A press** stands on a `button`, `input`, `select`, `textarea` or `summary`: `press: {method, args, to?}` asks the lobe
1374
+ that drew it, or the lobe its placeholder `to` reaches. Typed text leaves only as the fields the pressed method's args
1375
+ name. `{method: 'local', args: {region, state, field?}}` changes only the region's local state on the device.
1376
+ From the moment a press is sent until the home answers it, the screen marks its control `aria-busy="true"`, over
1377
+ whatever your tree says, and ignores further presses of that control; every other control stays live. Style
1378
+ `[aria-busy='true']` in your sheets to show a press on its way; the floor's design dims it.
1379
+ A `slot`, `{t: 'slot', a: {placeholder}, args, k, c: []}`, draws there the lobe that placeholder is wired to, with those
1380
+ args.
1381
+
1382
+ - **The return key**: an input's `enter` names by id a `button` with a press in the same tree, which the person sees;
1383
+ the return key in that field makes that button's press, its fields gathered as a click gathers them.
1384
+ - **A copy**: a button's `copies` names by id an element of the same tree the person sees; pressed, the screen puts
1385
+ that element's text, or a field's value, on the device's clipboard, and the lobe hears nothing. Copy only what is
1386
+ shown: a text kept beside it is never copied.
1387
+ - **A link of the world** (`https:`, `mailto:`) never navigates the screen: the home says where it leads in its own
1388
+ words above the page and opens it outside only on the person's yes there. Those words are English; a window of your
1389
+ own words them in another language by answering `world {say, yes, no}` in every `see`: `say` holds
1390
+ `{href}` where the screen puts the address, and `yes` and `no` are the two buttons. The person must read where the
1391
+ link leads, so words whose `say` lacks `{href}`, or that are not three non-empty texts, are not taken and the English
1392
+ stands; the words of one sight stand until a sight hands others or none.
1393
+
1394
+ - **A file** a person gives: a `file` input whose name the method's args declare reaches the lobe as
1395
+ `{name, type, size, sha256}`, never its bytes; the method's seat says `intent: "channel"`, a free field of the seat
1396
+ the floor's window reads, and answers `{channel: {kind: "upload", url, expires}}`, the host PUTs the bytes there once
1397
+ and the window asks the lobe `landed {sha256, landed}`. A file the other way:
1398
+ `{channel: {kind: "file", size, sha256, ext, url, expires}}`, `ext` a picture's or a sound's kind; with no `url` and
1399
+ `expires`, the bytes are a lobe of the home's own, which answers its reading method `piece {sha256, at, length}` with
1400
+ them.
1401
+ - **A deadline**: `{t: 'time', a: {datetime: '…', deadline: '2026-01-01T10:00Z'}}` is counted down by the screen; the
1402
+ lobe hears nothing, and judges lateness by its stamp.
1403
+ - **An instant**: `{t: 'time', a: {datetime: '2026-01-01T10:00Z'}, c: []}`, with no text and no deadline, is written by
1404
+ the screen in the person's language and the device's zone, its day and its time of day; `shows: 'day'` or
1405
+ `shows: 'time'` writes one alone. No lobe knows the zone a person reads in.
1406
+ - **Caps**: a tree holds at most 5,000 nodes, 64 deep, a key of 200 and a text of 20,000, and no sound, each an owner's
1407
+ word over `tree.*`.
1408
+
1409
+ ## A window of your own
1410
+
1411
+ The screen's present lobe, the **window**, is a faculty like any other: it keeps the route the person walked, answers
1412
+ what the screen shows there, and carries each press. The floor's is `nervur.window`; its source is `WINDOW_SOURCE` of
1413
+ `@nervur.org/floor`, one module importing `nervur:faculty` alone, to read or to start from. A host names the window an
1414
+ organism is born wearing (Where Nervur stops); this section is all it asks of one. What the floor's window answers
1415
+ below is one way to answer it; what any window must answer is said so.
1416
+
1417
+ ### Its wiring
1418
+
1419
+ A window declares the placeholders `screen`, expecting `nervur.screen`, and `brain`, expecting `nervur.brain`, and
1420
+ where it wants them `design` (expecting any blueprint, a look's), `mouth` (`nervur.mouth`) and `ear` (`nervur.ear`),
1421
+ which the port wires to the organism's own. **Presence wins:** the screen's organ, `this.stamp.asker` `screen`, is
1422
+ the one asker whose walks, sights and presses are the person's, so a window answers it alone for each and refuses
1423
+ every other asker; nothing but its organ speaks through it. It holds the relations its owners hold, each wired by the
1424
+ brain under the placeholder the console holds it by: a relation is a placeholder of its own nerves
1425
+ (`this.nerves.read()`), never one of its own (`screen`, `brain`, `design`, `mouth`, `ear`). `design` is the one wire
1426
+ of a present lobe that only the window moves, by `this.nerves.order({termination, placeholder: 'design'})`; the port
1427
+ wires it at birth, and at each connect the brain asks `back {placeholder: 'screen'}`, where the floor's window lays
1428
+ the design its port gave unless the person chose another. At `left {far, note}` it forgets all it kept of that
1429
+ relation.
1430
+
1431
+ ### Routes and the walk
1432
+
1433
+ A route is the path the person walked: `[]` the home, `[{relation}]` an organism or a far lobe seen through a relation
1434
+ the window holds, `[{lobe}]` a lobe at home, `[{relation}, {lobe}]` a lobe of that organism. Its text is `/`, `/org`,
1435
+ `/~/A24`, `/org/A24`, a lobe's ID percent-encoded; `routeText(route)` and `routeOf(text)` of
1436
+ `@nervur.org/genome/screen` write and read it, each answering `{why}` for what is none.
1437
+
1438
+ - **`open {route}`** or **`open {lobe}`**, with `told?`: the walk; answers `{route, text}`. The floor's way out walks
1439
+ home by `open {route: []}`. **`root {}`** answers the route walked.
1440
+ - **A relation is a place** where its knock's describe names another blueprint than `nervur.brain`: a far lobe,
1441
+ `/<relation>` its page, nothing under it. The floor's window describes a far lobe once at a walk and keeps the
1442
+ describe and what its `state` answered, so a sight asks no describe and each press is one ask over the kept
1443
+ describe; it asks the far lobe over the relation itself, as its own methods, and a far organism through its brain.
1444
+ - **`told {size, language, standard}`** is what the host tells a place of its screen, `size` one of `compact`,
1445
+ `medium`, `expanded`: at a walk a window asks a far lobe that declares a writing method `told` those three and
1446
+ nothing else, the first time and again only where one moved; the host lays the same under `told` in the args of every
1447
+ draw it asks over a relation (`withTold`).
1448
+
1449
+ ### What `see` answers
1450
+
1451
+ **`see {route?, args?}`**, `args` closed: `{cursor?, cells?, theme?, lang?}`, the place in a long list, the cells
1452
+ digest the screen holds of the lobe, `light` or `dark`, and the person's language tag. It answers
1453
+ `{route, text, tree, main, version, design, way?, world?, channel?}`:
1454
+
1455
+ - `tree`: the root the screen draws. The floor's is `surround {title, route, back?, warnings, main, consent?}` drawn
1456
+ by its design only where the window has something to say, a warning or a consent; else the slot alone,
1457
+ `{t: 'main', a: {}, c: [{t: 'slot', a: {placeholder: 'main'}, args, c: []}]}`.
1458
+ - `main`: `{lobe, over, args}`, the lobe that draws the slot `main`, over which relation (null at home), with which
1459
+ args. The host draws it by **`show {lobe, args, over?}`**, which answers `{tree, wires}`: the lobe's `draw` through
1460
+ the brain's `ask`, or over the relation, and the lobe wired at each of its placeholders, where the screen draws its
1461
+ slots by `show` again. For a page the floor's window draws from a describe, `lobe` is its design lobe and `args`
1462
+ `{component, args, theme, lang}`; for a lobe that declares `draw`, that lobe, its relation and `{}`.
1463
+ - `version`: the version the lobe's describe says, null for an organism, which a press that writes carries back as
1464
+ `seen`.
1465
+ - `design`: the lobe wired at the window's `design`, the design it wears, or null for none. The host dresses the home
1466
+ by this lobe whatever drew the page, and draws a window that names none with no design's sheet.
1467
+ - `way`: `{at, say?, leave?}`, what the window hands the host to lay above the page, outside every tree, where no
1468
+ place's tree or sheet covers or presses it, `at` one of `top-start`, `top-end`, `bottom-start` and `bottom-end`. The
1469
+ floor's window hands its way out and a place's leave there (The floor's leave and way out); a window of your own
1470
+ hands what it chooses, or none.
1471
+ - `world`: `{say, yes, no}`, the words of the ask before a link of the world opens (What a tree may hold); the floor's
1472
+ window hands none.
1473
+ - `channel`: the checked shape of a file or an upload the last press of the place answered, for the host to follow,
1474
+ until it posts **`landed {id, landed, why?}`**; a file whose bytes a lobe of the home holds is read by
1475
+ **`piece {id, at}`**.
1476
+
1477
+ A host's own press `page {cursor}`, which the floor's design lays to turn a long list, asks `see` again with that
1478
+ cursor and reaches no window method. The floor's window asks the design it wears `surround`, `organism` and `lobe` alone
1479
+ (Designs and looks).
1480
+
1481
+ ### Presses
1482
+
1483
+ A press in a tree is `{method, args, to?}` on its element. The host gives each press a number and carries it as
1484
+ `postsOf(press, {id, seen, cells, values})` of `@nervur.org/genome/screen` says, `values` the fields committed
1485
+ around it: posts answered one before the next, each an ask of the window.
1486
+
1487
+ - **`read {path, method}`**: one post, `read {path, method, cells, values?}`, `path` the route's text of the lobe; the
1488
+ answer or error is kept under the lobe, the method and `cells`, and drawn by every sight until the cells move.
1489
+ - **`write {path, method}`**: three posts. `write {id, path, method, values, seen, declared?, consented?}` keeps the
1490
+ press before anything leaves and answers `{id}`; `send {id}` marks it sent, committed before any ask of the lobe
1491
+ leaves, and answers `{method, sending: true}` once, `{method, unknown: true}` for a press sent and not answered,
1492
+ which is never sent again, what was kept for one answered, `{method, asking: true}` for one held for the
1493
+ consent, or `{method, taken: true}` for a yes whose consent another yes took, which asks nothing; `deliver {id}`,
1494
+ posted only after `sending`, describes the lobe, answers `stale` with the version that stands where it is no longer
1495
+ `seen`, fits the values to the method's `args` and asks the lobe once, answering
1496
+ `{method, answer}` or `{method, error}`. Fitting leaves out an empty text in a property not required, parses a
1497
+ number or an integer, takes a boolean from its checkbox, parses JSON and keeps an enum; a value that fits not is
1498
+ refused in plain words and the lobe is not asked.
1499
+ - **`ask {path, method, args?, consented?}`**: the declared ask, the same three posts with the args the press names
1500
+ as its values, `declared: true`.
1501
+ - **`local {region, state, field?}`**: one post; it merges `state` into the region's local state at the route
1502
+ walked, a null dropping a key, bounded by the window's memory and forgotten at the next walk; no lobe hears it, and
1503
+ a component is handed it as `state`. `field` names the key that holds what a person types, posted at each key.
1504
+ - **Any other press** is `press {lobe, method, args, values?, to?, over?}`, `lobe` the lobe it reaches: the window
1505
+ reads the describe first, holds it for the consent where it binds the person, and asks the lobe that drew it, or the
1506
+ one wired at its `to`, with of `values` those its method's args name. Where `lobe` is the window's own design lobe,
1507
+ the press is the window's own act; the floor's are `create {faculty}`, `about {faculty}` and `leave {relation}`.
1508
+
1509
+ **Whose a press is.** A region a lobe's root draws is that lobe's; a region a sealed lobe draws is drawn for the lobe
1510
+ whose slot asked it, and a press there reaches that lobe (`pressAt`). Every design lobe is sealed, so a press in what
1511
+ a design draws reaches the window, never the design.
1512
+
1513
+ **The fleeting stays on the device.** Typing, scrolling and focus reach no lobe. Typed text leaves only as the fields
1514
+ the pressed method's args name, from the nearest `fieldset` the press stands in, else from its root's fields that
1515
+ stand in none; a field a `local` press names stays in the region's local state.
1516
+
1517
+ ### The consent
1518
+
1519
+ The floor's window holds a press for its consent where the method's describe declares `irreversible`, or where it is
1520
+ an ask a place's describe names and says nothing of (no `kind`); so is its leave. Held, it asks the lobe nothing: the
1521
+ window sets the local state of the region `#consent` of the route, `{asking, lobe, args, label?, irreversible?}`,
1522
+ `args` the values fitted, and answers `{method, asking: true}`; the surround is then drawn with
1523
+ `consent {say, yes, no, yesSay, noSay}`, in the home's words. `yes` is the same ask,
1524
+ `{method: 'ask', args: {path, method, args, consented: true}}`; `no` the `local` press that clears the region, every
1525
+ value null. A consent holds only while the window's own local state still asks for that
1526
+ method of that lobe. The first yes sent takes it, `taken` naming its press in the region's state, and the consent stays
1527
+ drawn until that ask is answered, then is spent: a second yes meanwhile, from another tab, asks nothing, and a yes
1528
+ after asks the consent anew. A `local` press may clear `#consent` and never set it, so no tree a
1529
+ place draws forges a yes, and `deliver` refuses a press that binds the person with none. No method of a place is named
1530
+ `#consent`. A window of your own holds back what it chooses; the local state of a region is yours to keep the same
1531
+ way, which no tree of a place sets.
1532
+
1533
+ ### The floor's leave and way out
1534
+
1535
+ `way.leave` is `{press: {method: 'leave', args: {relation}}, say}` at a place the window took, a far lobe, `say` the
1536
+ home's word; the host lays it beside the way out and carries it as a press of the design lobe over no relation, while
1537
+ the window's `way` still holds it. Unconsented, `leave {relation}` sets `#consent` with `asking: 'leave'` and answers
1538
+ `{asking: 'leave'}`, the surround carrying a consent whose `yes` is the same press with `consented: true`; consented, it
1539
+ ends the standing whole by the brain's `drop {far}`, forgets what it kept of the place, walks the person home where the
1540
+ route stood on it, and answers `{left: relation}`. A relation that reaches a far organism is an owner's standing,
1541
+ never left so. A place whose far lobe answers `removed`, and a knock never answered, end the same way.
1542
+
1543
+ The floor's way out stands at `bottom-end` above every page but the home's own, `way.say` its word, and walks home.
1544
+
1545
+ ### Links
1546
+
1547
+ The host reads a link into `{card, reference}` and draws the consent itself, outside every tree; the window gives it
1548
+ three asks, each the screen's alone:
1549
+
1550
+ - **`offer {card, reference}`**: the mouth's `once` asks `#offer` of the card's ward on its zero head, spending
1551
+ nothing; answers `{says, waits, lives}`, `{reached: false}`, or null where the place gave no offer.
1552
+ - **`redeem {card, reference}`**: the same for `#redeem`; answers `{invitation}`, or `refused` in words that say
1553
+ whether to try again.
1554
+ - **`accept {invitation, placeholder, note?}`**, the person's yes: refused for one of the window's own placeholders
1555
+ and one it holds; the mouth accepts with `note`, kept beside the standing and never sent, and the first ask over it,
1556
+ a describe, is the knock, one never answered ending the standing whole by `drop` and refused. A knock naming another
1557
+ blueprint than `nervur.brain` makes the relation a far lobe. Answers `{far, route, text}`, where the host walks.
1558
+
1559
+ ### What the host lays
1560
+
1561
+ The host lays what a window answers, whatever window it is; these are its calls, of `@nervur.org/genome/screen`.
1562
+
1563
+ - **The design.** `worn {}` answers what the design lobe wired at `design` answers its `files`, asked again where the
1564
+ lobe a sight names as `design` moved; the host lays it by
1565
+ `laid(files, settings, access)`, which answers `{sheets, lobes, home, classes, access, fonts?, dropped}`: each sheet
1566
+ `{digest, text}`, served at `SHEET_PATH` (`/.nervur/skin/`) as `<digest>.css`, the digests a `lobes` root and the
1567
+ `home` root wear in order, the access sheet last in both, and the classes each may draw. A picture and a font are
1568
+ served at `ASSET_PATH` (`/.nervur/asset/`) as `<digest>.<ext>`, fonts under families named `f-<digest>`; the light
1569
+ tokens lie on `:root, :host`, the dark under `prefers-color-scheme: dark`, each again under `data-theme`, which wins.
1570
+ - **Who wears the home's chrome.** `dressOf(road)` answers `home` for a lobe whose faculty came by the genome's road,
1571
+ the installer's or the owners' own source, `lobes` for any other: a root wears the lobes' skin alone, or that and the
1572
+ home's chrome, so a stranger never dresses as the home. A class stands only where a sheet of the layer its root wears
1573
+ names it. A window hands `lang` only in the draws of the design it wears, the home's; a look drawn with none finds
1574
+ every word empty.
1575
+ - **The person's access.** Four tokens, `access-text-size` 0.75 to 3, `access-contrast` 0 to 1, `access-leading` 1 to
1576
+ 2.5 and `access-motion` 0 to 1, clamped by `clampAccess` and laid last in every root, `!important`, by
1577
+ `accessSheet`; a design's own token of an `--access-` name is dropped, and its sheets read them by `var()`.
1578
+ - **Motion** is data: a design's `--<design>-<kind>-duration` (in `ms` or `s`) and `--<design>-<kind>-easing` for
1579
+ `enter`, `leave`, `move` and `change`, read by `motionTokensOf(tokens, design)`, a token missing no motion; each patch
1580
+ tells its kinds by its diff, and `motionOf(ops, motion, accessMotion)` scales them by `access-motion`, 0 stilling
1581
+ all. `morph` flies a named node from where it stood to where a patch puts it.
1582
+ - **Gestures** are another hand on a drawn control, never a new press: `swipe-left`, `swipe-right`, `swipe-up`,
1583
+ `swipe-down` and `hold` each name by id a `button` or `summary` with a press, `drag` a `select` with a `name`, whose
1584
+ options an element's `drop` stands for; the first of that id within the element, not hidden from a person. A tree
1585
+ whose gesture names none is refused.
1586
+ - **Addresses.** A tree's `a{href}` names a path of the screen's own (on a browser's host, the site's), `#id` within
1587
+ the page, or a link of the world, `https:` with a host and no credentials or `mailto:`, opened only on the person's
1588
+ yes; nothing else reaches the screen.
1589
+ - **What the surface tells.** The device's theme and language, the width, which the host makes a size class, whether
1590
+ the person asks for no motion, which the host plays as none: the window hears them as `see`'s `theme` and `lang` and
1591
+ `open`'s `told`, and nothing else of the device.
1592
+
1593
+ ### A design for the floor's window
1594
+
1595
+ A design the floor's window wears draws `surround`, `organism` and `lobe` from their args alone. The plain design above
1596
+ becomes one with three components; `surround` lays the consent's presses as handed and the slot `main`:
1597
+
1598
+ ```ts
1599
+ // designs/plain/components/surround.ts
1600
+ export default (args) => ({
1601
+ t: 'div',
1602
+ a: {},
1603
+ c: [
1604
+ { t: 'h1', a: {}, c: [args.title] },
1605
+ ...args.warnings.map((line, at) => ({ t: 'p', a: { role: 'status' }, k: `w${at}`, c: [line] })),
1606
+ ...(args.consent === undefined
1607
+ ? []
1608
+ : [
1609
+ { t: 'p', a: {}, k: 'say', c: [args.consent.say] },
1610
+ { t: 'button', a: {}, k: 'yes', press: args.consent.yes, c: [args.consent.yesSay] },
1611
+ { t: 'button', a: {}, k: 'no', press: args.consent.no, c: [args.consent.noSay] },
1612
+ ]),
1613
+ { t: 'main', a: {}, k: 'main', c: [{ t: 'slot', a: { placeholder: 'main' }, args: args.main, c: [] }] },
1614
+ ],
1615
+ });
1616
+ ```
1617
+
1618
+ `organism.ts` and `lobe.ts` draw theirs the same way, a link an `a{href}` to a `path`, a press laid as handed, a
1619
+ writing method a `fieldset` with a field named after each arg and a button pressing `write {path, method}`. The
1620
+ floor's own design is the whole example: `FLOOR_FILES` of `@nervur.org/floor` holds its data by path and
1621
+ `FLOOR_LOOK_SOURCE` its look, every component built in.
1622
+
1623
+ ## The browser and the web
1624
+
1625
+ ### A site that serves the browser port
1626
+
1627
+ A site serves the port as plain files, with no step of Nervur's. Lay the package's `dist/` at any path of the
1628
+ site's origin, here `/nervur`: `/nervur/<digest>/*` served `Cache-Control: public, max-age=31536000, immutable`, the
1629
+ loader `/nervur/page.js` revalidated, and `/nervur/keeper.js` with the header `Service-Worker-Allowed: /`.
1630
+ `dist/quo.json` names the loader's digest, to pin it. A page then holds the organism:
1631
+
1632
+ ```html
1633
+ <div data-quo-link></div>
1634
+ <div data-quo-screen></div>
1635
+ <script type="module" src="/nervur/page.js"></script>
1636
+ ```
1637
+
1638
+ With no more, the visitor's organism installs and boots in a worker, and the screen is born in the floor. Every tab of
1639
+ the site shares that one organism, and closing any tab disturbs no other: each keeps its pages, and only an ask left
1640
+ unanswered by the tab that closed ends as `unavailable`, since whether it was done is not known. The element's words:
1641
+
1642
+ | Attribute | What it draws |
1643
+ | ----------------- | ------------------------------------------------ |
1644
+ | `data-quo-screen` | the person's screen: the organism and its places |
1645
+ | `data-quo-link` | where a link landing on this page is taken |
1646
+
1647
+ The element says back `data-quo`: `waking`, `drawn`, `none` or `failed`, with `data-quo-why` in words. Its own content
1648
+ stands until the first tree replaces it, so a loader and an empty state are the site's markup. The page module exports
1649
+ `standings()` (`{relation, domain, note}` each), `ask(standing, method, args?)`, which answers what the lobe answered,
1650
+ or `{error}`, `watch(standing, method, args, heard)`, which calls `heard` with the answer now and with each one that
1651
+ differs, asked again at each notice the organism gives the page that a lobe of it committed, and answers the function
1652
+ that stops it, `timings()`, `wake(key)` and `lay`, `arrive`, `stay`, `lasting` and `wipe`: the organism is the site's
1653
+ backend in the tab, and the site's own pages draw what it answers in their own markup. `wipe()` removes the organism
1654
+ from this browser for ever, its store, its way back and its key, where it runs in no tab: null, or `{why}`. It is the
1655
+ one way out of a store no version the site serves boots, and of a design chosen that draws nothing.
1656
+
1657
+ **A window of the site's own.** A site names the window its visitors' organisms wear in its `/.well-known/quo`,
1658
+ `"organism": {"window": {"name": "com.acme.window", "version": "1.0.0", "text": "<sha256>"}}`, `text` the SHA-256 in
1659
+ hex of the faculty's source, which it serves beside the loader, at `/nervur/window/faculty.js`. Every boot reads what
1660
+ the site names then: the source checked against `text` and read as a faculty declaring a placeholder `screen` and one
1661
+ `brain`, as the floor's window does, it stands as the screen's present lobe on the road `com.acme.window@1.0.0`, its
1662
+ `mouth` and `ear` wired to the organism's own where it declares them, given the site's design, else the floor's. A
1663
+ deploy that names another moves each visitor's organism to it at its next boot, unless its person moved their window
1664
+ by `version`, which stands. A window that fails is refused whole: the organism wears the floor's, and the refusal is
1665
+ said among the warnings it boots with. A site that names none wears the floor's window, and nothing is said. Write it
1666
+ as any faculty, the floor's `WINDOW_SOURCE` of `@nervur.org/floor` being one to start from.
1667
+
1668
+ **The port's note.** Where the browser declines to persist the store, the port says so in the screen's element, in a
1669
+ `p[data-quo-note="store"]` beside the caged tree, which the site's own sheet styles. It is said in the home's words,
1670
+ which are English, once, and the port never writes it again: a site in another language words it itself, hiding it with
1671
+ its sheet and saying its own where it appears, or replacing its text as it is laid:
1672
+
1673
+ ```js
1674
+ const screen = document.querySelector('[data-quo-screen]');
1675
+ new MutationObserver(() => {
1676
+ const note = screen.querySelector('p[data-quo-note="store"]');
1677
+ if (note !== null && note.lang !== document.documentElement.lang) {
1678
+ note.textContent = 'Dieser Browser kann löschen, was dein Organismus hält …';
1679
+ note.lang = document.documentElement.lang;
1680
+ }
1681
+ }).observe(screen, { childList: true, subtree: true });
1682
+ ```
1683
+
1684
+ An app that says it in a place of its own reads whether the browser keeps the store from the organism's `state`, the
1685
+ vitals' `disk.persisted`.
1686
+
1687
+ **The page's consent.** A link's consent is drawn by the page itself, outside every tree, under a head that names the
1688
+ home, in the home's words and dressed by the home's layer, legible with no sheet. It says what the link's offer says,
1689
+ as the place's own word, how long the invitation waits and how long its relation lives, and draws no field: the yes
1690
+ keeps the domain that vouched in the standing's note, and a note you want kept beside the standing is one your own
1691
+ landing gives the window's `accept` at the yes (Where Nervur stops).
1692
+
1693
+ **A page author never** styles inside the `nervur-lobe` element the screen stands in, never forbids `blob:` styles or
1694
+ fonts or a worker of its own origin in its content security policy, and serves no script it does not trust: whoever
1695
+ serves the origin's code reaches what the origin keeps, the boot key among it.
1696
+
1697
+ ### `/.well-known/quo` and links
1698
+
1699
+ A site's vouch is plain JSON it writes by hand, served `Access-Control-Allow-Origin: *`:
1700
+ `{wards, cards, links?, size?, organism?}`. `wards` are the wards the domain names its own, `cards` each `{ward, at}`,
1701
+ the first the one a link on the domain names; `links` is the path where a link lands; `organism` names the installer's
1702
+ version and digest, the design the visitor's organism is born in, `design: {name, version, data, look, tint}`, and the
1703
+ window it wears, `window: {name, version, text}` (A site that serves the browser port). `size` is the class of the
1704
+ screen's size, `compact`, `medium` or `expanded`, where the host names one: every draw, and everything a place is told
1705
+ of the screen, then carries that class whatever the width, and a change of width moves nothing. With none named, or
1706
+ anything else, the class is the width's. A phone's app names it in its `quo.json`, a desktop's install in the file its
1707
+ `--design` hands.
1708
+
1709
+ A link carries a card and a reference, never the invitation. On a domain it is
1710
+ `https://<domain><path>#<reference>`, `/quo` the path where the vouch names none, the reference twenty-six lowercase
1711
+ base32. Elsewhere it is `web+quo:<reference>@<ward>?at=<address>`. A lobe draws one by the ear's `invite` with
1712
+ `refer: true`, and `public: true` for a link on a domain; whoever is handed it redeems the reference once on the zero
1713
+ head by `#redeem`, and accepts at its owner's word. On the site's page, the landing in `data-quo-link` reads the
1714
+ link's offer, draws the consent, and on a yes redeems, accepts and draws what the window's `accept` answers; a no keeps
1715
+ nothing, and either way the link is taken out of the address. The landing takes a link whole after
1716
+ the `#` too, `web+quo:` or one on any domain, as a camera or a paste hands it, at the page's load or while it stands
1717
+ open, its fragment changed, at once, with no load. A desktop's screen takes a link the same way, whole after
1718
+ the `#` of its own address, `http://127.0.0.1:<port>/#<link>`, and draws the same consent above the page in the home's
1719
+ words; a bare reference is no link there, since that page stands on no site's domain. A link pressed on a
1720
+ desktop, on a page of the web or in a message, reaches that screen by the handler an install lays for `web+quo:`, which
1721
+ runs `nervur open <link>`: it opens the screen at the link in the person's own browser, where the consent is asked, and
1722
+ where no screen answers it opens a page saying so, and nothing is accepted. `nervur accept <link>`, typed at the
1723
+ console, takes the link by the same steps and is its owner's own word and asks nothing.
1724
+
1725
+ **One ask from a script.** A build that reads a place as a stranger asks its front once on the zero head by `askOnce`
1726
+ of `@nervur.org/genome/quo`, as the mouth's `once` asks: `askOnce(card, method, args, {carry, draw, crypto?})`
1727
+ answers what the being answered, `{result}` or `{error}`, `silent` for silence and `unavailable` where no address
1728
+ carried the ask. The genome reaches no host, so the script hands the carrier, a box to a ward at an address
1729
+ answered `{reply}` (the reply's bytes, or null for nothing) or `{why}`, and the chance; the box goes to the card's
1730
+ addresses in turn until one replies. Over `ws` and `wss`, one frame body a message (Quo's frame, `frameOf` and
1731
+ `readBody`):
1732
+
1733
+ ```js
1734
+ import { askOnce, cardOfVouch, frameOf, readBody } from '@nervur.org/genome/quo';
1735
+ import { unhex } from '@nervur.org/genome/standard';
1736
+
1737
+ const carry = (address, ward, box) =>
1738
+ new Promise((done) => {
1739
+ if (!/^wss?:/.test(address)) return done({ why: 'this script carries ws and wss alone' });
1740
+ const socket = Object.assign(new WebSocket(address, 'quo'), { binaryType: 'arraybuffer' });
1741
+ const end = (answer) => (clearTimeout(timer), socket.close(), done(answer));
1742
+ const timer = setTimeout(() => end({ why: 'no reply within a minute' }), 60_000);
1743
+ socket.onopen = () => socket.send(frameOf({ kind: 'ask', id: 1, ward: unhex(ward).bytes, box }).subarray(4));
1744
+ socket.onmessage = ({ data }) => {
1745
+ const frame = readBody(new Uint8Array(data));
1746
+ if (frame?.id === 1 && frame.kind !== 'ask') end({ reply: frame.kind === 'reply' ? frame.box : null });
1747
+ };
1748
+ socket.onerror = () => end({ why: 'the line did not open' });
1749
+ });
1750
+ const card = cardOfVouch('example.com', await (await fetch('https://example.com/.well-known/quo')).text());
1751
+ const draw = (length) => crypto.getRandomValues(new Uint8Array(length));
1752
+ const answer = await askOnce(card, 'spec', {}, { carry, draw });
1753
+ ```
1754
+
1755
+ ### A faculty in a site, whole
1756
+
1757
+ A guestbook at `example.com`: each visitor's organism, in its tab, holds a standing on a lobe of the site's server, and
1758
+ signs over it. Four pieces tie together by one card, the server organism's public ward and its addresses.
1759
+
1760
+ **1. The server**, reached by browsers over `wss` alone, behind a TLS proxy of the machine forwarding
1761
+ `https://example.com/quo` to `ws://127.0.0.1:9112/quo`:
1762
+
1763
+ ```sh
1764
+ nervur install --public example.com --ws wss://example.com/quo
1765
+ nervur card --json # {"result":{"ward":"<ward>","at":["tcp://example.com:9110","wss://example.com/quo"]}}
1766
+ ```
1767
+
1768
+ **2. The faculty** draws a link for one visitor by the ear, and answers each visitor over the relation the link
1769
+ becomes, by `this.stamp.occupant`:
1770
+
1771
+ ```js
1772
+ import { Faculty } from 'nervur:faculty';
1773
+
1774
+ export default class Guestbook extends Faculty {
1775
+ static blueprint = {
1776
+ name: 'com.example.guestbook',
1777
+ version: '0.1.0',
1778
+ methods: {
1779
+ link: { kind: 'reading', description: 'A one-time link for a visitor: its reference.' },
1780
+ sign: {
1781
+ kind: 'writing',
1782
+ args: {
1783
+ type: 'object',
1784
+ properties: { text: { type: 'string', minLength: 1, maxLength: 200 } },
1785
+ required: ['text'],
1786
+ additionalProperties: false,
1787
+ },
1788
+ },
1789
+ entries: { kind: 'reading', description: 'The fifty oldest entries, each its text.' },
1790
+ draw: { kind: 'reading' },
1791
+ },
1792
+ placeholders: { ear: 'nervur.ear' },
1793
+ };
1794
+
1795
+ async link() {
1796
+ const args = { waits: 604_800_000, lives: null, refer: true, public: true, note: { role: 'guest' } };
1797
+ const drawn = await this.ask('ear', 'invite', args);
1798
+ return 'result' in drawn
1799
+ ? { reference: drawn.result.link.reference }
1800
+ : this.error(drawn.error.code, drawn.error.message);
1801
+ }
1802
+
1803
+ sign(args) {
1804
+ const refused = this.checked('sign', args);
1805
+ if (refused !== undefined) return refused;
1806
+ if (this.stamp.occupant === null) return this.error('refused', 'a guest signs over the link it took');
1807
+ this.cells.set(['entry', this.stamp.time, this.stamp.occupant.far], args.text);
1808
+ return null;
1809
+ }
1810
+
1811
+ entries() {
1812
+ return this.cells.range({ prefix: ['entry'], limit: 50 }).cells.map(({ value }) => value);
1813
+ }
1814
+
1815
+ draw() {
1816
+ const rows = this.cells.range({ prefix: ['entry'], limit: 50 }).cells.map(({ key, value }) => ({
1817
+ t: 'li',
1818
+ a: {},
1819
+ k: `${key[1]}-${key[2]}`,
1820
+ c: [value],
1821
+ }));
1822
+ return {
1823
+ t: 'main',
1824
+ a: {},
1825
+ c: [
1826
+ { t: 'ul', a: {}, c: rows },
1827
+ { t: 'textarea', a: { name: 'text', placeholder: 'Say hello' }, c: [] },
1828
+ { t: 'button', a: {}, press: { method: 'sign', args: {} }, c: ['Sign'] },
1829
+ ],
1830
+ };
1831
+ }
1832
+ }
1833
+ ```
1834
+
1835
+ Created wired to the ear, `create {faculty, wiring: {"ear": "ear"}}`, it draws one link a visitor:
1836
+ `nervur lobe <ID> link --json` answers `{"result":{"reference":"<26 base32>"}}`, so the site's own server, on the same
1837
+ machine, asks it at each visitor's press and hands `https://example.com/quo#<reference>`. A link is redeemed once.
1838
+
1839
+ **3. The vouch**, `https://example.com/.well-known/quo`, served `Access-Control-Allow-Origin: *`, names the card of
1840
+ step 1 as the domain's own; the visitor's worker takes a link only for a ward the vouch names:
1841
+
1842
+ ```json
1843
+ {
1844
+ "wards": ["<ward>"],
1845
+ "cards": [{ "ward": "<ward>", "at": ["wss://example.com/quo"] }],
1846
+ "links": "/quo"
1847
+ }
1848
+ ```
1849
+
1850
+ **4. The pages**, beside the browser port at `/nervur` (A site that serves the browser port). `/quo`, where a link
1851
+ lands, holds `<div data-quo-link></div>` and loads `/nervur/page.js`: it draws the consent, and on a yes the visitor's
1852
+ organism redeems the reference on the public ward's zero head and accepts the invitation. `/guestbook` reads the
1853
+ standing the domain gave through the page module and draws the entries in its own markup, each signing asked over that
1854
+ standing:
1855
+
1856
+ ```html
1857
+ <ul id="entries"></ul>
1858
+ <textarea id="text"></textarea>
1859
+ <button id="sign">Sign</button>
1860
+ <script type="module">
1861
+ import { ask, standings } from '/nervur/page.js';
1862
+
1863
+ const standing = (await standings()).find((one) => one.domain === 'example.com');
1864
+ const list = document.getElementById('entries');
1865
+ const show = async () => {
1866
+ const heard = await ask(standing, 'entries');
1867
+ if (!Array.isArray(heard)) return;
1868
+ list.replaceChildren(...heard.map((text) => Object.assign(document.createElement('li'), { textContent: text })));
1869
+ };
1870
+ if (standing !== undefined) {
1871
+ await show();
1872
+ document.getElementById('sign').onclick = async () => {
1873
+ await ask(standing, 'sign', { text: document.getElementById('text').value });
1874
+ await show();
1875
+ };
1876
+ }
1877
+ </script>
1878
+ ```
1879
+
1880
+ The same standing is a place on the visitor's screen too, where the guestbook's own `draw` draws it.
1881
+
1882
+ ### Push
1883
+
1884
+ A closed browser is woken by Web Push: on a person's press, the page's `wake(key)` subscribes under the key
1885
+ your sender signs with and answers `{endpoint, keys}` to the page's own code. Keeping subscriptions and sending to them
1886
+ is a faculty's, over `network`, since a push is a web request. A push says only that something waits: the keeper reads
1887
+ none of it and shows one notice in the words `{title, body}` the site serves at `waits.json` beside the keeper. A phone
1888
+ is woken by APNs or FCM, to the token its page's `wake()` answers; sending is your own code, with your keys at Apple and
1889
+ Google, as for the web.
1890
+
1891
+ ### The web from a lobe
1892
+
1893
+ A skin lobe of `network` reaches the web outside Quo. Bodies are bytes, in pieces of at most a mebibyte:
1894
+
1895
+ ```js
1896
+ // A request: answered by its response, or by {request} to take it piece by piece.
1897
+ const sent = yield { placeholder: 'network', method: 'send', args: { method: 'GET', url: 'https://example.com/', headers: {}, body: new Uint8Array(0) } };
1898
+ // sent.result: {status, headers, body, more} or {request}; then take {request, piece} from 0, or send {request, body, more} for an upload.
1899
+
1900
+ // A path served: network asks this lobe back for each request.
1901
+ yield { placeholder: 'network', method: 'listen', args: { path: '/hooks' }, durable: true }; // answers {url}
1902
+ arrived(args) { return { status: 200, headers: {}, body: this.codec.utf8('ok').bytes, more: false }; }
1903
+ ```
1904
+
1905
+ A served request arrives as `arrived {request, method, path, query, headers, body, more}`, then
1906
+ `piece {request, body, more}`; the first answer that is no null is the response, its body piece 0, and each piece
1907
+ after it `network` asks as `rest {request, piece}` by its number, from 1, one asked ahead while the last goes, answered
1908
+ `{body, more}`; and `gone {request}` where the request broke. Bytes kept a piece a cell are served by number:
1909
+ `rest({ piece }) { return { body: this.cells.get(['blob', piece]), more: piece + 1 < count }; }`, a reading method that
1910
+ keeps no cursor and commits nothing. Declare `network: 'nervur.network'` among the placeholders, and declare `arrived`,
1911
+ `piece`, `rest` and `gone` with `askers: ["network"]`. A host is served only where it is reached: a machine with
1912
+ `--public`, or an edge at its domain; a browser and a phone serve nothing.
1913
+
1914
+ ## Talking to the world
1915
+
1916
+ - **Inviting.** A lobe invites to itself alone, through the ear: `ear` `invite {waits, lives, note?}`
1917
+ answers `{invitation, far}`, `far` the ID that will stand for the relation. `note` is free JSON on what the relation
1918
+ is for, kept by the brain and never sent. `says` is free JSON too, what the inviter wants known before the yes, a
1919
+ name, a purpose: it travels in the invitation, and a link's holder reads it with both spans by `#offer`, spending
1920
+ nothing. The invitation is Quo's `{text, sig}`: its text holds Quo's fields, both spans, `says` and the anchor's
1921
+ mark, and the ward drawn for it signs that text whole, so whoever carries it can change none of it and an accepting
1922
+ organism refuses one whose signature fails. The signature proves the text is the ward's own, never whose the ward
1923
+ is: a link on a domain says that by the domain's vouch. With `through: <address>` the ward is reached through an
1924
+ organism always on; with `refer: true` it answers a link, `{link: {card, reference}, far}`.
1925
+ - **Being asked from far.** Every ask over a relation the lobe gave carries `this.stamp.occupant`, `{far, note}`, the
1926
+ note given at the invitation with the lobe's own note merged over it. A role is read from that note and the
1927
+ lobe's cells. `left {far, note}` says the relation ended.
1928
+ - **Asking far.** A lobe wired to `mouth` accepts: `mouth` `accept {invitation, placeholder, note?}` answers `{far}`,
1929
+ and the lobe asks `placeholder` as any node. `once {card, method?, args?}` asks once with no relation, on the zero
1930
+ head; `drop {far}` ends a relation either way. An owner accepts for a lobe by the brain's
1931
+ `accept {relation, invitation, lobe}`.
1932
+ - **The public part.** At most one lobe is the ear's `front`, set by an owner's order:
1933
+ `nervur ask brain order '{"node":"ear","order":{"termination":"<ID>","placeholder":"front"}}'`. It answers strangers
1934
+ on the organism's public ward alike, and by default nothing a stranger asks changes anything: every run is a reading
1935
+ one, and only the ear's `invite` runs as ever, so the front hands out invitations and links, and a change goes over a
1936
+ relation the front invites the stranger to; a stranger's write through it answers
1937
+ `refused: A reading ask writes no cells.`. An owner's word `changes`, by `limit`, lifts that for the front,
1938
+ a repeat then its risk. From the command line, a stranger asks a front by the card its owner hands, the `result` of
1939
+ `nervur card --json` there:
1940
+ `nervur ask mouth once '{"card":{"ward":"<ward>","at":["tcp://example.com:9110"]},"method":"list"}'`.
1941
+ - **What a lobe never sees** is a ward or a key, only IDs. An ask over a relation runs at most once; one taken
1942
+ already hears `repeated`. A box is 1 MiB, more crossing in pieces.
1943
+ - **Reserved words.** No method opens with `#`. Quo and Nervur keep `#in`, `#whole`, `#out`, `#pieces`, `#leave` and
1944
+ `#redeem` and `#offer`, and the brain's words above.
1945
+
1946
+ ## Pilots
1947
+
1948
+ A pilot lays an organism on a host from afar. It is a repo's, never a port's: the port gives it the cargo, the claim and
1949
+ what its channel lays, and nothing else. Nervur publishes no pilot; write one as any
1950
+ faculty and organ:
1951
+
1952
+ - **An edge.** It automates An edge, by hand: a skin lobe of `network` (the provider's API is a web request) and of an
1953
+ organ that reads the cargo's files. It draws `CLAIM` from its stamp's seed, uploads the Worker in one request, the
1954
+ same binding, migration and secret as `wrangler.toml` names (Cloudflare's script upload takes them as
1955
+ its metadata, beside each file as a module, `application/wasm` for each `.wasm`), opens its domain, asks
1956
+ `POST /.nervur/claim` and accepts the first invitation through `mouth`, so its organism holds the anchor. It
1957
+ lays a new version by laying again, and reaches the other routes of the cargo for a backup, a move or a reclaim. Its
1958
+ provider token is a key of its own, kept in its cells and never answered.
1959
+ - **A machine.** It draws the claim from its stamp's seed, has the machine run
1960
+ `nervur install --boot file --claim <file>`, by cloud-init or a skin lobe of `shell` over `ssh`, asks
1961
+ `POST /.nervur/claim` through the machine's proxy and accepts the first invitation through `mouth`, as for an edge.
1962
+ - **What a pilot keeps** is its own: the places it laid, each claim until the anchor is passed on. The claim opens
1963
+ nothing and proves only that its holder could lay the host.
1964
+
1965
+ ## Releasing and owning
1966
+
1967
+ - **A release** is a version told: raise the root `package.json`'s version in a commit, which the repo lobe tags
1968
+ `v<version>`. What leaves a repo is a version by its digest; an owner moves a lobe to it by `version`. A
1969
+ package is published only by a `run` of a publish script on a repo lobe, with the keys of that copy, at an owner's or
1970
+ a runner's ask. Keys are a copy's: `setToken {name, value}` keeps one in the lobe's cells, written to
1971
+ `.env` before each run, never answered.
1972
+ - **Sharing a repo.** A repo lobe's `invite {standing}` gives a `reader` (pull), a `writer` (pull and push), a `library`
1973
+ (read what was told) or a `runner` (runs the `scripts` it names); a reader's or writer's may name `scope`, folders of
1974
+ the repo. Another organism takes a repo by a repo lobe's `accept`; a library by the library's
1975
+ `accept {invitation}`, then `add` naming that far road.
1976
+ - **Delivering into a buyer's repo.** The buyer's repo lobe invites the builder with a writer's standing scoped to the
1977
+ folders it delivers, a note and a span. The builder's repo lobe pulls the scope, commits and pushes; the buyer's lobe
1978
+ checks it by both checks and its gate before it lands. The standing ends and the builder keeps nothing of
1979
+ the buyer's; a version enters the buyer's library from the buyer's own repo lobe.
1980
+ - **Updating lobes.** A new version enters the library, then `version {lobe, faculty}` moves each lobe, its `migrate`
1981
+ running; `settle` when it holds, or move back. `nervur update` moves the lobes on the installer's own faculties alone,
1982
+ each on an older version than it ships, never a lobe on a repo's faculty.
1983
+ - **Authoring with an agent.** Open the repo's own folder. Nervur's guide, this paper and the changelog stand one folder
1984
+ up in the lent genome's `docs/`; the repo's harness, its skills, its gate stand in the repo, its owners' own. Code
1985
+ runs only where its owners ask it.