@nervur.org/genome 0.37.8 → 0.37.10

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.
package/README.md CHANGED
@@ -1,29 +1,30 @@
1
1
  # @nervur.org/genome
2
2
 
3
- What every Nervur organism is: the brain, the lobes and their engine, the
4
- store, Quo, and the seams a host fills. It knows no host.
3
+ The kernel every Nervur organism runs, on every host: the brain and its lobes, the engine they run in, the encrypted
4
+ store, Quo between organisms, and the seams a host fills. It knows no host.
5
5
 
6
- **0.x is unstable.** Every version before 1.0.0 may change what it exports, and every release raises the patch, whatever
7
- it changes, until 1.0.0. A person installs Nervur by its command, `npm install -g nervur`; this package is what the
8
- installers and every other host take.
6
+ **0.x is unstable.** Until 1.0.0 any version may change what it exports, and every release raises the patch, whatever
7
+ it changes. A person installs Nervur by its command, `npm install -g nervur`; this package is what the installers, and
8
+ anyone building a host or proving a faculty, take.
9
9
 
10
- | Import | What it holds |
11
- | ----------------------------------- | ---------------------------------------------------------- |
12
- | `@nervur.org/genome` | the genome's entry, codec and queues, and the cage's `run` |
13
- | `@nervur.org/genome/standard` | data, blueprints, schemas, names |
14
- | `@nervur.org/genome/seams` | every seam's interface and its contract |
15
- | `@nervur.org/genome/quo` | Quo, over the crypto seam |
16
- | `@nervur.org/genome/faculty` | the faculty base class, the library's source, the read |
17
- | `@nervur.org/genome/engine` | the engine, QuickJS in WebAssembly |
18
- | `@nervur.org/genome/evidence` | a faculty read and its evidence replayed on the engine |
19
- | `@nervur.org/genome/screen` | the screen's pure core |
20
- | `@nervur.org/genome/nervur-faculty` | the types of `nervur:faculty`, for a faculty's tsconfig |
21
- | `@nervur.org/genome/sqlite.wasm` | the store's SQLite3 Multiple Ciphers |
10
+ | Import | What it holds |
11
+ | ----------------------------------- | --------------------------------------------------------------------------------- |
12
+ | `@nervur.org/genome` | the organism's entry, for a host to boot it |
13
+ | `@nervur.org/genome/standard` | data, blueprints, schemas and names |
14
+ | `@nervur.org/genome/seams` | every seam a host fills, its interface and its contract |
15
+ | `@nervur.org/genome/contracts` | the test suite each seam's fill is run against, for a host's tests |
16
+ | `@nervur.org/genome/cage` | what runs a lobe's ask: the cage's `run` and the codec, for a host's threads |
17
+ | `@nervur.org/genome/quo` | Quo, over the crypto seam |
18
+ | `@nervur.org/genome/faculty` | the `Faculty` base class and the read of a faculty's source |
19
+ | `@nervur.org/genome/nervur-faculty` | the types of `nervur:faculty`, for a faculty's `tsconfig` |
20
+ | `@nervur.org/genome/engine` | the engine, QuickJS in WebAssembly |
21
+ | `@nervur.org/genome/evidence` | a faculty's evidence, replayed on the engine |
22
+ | `@nervur.org/genome/kit` | what an author proves a faculty on: a recorded host and organisms on the engine |
23
+ | `@nervur.org/genome/screen` | the screen's pure core: trees composed, diffed and patched |
24
+ | `@nervur.org/genome/sqlite.wasm` | the store's SQLite3 Multiple Ciphers |
22
25
 
23
- Each import gives what the installers and every other host take. Inside, the genome's parts take each other's whole
24
- index
25
- by its own names, `#standard`, `#seams`, `#quo`, `#faculty`, `#genome` and `#engine`, which nothing outside the package
26
- resolves.
26
+ What Nervur is, and how to build on it, is in the papers this package carries in `docs/`: `guide.md` first, then
27
+ `authoring.md`; `changelog.md` says what each version changed.
27
28
 
28
29
  FSL-1.1-ALv2 (the Functional Source License), Bookarest Digital SRL. Nervur takes no contributions, merge requests or
29
30
  issues; a flaw of security goes to <security@nervur.org>, privately.
package/docs/authoring.md CHANGED
@@ -485,6 +485,7 @@ always take a far anchor back by dropping it.
485
485
  | `lobe <lobe> [method] [args]` | asks a lobe through the brain; no method describes it |
486
486
  | `accept <placeholder> <invitation> [note]` | accepts an invitation; `accept <link> [placeholder] [note]` takes a link |
487
487
  | `offer <link>` | reads a link's offer, what it says and its spans, and spends nothing |
488
+ | `open <link>` | hands a link to this home's screen, which shows its offer and asks the yes |
488
489
  | `forget <placeholder>`, `relations`, `ends` | ends an accepted relation; lists them; every occupant and standing |
