@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 +22 -21
- package/docs/authoring.md +29 -25
- package/docs/changelog.md +10 -5
- 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.
|
|
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
|
|
545
|
-
each
|
|
546
|
-
|
|
547
|
-
|
|
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 `
|
|
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: `
|
|
1621
|
-
|
|
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 `
|
|
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.
|
|
3
|
+
## 0.37.10
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
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
|
-
|
|
9
|
-
|
|
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.
|