@plurnk/plurnk-grammar 0.74.42 → 0.74.45

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plurnk/plurnk-grammar",
-  "version": "0.74.42",
+  "version": "0.74.45",
   "description": "ANTLR4 grammar for the Plurnk LLM agent protocol",
   "type": "module",
   "license": "MIT",
@@ -42,8 +42,10 @@
     "test:smoke": "node scriptify/smoke-test.ts",
     "test:llama": "node --test test/llama/*.test.ts",
     "test:all": "npm run test:lint && npm run test:unit && npm run test:intg && npm run test:demo",
-    "prepare": "npm run build",
-    "prepublishOnly": "npm run build && npm run test:all && npm run test:smoke"
+    "test": "npm run test:all",
+    "deps:fresh": "npm outdated",
+    "prepare": "git config core.hooksPath .githooks && npm run build",
+    "prepublishOnly": "npm run deps:fresh && npm audit && npm run build && npm run test:all && npm run test:smoke"
   },
   "dependencies": {
     "@cfworker/json-schema": "^4.1.1",

package/plurnk.md

@@ -15,12 +15,12 @@ YOU MUST ONLY use the Plurnk OPs (PLAN|FIND|READ|EDIT|COPY|MOVE|OPEN|FOLD|EXEC|K
 
 ### Syntax
 
-<<OPsuffix[signal]?(target)?<Line/Result>?:body?:OPsuffix
+<<OPsuffix[signal]?(path)?<Line/Result>?:body?:OPsuffix
 
 ### OPs
 
 Fields are optional unless otherwise specified.
-The `(target)` is required for every operation except PLAN, EXEC, and SEND.
+The `(path)` is required for every operation except PLAN, EXEC, and SEND.
 
 | OP   | `[signal]`    | `(path)`    | `<Line / Result>` | :body:                | OP   |
 |------|---------------|-------------|-------------------|-----------------------|------|
@@ -42,7 +42,7 @@ The `(target)` is required for every operation except PLAN, EXEC, and SEND.
 <<EDIT(path):literal text:EDIT is only for adding or modifying files and entries. Do not attempt to edit log items.
 <<EDIT(path):literal text:EDIT replaces the selected line(s) `<line,line>` with literal body content, never with patterns.
 <<OPEN(log path)::OPEN expands (`+`) the log item body to view it (costs tokens). Not all log items have a body (`*`).
-<<FOLD(log path)::FOLD hides (`-`) the log item body (saves tokens).
+<<FOLD(log path)::FOLD hides (`-`) the log item body (saves tokens). FOLDed item tokens="" shows token cost if OPENed.
 <<EXEC::EXEC produces output stream channels on the next turn that you can then FIND, READ, or KILL.
 <<KILL(path)::KILL deletes files and entries, erases log items, and kills streams.
 <<SEND[102]:doing:SEND to submit OPs, emit streams, or launch worker runs.
@@ -115,7 +115,7 @@ 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 optimize active context relevance within the token budget.
+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.
 
@@ -127,7 +127,7 @@ YOU MUST terminate the turn by SENDing a message to the user with the proper sta
 
 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):Find the capital of France.:COPY
+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
@@ -155,15 +155,16 @@ To fork the current run: <<COPY(run://self):Re-derive the capital from a primary
 * <<KILL(sh:///3/1/2)::KILL
 * <<KILL[9](sh:///3/1/3)::KILL
 * <<KILL(log:///1/*/*/FOLD)::KILL
-* <<OPEN(log:///**/get)<1,10>::OPEN
+* <<OPEN(log:///**)<1,10>::OPEN
 * <<FIND(known:///**)<5>:~french revolutionary history:FIND
 * <<FIND(known:///**)<0.7>:~french territorial concessions:FIND
-* <<FOLD(log:///**/get)<101,200>::FOLD
+* <<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