489
490
  | `backup [file]`, `salvage [file]` | a backup to a file of yours; what still opens of a damaged store |
490
491
  | `restore <file> [salt]` | a backup restored where no organism stands, as a new life |
@@ -492,6 +493,7 @@ always take a far anchor back by dropping it.
492
493
  | `rewrap`, `rekey [--cipher <name>]` | a new boot key; a new boot key and data key |
493
494
  | `reclaim` | reclaims the organism by a recovery key |
494
495
  | `repos` | lays the jailer, the first time you want a repo |
496
+ | `repo <name> [--starter]` | makes a repo in one act: the jailer, a repo lobe, its folder and its first init |
495
497
  | `mcp` | serves MCP on standard input and output to a model present at the device |
496
498
  | `wipe` | destroys the organism and all it holds, once you type `wipe` |
497
499
 
@@ -507,20 +509,20 @@ holds one organism, in its home, and the command refuses a second anywhere else.
507
509
  An owner reaches the organism through the brain; each is `nervur ask brain <method> '<args>'`, or the same ask over a
508
510
  placeholder of an organism owned from afar:
509
511
 
510
- | Group | Methods |
511
- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
512
- | Faculties and lobes | `create {faculty, wiring?, cells?, sealed?}`, `version {lobe, faculty, settled?}`, `settle`, `switchOff`, `switchOn`, `tearDown`, `lobes` |
513
- | Organs | `addOrgan {id, blueprint, reach, half}`, `removeOrgan`, `settleOrgan` |
514
- | Wiring | `order {node, order: {termination, placeholder?, until?}, note?}`, `unwire` |
515
- | Reaching | `ask {lobe, method, args, timeout}` |
516
- | Owners | `invite {waits, lives, anchor?, refer?, public?, through?, note?}`, `drop`, `recoveryKeys {keys}` |
517
- | Keys | `rewrap`, `rekey`, `move {to}` |
518
- | Who and where | `ward`, `addresses {at}`, `hand {far, at}`; `card` reads them |
519
- | Ends | `accept {relation, invitation?, link?, note?, lobe?}`, `note`, `reinvite`, `drop`; `taking`, `cede {far, to}`, `take {handed, key, relation}` |
520
- | Life | `backup {keys?}`, `backupPiece {mark, at, length}`, `upgrade {version, digest}`, `time {at}` |
521
- | Limits | `limit {name, lobe?, value?}`, `limits` |
522
- | Letters | `repost`, `forget`, `cancel` |
523
- | State and character | `state {cursor?}`, `ends`, `card`, `character`, `setCharacter`, `portrait` |
512
+ | Group | Methods |
513
+ | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
514
+ | Faculties and lobes | `create {faculty, wiring?, cells?, sealed?}`, `version {lobe, faculty, settled?}`, `settle`, `switchOff`, `switchOn`, `tearDown`, `lobes` |
515
+ | Organs | `addOrgan {id, blueprint, reach, half}`, `removeOrgan`, `settleOrgan` |
516
+ | Wiring | `order {node, order: {termination, placeholder?, until?}, note?}`, `unwire` |
517
+ | Reaching | `ask {lobe, method, args, timeout}` |
518
+ | Owners | `invite {waits, lives, anchor?, refer?, public?, through?, note?}`, `drop`, `recoveryKeys {keys}` |
519
+ | Keys | `rewrap`, `rekey`, `move {to}` |
520
+ | Who and where | `ward`, `addresses {at}`, `hand {far, at}`; `card` reads them |
521
+ | Ends | `offer {link}`, `accept {relation, invitation?, link?, note?, lobe?}`, `note`, `reinvite`, `drop`; `taking`, `cede {far, to}`, `take {handed, key, relation}` |
522
+ | Life | `backup {keys?}`, `backupPiece {mark, at, length}`, `upgrade {version, digest}`, `time {at}` |
523
+ | Limits | `limit {name, lobe?, value?}`, `limits` |
524
+ | Letters | `repost`, `forget`, `cancel` |
525
+ | State and character | `state {cursor?}`, `ends`, `card`, `character`, `setCharacter`, `portrait`, `authoring` |
524
526
 
525
527
  Each method's blueprint says the rest: `nervur ask brain` describes them all. `lobe <id> ...` is the brain's `ask`.
526
528
 
@@ -537,14 +539,16 @@ home's own, asked of the organism where it runs, or in words why this home's scr
537
539
  organism of the account holds its port. It shows the organism, its lobes, the library and the place the person stands
538
540
  on; a lobe is at `/~/<ID>`. What more a person is offered there, other homes, devices let in, lists and choices, is a
539
541
  window's of your own (Where Nervur stops). Only a host where a person sits holds a screen: a Mac, Windows, Linux inside
