@plurnk/plurnk-meta 1.15.0 → 1.16.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.
- package/CORPUS.md +1 -1
- package/docs/git.md +3 -3
- package/docs/worker.md +11 -11
- package/package.json +1 -1
package/CORPUS.md
CHANGED
|
@@ -13,7 +13,7 @@ Authored defaults published by `@plurnk/plurnk-meta` and consumed by
|
|
|
13
13
|
| `docs/worker.md` | Read when registered built-in pull docs are materialized. |
|
|
14
14
|
|
|
15
15
|
Core materializes eligible pull docs at `worker://~/_plurnk/skills/plurnk/<name>.md` and
|
|
16
|
-
exposes them through the turn-0
|
|
16
|
+
exposes them through the turn-0 `### FIND0 [+init,+skills] (worker://~/_plurnk/skills/plurnk/*.md)` survey. Merely
|
|
17
17
|
placing a file in `docs/` does not register a scheme or make speculative
|
|
18
18
|
teaching current. Every listed source is a required package member; a missing
|
|
19
19
|
or failed read surfaces at the admission boundary rather than silently reducing
|
package/docs/git.md
CHANGED
|
@@ -19,15 +19,15 @@ the subject a sentence that says what changed, never why the model felt like it.
|
|
|
19
19
|
WORK whose brief begins with the branch it owns:
|
|
20
20
|
|
|
21
21
|
```example
|
|
22
|
-
|
|
22
|
+
### EXEC0 <!-- park my own work before anyone switches -->
|
|
23
23
|
git add -A && git commit -q -m "wip: parser rewrite before delegating the lexer"
|
|
24
24
|
|
|
25
|
-
|
|
25
|
+
### WORK0 (worker://lexer)
|
|
26
26
|
On a new branch `feat/lexer` from the current HEAD: replace src/lexer.js with the
|
|
27
27
|
table-driven lexer described in docs/lexer.md, run `npm test`, commit on that branch,
|
|
28
28
|
then `git switch -` back to the branch you started on and report the commit hash.
|
|
29
29
|
|
|
30
|
-
|
|
30
|
+
### SEND0 (WAIT)
|
|
31
31
|
Awaiting lexer.
|
|
32
32
|
```
|
|
33
33
|
|
package/docs/worker.md
CHANGED
|
@@ -7,18 +7,18 @@ Coordinate workers and manage shared or private workspace entries.
|
|
|
7
7
|
Workers inhabit one workspace. `worker://<name>` addresses a named worker; `worker://~` is the
|
|
8
8
|
current-worker control sigil; `worker://~/path` addresses your private entries; `worker:///path`
|
|
9
9
|
addresses the shared commons.
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
with a message body wakes and messages a worker;
|
|
10
|
+
`### WORK0 (worker://<name>)` with a task body spawns a fresh worker with an empty log.
|
|
11
|
+
`### FORK0 (worker://<name>)` branches your current history. `### SEND0 (worker://<name>)`
|
|
12
|
+
with a message body wakes and messages a worker; `### KILL0 (worker://<name>)` ends one.
|
|
13
13
|
Workers share project files and the commons, while private entries
|
|
14
14
|
and conversation logs remain owner-scoped. A worker is born from WORK/FORK, never EDIT —
|
|
15
|
-
|
|
15
|
+
`### EDIT0 (worker://<name>)` on the bare worker is rejected.
|
|
16
16
|
|
|
17
17
|
**The path is the discriminator.** `worker://<name>` with no path addresses a literal worker name
|
|
18
18
|
for WORK, FORK, SEND, READ, or KILL; `worker://~` addresses the caller for SEND or KILL.
|
|
19
19
|
The control form is exact: a trailing slash, userinfo, port, query, fragment, or `{metadata}` modifier
|
|
20
20
|
is invalid rather than ignored.
|
|
21
|
-
`worker://<name>/path` addresses an ancestry-visible named entry;
|
|
21
|
+
`worker://<name>/path` addresses an ancestry-visible named entry; `### EDIT0 (worker://~/todo.md)`
|
|
22
22
|
with a body writes your own private entry.
|
|
23
23
|
|
|
24
24
|
**WORK to delegate, FORK to branch.** For fan-out, WORK a distinct-named worker per job. Each gets
|
|
@@ -27,20 +27,20 @@ a fresh task. FORK only to carry *your own* context down an alternate path.
|
|
|
27
27
|
**Loop: spawn once → park → collect on wake.** Spawn and park with:
|
|
28
28
|
|
|
29
29
|
```example
|
|
30
|
-
|
|
30
|
+
### WORK0 (worker://capital-checker)
|
|
31
31
|
Find the capital of France from a primary source
|
|
32
32
|
|
|
33
|
-
|
|
33
|
+
### SEND0 (WAIT)
|
|
34
34
|
Awaiting capital-checker.
|
|
35
35
|
```
|
|
36
36
|
|
|
37
37
|
You wake when the worker concludes: its
|
|
38
38
|
result arrives open in your log as a `SEND` from `worker://capital-checker` — read it and continue.
|
|
39
|
-
Or pull it with
|
|
39
|
+
Or pull it with `### READ0 (worker://capital-checker)`; it returns the result, or `425` while running. Spawn
|
|
40
40
|
each worker exactly once. Fan-out uses distinct names, followed by one park. Each conclusion wakes
|
|
41
41
|
you with its delta.
|
|
42
42
|
|
|
43
|
-
**Concluding with live workers.**
|
|
43
|
+
**Concluding with live workers.** `### SEND0 (TERM)` is refused (`409`) while you hold a live worker or
|
|
44
44
|
open stream. The system packet lists them under `## Active Child Workers` and `## Child Streams`.
|
|
45
|
-
Either
|
|
46
|
-
A same-turn KILL followed by
|
|
45
|
+
Either `### SEND0 (WAIT)` to await them or `### KILL0 (worker://<name>)` the ones you no longer need.
|
|
46
|
+
A same-turn KILL followed by `### SEND0 (TERM)` concludes cleanly.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@plurnk/plurnk-meta",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.16.1",
|
|
4
4
|
"description": "The plurnk metaproject layer, published: plugin-membership primitives (the ONE trust rule, scope-agnostic symlink-aware enumeration, deployment-root resolution), the project teaching corpus (personality, Recap, scheme docs), and the home for family tooling.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|