eyeling 1.27.1 → 1.27.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/HANDBOOK.md +9 -3
  2. package/package.json +1 -1
package/HANDBOOK.md CHANGED
@@ -359,7 +359,9 @@ eyeling -r --stream-messages rules.n3 large-message-log.trig
359
359
  eymsg:payloadGraph ?payload.
360
360
  ```
361
361
 
362
- The payload is still scoped behind `?payload log:nameOf { ... }`, so rules use the same `log:nameOf`/`log:includes` pattern as in whole-log replay. The important difference is lifetime: after one message has been parsed, reasoned over, and printed, its facts are discarded before the next message is read. Local files are scanned incrementally instead of first being normalized into one giant N3 document.
362
+ The payload is still scoped behind `?payload log:nameOf { ... }`, so rules use the same `log:nameOf`/`log:includes` pattern as in whole-log replay. The important difference is lifetime: after one message has been parsed, reasoned over, and printed, its facts are discarded before the next message is read. Local files are scanned incrementally instead of first being normalized into one giant N3 document. Remote HTTP(S) message logs are likewise detected from a small prefix and then spooled for streaming, rather than buffered as one large response.
363
+
364
+ The browser playground exposes the same idea through the RDF and stream-message toggles. In the playground, load extraction rules as background knowledge and put the RDF Message Log itself in the main editor. The detector accepts both `VERSION "1.2-messages"` / `MESSAGE` and `@version "1.1-messages" .` / `@message .` forms. When the stream-message toggle is enabled, each editor message is replayed separately against the background rules.
363
365
 
364
366
  This mode is meant for production-style message feeds such as MARC-record streams, telemetry streams, or LDES member logs where a consumer checkpoint already tells the application which messages are new. It deliberately does not expose `eymsg:nextEnvelope` links or a complete `eymsg:messageCount`, because those require holding global stream state. Use ordinary `eyeling -r` when your rules need global ordering, sliding windows across several messages, or proof output for the entire replay.
365
367
 
@@ -3842,10 +3844,14 @@ For an interactive reasoning environment, error behavior matters almost as much
3842
3844
 
3843
3845
  When an N3 syntax error occurs, the output pane shows the error with line and column information, and the editor highlights the offending line. This shortens the distance between the parser’s complaint and the place where the user needs to fix the program.
3844
3846
 
3845
- The playground also exposes two configuration toggles that are especially useful for explanation and browser safety:
3847
+ The playground also exposes configuration toggles that are especially useful for explanation, RDF compatibility, and browser safety:
3846
3848
 
3847
3849
  - **proof comments**, which make reasoning output more explanatory,
3848
- - **HTTPS dereferencing enforcement**, which helps avoid mixed-content problems when dereferencing from the browser.
3850
+ - **HTTPS dereferencing enforcement**, which helps avoid mixed-content problems when dereferencing from the browser,
3851
+ - **RDF/TriG compatibility**, which mirrors command-line `-r, --rdf` for RDF surface syntax and message-log replay,
3852
+ - **stream RDF Messages**, which mirrors `--stream-messages` under RDF mode and runs background rules over one editor message at a time.
3853
+
3854
+ For streamed RDF Messages in the playground, the main editor must contain the message log and the rules should be loaded as background knowledge. This keeps the interaction close to the command-line form `eyeling -r --stream-messages rules.n3 messages.trig` while preserving the playground's interactive editor/output loop.
3849
3855
 
3850
3856
  Together these choices make the playground better suited to live explanation, teaching, and debugging than a minimal browser wrapper would be.
3851
3857
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "eyeling",
3
- "version": "1.27.1",
3
+ "version": "1.27.2",
4
4
  "description": "A minimal Notation3 (N3) reasoner in JavaScript.",
5
5
  "main": "./index.js",
6
6
  "keywords": [