@plurnk/plurnk-grammar 0.17.0 → 0.18.1

package/README.md

@@ -179,6 +179,20 @@ Errors are JSON-serializable. Shape: `{ line, column, source, message }` where `
 
 [SPEC.md](SPEC.md) — full grammar specification: canonical form, per-OP semantics, matcher dialects, path decomposition, error model, whitespace rules, implementation notes.
 
+## ecosystem
+
+The `@plurnk/*` ecosystem pins peer versions exactly — no caret, no tilde, no ranges:
+
+```json
+"@plurnk/plurnk-grammar": "0.18.0"
+```
+
+Greenfield, single-orchestrator-per-repo, closed ecosystem. Determinism beats flexibility at this stage: when versions drift, the npm install error tells you which package needs a release. Silent semver wiggling masks coordination gaps that surface as mystery failures later.
+
+Every grammar release cascades: every consuming package (`plurnk-providers`, `plurnk-schemes`, `plurnk-execs`, `plurnk-mimetypes`, `plurnk-service`, ...) bumps its pin and publishes a patch, then top-level consumers (`plurnk-service`, `plurnk`) bump theirs. Skipping a step = broken install downstream.
+
+Not permanent — at v1 stabilization the policy widens back to semver ranges.
+
 ## license
 
 MIT.

package/dist/src/index.d.ts

@@ -6,5 +6,5 @@ export { default as RecordingListener } from "./RecordingListener.ts";
 export { default as Validator } from "./Validator.ts";
 export type { ValidationResult } from "./Validator.ts";
 export type { ErrorSource } from "./PlurnkParseError.ts";
-export type { CopyStatement, EditStatement, ExecStatement, FindStatement, HideStatement, LineMarker, LocalPath, MatcherBody, MoveStatement, ParseItem, ParseResult, ParsedPath, PlurnkOp, PlurnkStatement, Position, ReadStatement, SendBody, SendStatement, ShowStatement, UrlPath, } from "./types.ts";
+export type { ContentOffset, CopyStatement, EditStatement, ExecStatement, FindStatement, HideStatement, LineMarker, LocalPath, LogCoordinate, MatcherBody, MoveStatement, ParseItem, ParseResult, ParsedPath, PlurnkOp, PlurnkStatement, Position, ReadStatement, SendBody, SendStatement, ShowStatement, TelemetryEvent, UrlPath, } from "./types.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EACR,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,SAAS,EACT,WAAW,EACX,aAAa,EACb,SAAS,EACT,WAAW,EACX,UAAU,EACV,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,aAAa,EACb,aAAa,EACb,OAAO,GACV,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EACR,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,SAAS,EACT,aAAa,EACb,WAAW,EACX,aAAa,EACb,SAAS,EACT,WAAW,EACX,UAAU,EACV,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,aAAa,EACb,aAAa,EACb,cAAc,EACd,OAAO,GACV,MAAM,YAAY,CAAC"}

package/package.json

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

package/plurnk.md

@@ -53,7 +53,7 @@ Escape `/` inside a regex pattern as `\/`. XPath body begins with `//`.
 
 URI-shaped: `[scheme://]rest`.
 
-* Bare paths (no scheme) default to local relative project file paths (leader `/` for absolute path).
+* Bare paths (no scheme) default to local relative project file paths (leading `/` for absolute path).
 * Glob metacharacters (`*`, `**`, `?`, `[...]`) are allowed in path segments.
 * Path suffix (`.json`, `.md`, `.txt`, etc.) declares mimetype; absent suffix defers to scheme default.
 
@@ -65,6 +65,7 @@ Internal schemes:
 - `exec://` — actions.
 - `log://` — record of operations performed.
 - `plurnk://` — internal agent entries.
+- `error://` — rendered telemetry locator, not addressable.
 
 ## Context
 
@@ -73,6 +74,8 @@ The agent maintains two contexts for budgeting tokens for working memory and ava
 - **Index** — entries listed in the active index.
 - **Archive** — entries archived; out of working memory (HIDE), but promotable (SHOW) by path or pattern lookup.
 
+Index entries are previews; READ pulls the body (full, ranged, or matcher-filtered). `plurnk://manifest.json` is the full directory across both contexts.
+
 `SHOW` promotes matching entries to the active index and spends tokens.
 `HIDE` demotes matching entries to archive and saves tokens.
 
@@ -96,6 +99,7 @@ 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(plurnk://manifest.json):$[?(@.shown==false)]:READ
 <<READ(log://1/2/3):$[*].matched.codename:READ
 <<READ(https://en.wikipedia.org/wiki/Paris)<426,465>::READ
 <<EDIT[philosophy,existentialism](known://philosophy/existentialism/meaning):The meaning of life is 42:EDIT