@nervur.org/genome 0.37.8 → 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 +22 -21
- package/docs/authoring.md +26 -22
- package/docs/changelog.md +5 -6
- package/docs/guide.md +437 -323
- package/genome/brain/guide.js +2 -2
- package/genome/faculties/ear/blueprint.js +1 -1
- package/genome/faculties/ear/text.js +1 -1
- package/genome/faculties/library/blueprint.js +1 -1
- package/genome/faculties/library/text.js +1 -1
- package/genome/faculties/mouth/blueprint.js +1 -1
- package/genome/faculties/mouth/text.js +1 -1
- package/genome/faculties/scheduler/blueprint.js +1 -1
- package/genome/faculties/scheduler/text.js +1 -1
- package/package.json +1 -1
- package/standard/version.js +1 -1
package/README.md
CHANGED
|
@@ -1,29 +1,30 @@
|
|
|
1
1
|
# @nervur.org/genome
|
|
2
2
|
|
|
3
|
-
|
|
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.**
|
|
7
|
-
it changes
|
|
8
|
-
|
|
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
|
|
13
|
-
| `@nervur.org/genome/standard` | data, blueprints, schemas
|
|
14
|
-
| `@nervur.org/genome/seams` | every seam
|
|
15
|
-
| `@nervur.org/genome/
|
|
16
|
-
| `@nervur.org/genome/
|
|
17
|
-
| `@nervur.org/genome/
|
|
18
|
-
| `@nervur.org/genome/
|
|
19
|
-
| `@nervur.org/genome/
|
|
20
|
-
| `@nervur.org/genome/
|
|
21
|
-
| `@nervur.org/genome/
|
|
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
|
-
|
|
24
|
-
|
|
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
|
|
541
|
-
or Linux over `ssh`, `nervur screen` answers that the host holds none, and the
|
|
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
|
|
545
|
-
each
|
|
546
|
-
|
|
547
|
-
|
|
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,9 +1,8 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
-
## 0.37.
|
|
3
|
+
## 0.37.9
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
The
|
|
9
|
-
devices never draw alike; a test that names a seed draws as before.
|
|
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.
|