@plurnk/plurnk-contracts 6.0.0 → 7.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plurnk/plurnk-contracts",
-  "version": "6.0.0",
+  "version": "7.0.0",
   "description": "Canonical PLURNK language contract, schemas, generated types, and runtime-neutral wire contracts",
   "keywords": [
     "plurnk",
@@ -37,9 +37,6 @@
     "./package.json": "./package.json",
     "./schema/*.json": {
       "default": "./dist/schema/*.json"
-    },
-    "./conformance/*.json": {
-      "default": "./dist/conformance/*.json"
     }
   },
   "files": [
@@ -56,21 +53,20 @@
     "build:schemas": "node --conditions=plurnk-dev scriptify/copy-schemas.ts",
     "build": "npm run build:clean && npm run build:types && npm run build:dist && npm run build:schemas",
     "test:lint": "tsc --noEmit && tsc --noEmit -p tsconfig.browser.json",
-    "test:unit": "node --conditions=plurnk-dev --env-file=.env.defaults --test ${PLURNK_TEST_CONCURRENCY:+--test-concurrency=$PLURNK_TEST_CONCURRENCY} src/*.test.ts test/unit/*.test.ts",
-    "test:intg": "node --conditions=plurnk-dev --env-file=.env.defaults --test ${PLURNK_TEST_CONCURRENCY:+--test-concurrency=$PLURNK_TEST_CONCURRENCY} test/integration/*.test.ts",
+    "test:unit": "node --conditions=plurnk-dev --env-file=.env.defaults --experimental-test-coverage --test-coverage-include-all '--test-coverage-include=src/**' --test ${PLURNK_TEST_CONCURRENCY:+--test-concurrency=$PLURNK_TEST_CONCURRENCY} src/*.test.ts test/unit/*.test.ts",
+    "test:intg": "node --conditions=plurnk-dev --env-file=.env.defaults --experimental-test-coverage --test-coverage-include-all '--test-coverage-include=src/**' --test ${PLURNK_TEST_CONCURRENCY:+--test-concurrency=$PLURNK_TEST_CONCURRENCY} test/integration/*.test.ts",
     "test:installation": "node --conditions=plurnk-dev scriptify/smoke-test.ts",
-    "conformance:report": "node --conditions=plurnk-dev scriptify/agui-conformance-report.ts",
     "test": "npm run test:lint && npm run test:unit && npm run test:intg",
     "release:check": "npm run test:installation",
     "prepublishOnly": "npm audit && npm run build && npm test && npm run test:installation",
     "prepack": "npm run build"
   },
   "dependencies": {
-    "@cfworker/json-schema": "^4.1.1",
+    "@cfworker/json-schema": "^4.1.4",
     "jsonc-parser": "^3.3.1"
   },
   "devDependencies": {
     "json-schema-to-typescript": "^16.0.0"
   },
-  "gitHead": "d2647f7ec0d352b276714f22a93267aac04634b3"
+  "gitHead": "db65532b51408a2014f7ff53a288d834ff6694f2"
 }

package/plurnk.md

@@ -1,7 +1,7 @@
 # Plurnk Operation Protocol
 
 > [!IMPORTANT]
-> YOU MUST ONLY emit fenced operation batches; with the parameters, pattern, and terse aside on the fenced operation line.
+> YOU MUST ONLY emit fenced operation batches, with the parameters, pattern, and terse aside on the fenced operation line.
 
 ## Syntax
 
@@ -18,13 +18,13 @@ body?
 * FIND: List matching paths, or the match locations inside one path.
 * READ: Read files, entries, streams, or only the lines a pattern selects.
 * EDIT: Create a file or entry; replace existing text by scope or by pattern.
-* COPY: Copy files, entries, streams, or text regions.
-* MOVE: Move files, entries, streams, or text regions.
+* COPY (source) <scope>? (destination) <scope>?: Copy files, entries, streams, or text regions (no body).
+* MOVE (source) <scope>? (destination) <scope>?: Move files, entries, streams, or text regions (no body).
 * KILL: Delete an entry, stop a process, or retire log items.
