@plurnk/plurnk-grammar 0.49.0 → 0.54.0

package/README.md

@@ -170,7 +170,7 @@ Nesting: outer body may contain inner `<<OP:…:OP` statements; outer must use a
 	<<SEND[102](agent://supervisor):decomposition complete; awaiting clearance:SEND
 
 31. Kill a runaway process
-	<<KILL(exec:///3/1/2)::KILL
+	<<KILL(sh:///3/1/2)::KILL
 
 32. Permanently delete an entry
 	<<KILL(known:///obsolete/note)::KILL

package/dist/schema/ChannelContent.json

@@ -2,7 +2,7 @@
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schemas.plurnk.dev/v0/ChannelContent.json",
     "title": "ChannelContent",
-    "description": "One named stream of content on an entry. Channels carry distinct, parallel views of an entry (e.g. `stdout` and `stderr` on `exec://`; `body` and `headers` on `https://`; `body` and `symbols` on a code file). Each channel has its own content bytes, mimetype, and token count.",
+    "description": "One named stream of content on an entry. Channels carry distinct, parallel views of an entry (e.g. `stdout` and `stderr` on an executor scheme like `node://`/`sh://`; `body` and `headers` on `https://`; `body` and `symbols` on a code file). Each channel has its own content bytes, mimetype, and token count.",
     "type": "object",
     "required": ["content", "mimetype", "tokens"],
     "additionalProperties": false,

package/dist/schema/SchemeRegistration.json

@@ -18,7 +18,7 @@
         "default_channel": {
             "type": "string",
             "pattern": "^[a-z][a-z0-9_-]*$",
-            "description": "Channel name selected when an op against this scheme has no fragment. Conventionally `body`; exec schemes typically declare `stdout`."
+            "description": "Channel name selected when an op against this scheme has no fragment. Conventionally `body`; executor schemes (`{tag}://`) typically declare `stdout`."
         },
         "channel_orientations": {
             "type": "object",

package/dist/src/types.generated.d.ts

@@ -43,7 +43,7 @@ export interface SchemeRegistration {
     category: string;
     default_scope: ("agent" | "session");
     /**
-     * Channel name selected when an op against this scheme has no fragment. Conventionally `body`; exec schemes typically declare `stdout`.
+     * Channel name selected when an op against this scheme has no fragment. Conventionally `body`; executor schemes (`{tag}://`) typically declare `stdout`.
      */
     default_channel: string;
     /**
@@ -97,7 +97,7 @@ export interface Params {
     [k: string]: (string | string[]);
 }
 /**
- * One named stream of content on an entry. Channels carry distinct, parallel views of an entry (e.g. `stdout` and `stderr` on `exec://`; `body` and `headers` on `https://`; `body` and `symbols` on a code file). Each channel has its own content bytes, mimetype, and token count.
+ * One named stream of content on an entry. Channels carry distinct, parallel views of an entry (e.g. `stdout` and `stderr` on an executor scheme like `node://`/`sh://`; `body` and `headers` on `https://`; `body` and `symbols` on a code file). Each channel has its own content bytes, mimetype, and token count.
  */
 export interface LineMarker {
     /**

package/package.json

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

package/plurnk.md

@@ -61,12 +61,14 @@ On structured entries and items, `<Result>` addresses result index, not line num
 | leading prefix | dialect  | form                              |
 |----------------|----------|-----------------------------------|
 | `//`           | xpath    | `//selector`                      |
-| `#`            | regex    | `#pattern#[igmsu]?`               |
+| `#`            | regex    | `#pattern#[igmsu]*`               |
 | `$`            | jsonpath | `$.field`                         |
 | `~`            | semantic | `~phrase`                         |
 | `@`            | graph    | `@<symbol`, `@>symbol`, `@symbol` |
 | otherwise      | glob     | `pattern`                         |
 
+`$` and `//` address any entry with derivable structure (Markdown, HTML, source, …), not just native JSON/XML; `@` walks the code graph likewise.
+
 Escape `#` inside a regex pattern as `\#`. XPath body begins with `//`. Semantic search narrows top-K via `<Result>` on the host statement.
 
 ## Paths
@@ -74,20 +76,11 @@ Escape `#` inside a regex pattern as `\#`. XPath body begins with `//`. Semantic
 URI-shaped: `[scheme://]rest`.
 
 * Bare paths (no scheme) default to local relative project file paths (leading `/` for absolute path).
-* Glob metacharacters (`*`, `**`, `?`, `[...]`) and regex (`#pattern#flags`) are allowed in path segments.
+* Glob metacharacters (`*`, `**`, `?`, `[...]`) match within path segments; a standalone `#pattern#flags` matches the whole target by regex.
 * Path suffix (`.json`, `.md`, `.txt`, etc.) declares mimetype; absent suffix defers to scheme default.
+* A literal `)` closes the target; percent-encode parens in a path as `%28`/`%29` (e.g. `Mercury_%28planet%29`).
 * Append `#channel` to select a channel (e.g. `#stdout`, `#stderr`); absent, the scheme's default channel is used.
 
-Internal schemes:
-
-- `unknown:///` — internal open question entries.
-- `known:///` — internal knowledgebase entries.
-- `exec:///` — execution stream output. not editable.
-- `log:///` — record of operations performed, not editable.
-- `plurnk:///` — internal agent entries, not editable.
-- `run:///` — agent runs; `run:///.` is the current run.
-- `error:///` — rendered telemetry locator, not addressable or editable.
-
 ## Suffix
 
 When quoting plurnk operations in a body, YOU MUST use a matching single-digit suffix (`1`–`9`) on the opening and closing tags.
@@ -105,10 +98,10 @@ Body content is character-perfect, exactly matching whitespace.
 <<FIND(config/**/*.xml)://user[@role='admin']:FIND
 <<READ(lang/??.json):$.greeting:READ
 <<READ(README.md):$.Installation:READ
-<<READ(docs/api.md)://h2/text():READ
+<<READ(README.md)://h2/text():READ
 <<READ(plurnk:///manifest.json):$[?(@.channels.stderr)]:READ
 <<READ(log:///1/2/3):$[*].matched.codename:READ
-<<READ(exec:///3/1/2#stdout)<1,40>::READ
+<<READ(node:///3/1/2#stdout)<1,40>::READ
 <<READ(/etc/hosts)<2>::READ
 <<READ(https://en.wikipedia.org/wiki/Paris)<426,465>::READ
 <<EDIT[philosophy,existentialism](known:///philosophy/existentialism/meaning.md):The meaning of life is 42:EDIT
@@ -128,7 +121,7 @@ Body content is character-perfect, exactly matching whitespace.
 <<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
 <<KILL(obsolete/file.md)::KILL
-<<KILL(exec:///3/1/2)::KILL
+<<KILL(sh:///3/1/2)::KILL
 <<EDIT(run:///capital-check):Find the capital of France.:EDIT
 <<COPY(run:///.):Re-derive the capital from a primary source.:COPY
 <<OPEN(log:///**/get)<1,10>::OPEN
@@ -138,7 +131,7 @@ Body content is character-perfect, exactly matching whitespace.
 <<FIND(log:///**/error):#timeout|deadline exceeded#i:FIND
 <<FIND(known:///**):revolution:FIND
 <<FIND(#draft.*#i)::FIND
-<<FIND(#src/.*[.]test[.]ts#)::FIND
+<<FIND(#src/.*\.test\.ts#)::FIND
 <<FIND(src/**):@<createCoder:FIND
 
 <<EDIT[tutorial,training,scripts](example.sh):#!/usr/bin/env sh