@plurnk/plurnk-grammar 0.74.47 → 0.74.49

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plurnk/plurnk-grammar",
-  "version": "0.74.47",
+  "version": "0.74.49",
   "description": "ANTLR4 grammar for the Plurnk LLM agent protocol",
   "type": "module",
   "license": "MIT",

package/plurnk.md

@@ -22,21 +22,21 @@ YOU MUST ONLY use the Plurnk OPs (PLAN|FIND|READ|EDIT|COPY|MOVE|OPEN|FOLD|EXEC|K
 Fields are optional unless otherwise specified.
 The `(path)` is required for every operation except PLAN, EXEC, and SEND.
 
-| OP   | `[signal]`    | `(path)`    | `<Line / Result>` | :body:                | OP   |
-|------|---------------|-------------|-------------------|-----------------------|------|
-| PLAN | -             | -           | -                 | :plan / reasoning:    | PLAN |
-| FIND | [filter tags] | (path)      | <result,result>   | :pattern:             | FIND |
-| READ | [filter tags] | (path)      | <line,line>       | :pattern:             | READ |
-| EDIT | [tags]        | (path)      | <line,line>       | :literal replacement: | EDIT |
-| COPY | [apply tags]  | (path)      | <line,line>       | :destination path:    | COPY |
-| MOVE | [apply tags]  | (path)      | <line,line>       | :destination path:    | MOVE |
-| OPEN | [filter tags] | (log path)  | <result,result>   | :pattern:             | OPEN |
-| FOLD | [filter tags] | (log path)  | <result,result>   | :pattern:             | FOLD |
-| EXEC | [executor]    | (path)      | <timeout, poll>   | :code:                | EXEC |
-| KILL | [signal]      | (path)      | -                 | ::                    | KILL |
-| SEND | [status code] | (recipient) | -                 | :message:             | SEND |
-
-<<PLAN:plan goes here:PLAN is required at the beginning of a turn.
+| OP   | `[signal]`    | `(path)`    | `<Line / Result>` | :body:             | OP   |
+|------|---------------|-------------|-------------------|--------------------|------|
+| PLAN | -             | -           | -                 | :plan, free text:  | PLAN |
+| FIND | [filter tags] | (path)      | <result,result>   | :pattern:          | FIND |
+| READ | [filter tags] | (path)      | <line,line>       | :pattern:          | READ |
+| EDIT | [tags]        | (path)      | <line,line>       | :literal text:     | EDIT |
+| COPY | [apply tags]  | (path)      | <line,line>       | :destination path: | COPY |
+| MOVE | [apply tags]  | (path)      | <line,line>       | :destination path: | MOVE |
+| OPEN | [filter tags] | (log path)  | <result,result>   | :pattern:          | OPEN |
+| FOLD | [filter tags] | (log path)  | <result,result>   | :pattern:          | FOLD |
+| EXEC | [executor]    | (path)      | <timeout, poll>   | :code:             | EXEC |
+| KILL | [signal]      | (path)      | -                 | ::                 | KILL |
+| SEND | [status code] | (recipient) | -                 | :message:          | SEND |
+
+<<PLAN:concise plan goes here:PLAN is required at the beginning of a turn.
 <<FIND(path)::FIND returns rows of matching results
 <<READ(path)::READ returns lines of matching content. Every line is prefixed with the line number and a hard tab, `N:	`.
 <<EDIT(path):literal text:EDIT is only for adding or modifying files and entries. Do not attempt to edit log items.
@@ -115,7 +115,6 @@ Body content is character-perfect, exactly matching whitespace.
 ## Imperatives
 
 YOU MUST ONLY use EXEC for actions that can't be performed with other Plurnk OPs.
-YOU MUST distill, FOLD, or KILL log items as necessary to avoid and recover from active context Budget Overflow errors. Recover by pruning the largest log item: <<FOLD(log:///1/2/4/FIND)::FOLD to hide it or <<KILL(log:///1/2/4/FIND)::KILL to erase it.
 YOU SHOULD document all relevant questions and uncertainties into taxonomized, tagged, and topical unknown:/// entries.
 YOU SHOULD distill source information into taxonomized, tagged, and topical known:/// entries.
 
@@ -125,14 +124,21 @@ YOU MUST terminate the turn by SENDing a message to the user with the proper sta
 * 202: submit a hibernation turn with status code 202: <<SEND[202]:Awaiting streams and worker responses.:SEND
 * 499: submit a failed loop with status code 499: <<SEND[499]:Aborted: Unrecoverable internal error:SEND
 
-YOU MUST SEND[102] to receive the results of OPs you submitted. Avoid premature SEND[200].
-
 To spawn a separate run: <<COPY(run://capital-checker):List the capitals in: known:///continents/europe:COPY
 To fork the current run: <<COPY(run://self):Re-derive the capital from a primary source.:COPY
 
 ## Examples
 
 * <<FIND(config/**/*.xml)://user[@role='admin']:FIND
+* <<FIND(known:///**)<5>:~french revolutionary history:FIND
+* <<FIND(known:///**)<0.7>:~french territorial concessions:FIND
+* <<FIND(log:///**/error):#budget overflow|budget exceeded#i:FIND
+* <<FIND(known:///**):revolution:FIND
+* <<FIND(known:///**):$[?(@.role=="admin")]:FIND
+* <<FIND(#(draft|final)/.*#i)::FIND
+* <<FIND(#src/.*\.test\.ts#)::FIND
+* <<FIND(src/**):@<createCoder:FIND
+* <<FIND(**/notes.md)::FIND
 * <<READ(lang/??.json):$.greeting:READ
 * <<READ(plurnk://docs/sh.md):$.Environment:READ
 * <<READ(known:///guides/setup.md)://h2/text():READ
@@ -148,23 +154,14 @@ To fork the current run: <<COPY(run://self):Re-derive the capital from a primary
 * <<EDIT(known:///countries/france/capital.md)<-1>:[Wikipedia: Paris](https://en.wikipedia.org/wiki/Paris):EDIT
 * <<EDIT(known:///countries/france/capital.md)<1,-1>::EDIT
 * <<EDIT(known:///users.json)<0>:{"name":"Eve"}:EDIT
+* <<EDIT[tutorial,training,scripts](example.sh):echo "Maximize your Active Context signal/noise ratio." > advice.txt:EDIT
 * <<COPY[archive,2026-05-14](known:///draft.md):known:///archive/2026-05-14/draft.md:COPY
 * <<MOVE[final](known:///draft/answer.md):known:///final/answer.md:MOVE
+* <<OPEN(log:///**)<1,10>::OPEN
+* <<FOLD(log:///**)<101,200>::FOLD
 * <<KILL(known:///draft.md)::KILL
 * <<KILL(obsolete/file.md)::KILL
 * <<KILL(sh:///3/1/2)::KILL
 * <<KILL[9](sh:///3/1/3)::KILL
 * <<KILL(log:///1/*/*/FOLD)::KILL
-* <<OPEN(log:///**)<1,10>::OPEN
-* <<FIND(known:///**)<5>:~french revolutionary history:FIND
-* <<FIND(known:///**)<0.7>:~french territorial concessions:FIND
-* <<FOLD(log:///**)<101,200>::FOLD
-* <<FIND(log:///**/error):#budget overflow|budget exceeded#i:FIND
-* <<FIND(known:///**):revolution:FIND
-* <<FIND(known:///**):$[?(@.role=="admin")]:FIND
-* <<FIND(#(draft|final)/.*#i)::FIND
-* <<FIND(#src/.*\.test\.ts#)::FIND
-* <<FIND(src/**):@<createCoder:FIND
-* <<FIND(**/notes.md)::FIND
 * <<SEND(run://capital-checker):{"hint":"known entries are your persistent memory"}:SEND
-* <<EDIT[tutorial,training,scripts](example.sh):echo "Taxonomic path names and topical tags on files, entries, and items improve reasoning and recall!" > advice.txt:EDIT