@nervur.org/genome 0.37.7 → 0.37.9

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/cage/run/given.js CHANGED
@@ -105,7 +105,7 @@ export const startDrive = (
105
105
  const nextGiven = (driving ) => {
106
106
  const next = driving.given[driving.at];
107
107
  if (next === undefined) return null;
108
- return driving.book.waits(next.ask) && next.ask > 0
108
+ return driving.book.waits(next.ask)
109
109
  ? next
110
110
  : `the answer given ${driving.at + 1} settles ask ${next.ask}, which the code does not wait on`;
111
111
  };
package/cage/run/input.js CHANGED
@@ -27,8 +27,9 @@ const FIELDS = new Set([
27
27
  ]);
28
28
 
29
29
  const codeOf = (data , at ) => {
30
- const [only, ...more] = isFields(data) ? Object.keys(data) : [];
31
- const value = isFields(data) && only !== undefined ? data[only] : undefined;
30
+ const fields = isFields(data) ? data : {};
31
+ const [only, ...more] = Object.keys(fields);
32
+ const value = only === undefined ? undefined : fields[only];
32
33
  if (more.length > 0 || typeof value !== 'string' || (only !== 'digest' && only !== 'source'))
33
34
  return { why: `${at} is neither { digest } nor { source }` };
34
35
  return only === 'digest' ? { digest: value } : { source: value };
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.
543
-
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.
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.
545
+
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
 
package/docs/changelog.md CHANGED
@@ -1,11 +1,8 @@
1
1
  # Changelog
2
2
 
3
- ## 0.37.7
3
+ ## 0.37.9
4
4
 
5
- A host with no pages that only resumes its organism from its saved state, never opening the store under its key, must
6
- now open it so at least once in the years before its data key seals its most: that opening reseals what it holds under
7
- a new key, and without it the store stops short of the bound. The store and the saved state of 0.37.5, which counted
8
- no seals, are no longer read.
9
-
10
- The kit's organisms draw on from the same chance across a restart, as a device's entropy never gives the same bytes
11
- twice.
5
+ The guide is told anew in plainer words, each term defined where it first appears, with a list of Nervur's words at its
6
+ end. The authoring paper now tells `nervur open` and `nervur repo`, `--no-screen`, the brain's `offer` and `authoring`,
7
+ and the MCP server as it is: one tool for each method of each node the console holds, and a resource for each node and
8
+ lobe. The genome's README names every import it publishes.