540
- a graphical session, or any machine whose first install said `--screen`; on a server, a Pi
541
- or Linux over `ssh`, `nervur screen` answers that the host holds none, and the organism is owned at its console or from
542
- afar. A browser draws in the site's page, a phone in its app; an edge draws nothing.
542
+ a graphical session, or any machine whose first install said `--screen`, and none whose first install said
543
+ `--no-screen`; on a server, a Pi or Linux over `ssh`, `nervur screen` answers that the host holds none, and the
544
+ organism is owned at its console or from afar. A browser draws in the site's page, a phone in its app; an edge draws nothing.
543
545
 
544
- A model is present at the console as a person is, and holds no more: `nervur mcp` serves it the tools `ask` and `lobe`,
545
- each typed at the console, and the resources `nervur://portrait`, `nervur://guide` and `nervur://state`. A method marked
546
- `irreversible` is hinted destructive. `portrait` answers Nervur's guide, the organism's character and each lobe with its
547
- own guide.
546
+ A model is present at the console as a person is, and holds no more: `nervur mcp` serves it one tool for each method of
547
+ each node the console holds, `brain` and every placeholder it accepted, named `<placeholder>.<method>` and typed and
548
+ described by the method's blueprint, each call typed at the console as a line; and the resources `nervur://portrait`,
549
+ `nervur://guide`, `nervur://state`, `nervur://node/{placeholder}` (a node's describe) and `nervur://lobe/{id}`. A method
550
+ marked `irreversible` is hinted destructive, and a job is followed as a task where the client holds MCP's tasks.
551
+ `portrait` answers Nervur's guide, the organism's character and each lobe with its own guide.
548
552
 
549
553
  ## Life across devices and years
550
554
 
@@ -1409,7 +1413,7 @@ args.
1409
1413
  ## A window of your own
1410
1414
 
1411
1415
  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
1416
+ what the screen shows there, and carries each press. The floor's is `nervur.window`; its source is `WINDOW.faculty` of
1413
1417
  `@nervur.org/floor`, one module importing `nervur:faculty` alone, to read or to start from. A host names the window an
1414
1418
  organism is born wearing (Where Nervur stops); this section is all it asks of one. What the floor's window answers
1415
1419
  below is one way to answer it; what any window must answer is said so.
@@ -1617,8 +1621,8 @@ export default (args) => ({
1617
1621
 
1618
1622
  `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
1623
  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.
1624
+ floor's own design is the whole example: `WINDOW.given.design` of `@nervur.org/floor` holds its look as `faculty`,
1625
+ every component built in, and its data by path as `assets`.
1622
1626
 
1623
1627
  ## The browser and the web
1624
1628
 
@@ -1663,7 +1667,7 @@ the site names then: the source checked against `text` and read as a faculty dec
1663
1667
  deploy that names another moves each visitor's organism to it at its next boot, unless its person moved their window
1664
1668
  by `version`, which stands. A window that fails is refused whole: the organism wears the floor's, and the refusal is
1665
1669
  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.
1670
+ as any faculty, the floor's `WINDOW.faculty` of `@nervur.org/floor` being one to start from.
1667
1671
 
1668
1672
  **The port's note.** Where the browser declines to persist the store, the port says so in the screen's element, in a
1669
1673
  `p[data-quo-note="store"]` beside the caged tree, which the site's own sheet styles. It is said in the home's words,
package/docs/changelog.md CHANGED
@@ -1,9 +1,14 @@
1
1
  # Changelog
2
2
 
3
- ## 0.37.8
3
+ ## 0.37.10
4
4
 
5
- An update's trial now refuses a store whose character, or any of the organism's own bookkeeping rows, holds a value
6
- this version never writes, where before it let some of them pass unread.
5
+ `@nervur.org/floor` gives each faculty one way, its skin: `TERMINAL`, `WINDOW`, `REPOS` and `REPO`, each source as
6
+ `faculty`. `TERMINAL_SOURCE`, `WINDOW_SOURCE`, `REPOS_SOURCE`, `REPO_SOURCE`, `REPOS_PROGRAMS`, `FLOOR_DESIGN`,
7
+ `FLOOR_FILES` and `FLOOR_LOOK_SOURCE` are gone: read `WINDOW.faculty` for the window's source and `WINDOW.given.design`
8
+ for the floor's design, its look as `faculty` and its data as `assets`. The design kit no longer exports `SCREEN_WAY`.
7
9
 
8
- The test kit's organisms, peers and stores each draw a random stream of their own where a test names no seed, as two
9
- devices never draw alike; a test that names a seed draws as before.
10
+ A place's call or stream channel is now answered `unavailable` by the window itself, as no home carries one yet, and
11
+ reaches no host.
12
+
13
+ A repo lobe's description of a credential now says how it is renewed as it is: at a tenth of its life, and a renewal
14
+ that fails asked again at half what is left, never within a minute.