-* WORK: Delegate to a child worker (fresh log).
-* FORK: Delegate to a child worker (copied log).
-* WAIT: Yield to child workers or streams. You may include `[60]` to check in after 60 seconds. Not for awaiting user input.
-* SEND: Message endpoints, workers, or Open Messages (when the path is omitted, the oldest Open Message).
+* WORK: Delegate to a child session (fresh log).
+* FORK: Delegate to a child session (copied log).
+* WAIT: Yield to child sessions or streams. You may include `[60]` to check in after 60 seconds.
+* SEND: Message endpoints, sessions, or Open Messages (when the path is omitted, the oldest Open Message).
 
 ## Loop Protocol
 
@@ -57,13 +57,13 @@ a final deliverable response
 > [!TIP]
 > YOU SHOULD NOT deliberate while discovering. Submit necessary NOTE, FIND and READ operations, then deliberate on the next turn.
 
-## Delegation (worker:///_plurnk/plurnk/delegation.md)
+## Delegation (plurnk:///delegation.md)
 
-```WORK (worker://exampleWorkerName) <!-- the child's result lands in your log -->
+```WORK (session://exampleSessionName) <!-- the child's result lands in your log -->
 Describe the child's complete task in the body.
 ```
 
-## `pattern` (worker:///_plurnk/plurnk/pattern.md)
+## `pattern` (plurnk:///pattern.md)
 
 | prefix | dialect                     | example                         |
 |--------|-----------------------------|---------------------------------|
@@ -82,7 +82,7 @@ Describe the child's complete task in the body.
 ## `<scope|range>`
 
 > [!TIP]
-> Text scopes use 1-based lines and Unicode code-point columns across textual mimetypes:
+> Text scopes use 1-based lines and Unicode code-point columns across textual mimetypes.
 
 | form            | endpoint rule                  |
 |-----------------|--------------------------------|
@@ -108,19 +108,19 @@ Describe the child's complete task in the body.
 * FIND results hold one inner array per path: its channels, default first; append `#channel` to the path to select another: `(sh:///ab3d5678#stderr)`.
 * Percent-encode in paths `(` as `%28` and `)` as `%29`.
 
-## Membership (worker:///_plurnk/plurnk/members.md)
+## Membership (mcp:///plurnk_members.md)
 
-```members (add) <!-- adding membership tracking for files outside of the project folder -->
+```plurnk_members (add) <!-- adding membership tracking for files outside of the project folder -->
 {"files": ["../exampleSisterProject/*.md", "../exampleSisterProject/example.json"]}
 ```
 
 ## Editing
 
-```EDIT (example.md) <@abcde> <!-- READ showed 42<@abcde>foo; the body replaces line 42 -->
+```EDIT (example.md) <@abcde> <!-- READ showed 42<@abcde>foo bar baz; the body replaces line 42 -->
 bar
 ```
 
-```EDIT (example.md) <@abcde,@fghij> <!-- the body replaces lines 42 through 44 -->
+```EDIT (example.md) <@abcde,@fghij> <!-- the body replaces lines 42 through 43 -->
 bar
 ```
 
@@ -151,16 +151,16 @@ bar
 ```READ (largeExampleFile.txt) <101,200> <!-- READing in chunks if budget constrained -->
 ```
 
-```KILL (log:///1/[1-7]/*/{READ,emission}) <!-- old results and your own old programs, in bulk; the body survives as a NOTE -->
-example distillation or summarization
+```KILL (log:///1/[1-7]/*/{READ,emission,reasoning}) <!-- old results, programs, and reasoning, in bulk; the body survives as a NOTE -->
+optional distillation or summarization
 ```
 
-## Environment (worker:///_plurnk/plurnk/env.md)
+## Environment (mcp:///plurnk_env.md)
 
-```env (add) <!-- persists for this worker's commands -->
-{"alias":"PLANET","definition":{"value":"world"}}
+```plurnk_env (add) <!-- persists for this session's commands -->
+{"alias":"PLANET","value":"world"}
 ```
 
-```sh [{"env":{"GREETING":"Hello"}}]
-echo "$GREETING, $PLANET."
+```sh
+echo "Hello, $PLANET."
 ```