Merge pull request #2 from runtimed/doc-updatews

clean up docs a bit

Author: rgbkrk

AGENTS.md

@@ -6,8 +6,8 @@ agent library.
 ## Project Overview
 
 Runt is a TypeScript/Deno library for building runtime agents that connect to
-Anode notebooks. It uses LiveStore for event-sourcing and real-time sync between
-multiple users.
+[Anode notebooks](https://github.com/rgbkrk/anode). It uses LiveStore for
+event-sourcing and real-time sync between multiple users.
 
 **Current Status**: Working system with 29 passing tests. Core functionality is
 implemented and published to JSR. The system is a working prototype with Python
@@ -110,7 +110,8 @@ not queried during materialization.
 **Import errors**: Make sure all imports use the workspace aliases
 (`@runt/schema`, `@runt/lib`) or relative paths correctly.
 
-**Test permissions**: Tests need `--allow-env --allow-net --allow-read` flags.
+**Test permissions**: Tests need
+`--allow-env --allow-net --allow-read --allow-write --allow-sys` flags.
 
 **Publishing**: Requires `--allow-slow-types` flag due to LiveStore's complex
 types.
@@ -124,9 +125,8 @@ don't return data from the execution handler.
 - **Integration tests**: Cross-package interactions in `test/`
 - **Example tests**: Ensure examples work in `examples/`
 
-Run tests with: `deno test --allow-env --allow-net --allow-read`
-
-Current test count: 29 passing, 0 failing
+Run tests with:
+`deno test --allow-env --allow-net --allow-read --allow-write --allow-sys`
 
 ## Dependencies
 

README.md

@@ -1,26 +1,14 @@
 # Runt
 
-Runtime agents for connecting to notebooks. Deno/TypeScript prototype using
-LiveStore for event-sourcing and real-time sync.
-
-Working system with end-to-end Python execution. Deno/TypeScript prototype.
+Runtime agents for connecting to next gen notebooks from
+[Anode](https://github.com/rgbkrk/anode).
 
 ## Packages
 
 - `@runt/schema` - LiveStore schema (events, tables, types)
 - `@runt/lib` - Runtime agent base class
 - `@runt/pyodide-runtime-agent` - Python runtime using Pyodide
 
-## Status
-
-What works:
-
-- Python code execution via Pyodide
-- Jupyter-compatible outputs (stdout, stderr, rich displays)
-- LiveStore event-sourcing and sync
-- CLI configuration
-- Real-time collaboration
-
 ## Usage
 
 ```bash

packages/lib/README.md

@@ -1,7 +1,7 @@
 # @runt/lib
 
-Runtime agent base class. Connects to LiveStore, processes execution queues,
-handles outputs.
+Runtime agent base class. Connects to [Anode](https://github.com/rgbkrk/anode),
+processes execution queues, handles outputs.
 
 ## Usage
 
@@ -37,7 +37,7 @@ await agent.keepAlive();
 
 ```bash
 --notebook <id>           # Required
---auth-token <token>      # Required  
+--auth-token <token>      # Required
 --kernel-type <type>      # Optional
 --sync-url <url>          # Optional
 ```

packages/pyodide-runtime-agent/README.md

@@ -2,11 +2,13 @@
 
 Python runtime using Pyodide. Prototype implementation with IPython integration.
 
+Goes well beyond the initial [Anode](https://github.com/rgbkrk/anode) runtime implementation (for Python at least...).
+
 ## Usage
 
 ```typescript
 import { PyodideRuntimeAgent } from "@runt/pyodide-runtime-agent";
-const agent = new PyodideRuntimeAgent(Deno.args);
+const agent = new PyodideRuntimeAgent(Deno.args); // presuming we got --notebook=NOTEBOOK_ID, etc.
 await agent.start();
 await agent.keepAlive();
 ```
@@ -16,7 +18,7 @@ Works:
 - Python execution via Pyodide
 - Rich outputs (HTML, pandas tables, matplotlib SVG)
 - IPython display system
-- Essential packages pre-loaded
+- Basic Scientific computing stack pre-loaded
 - Code interruption
 
 CLI: `--notebook <id> --auth-token <token>` (required)
@@ -31,9 +33,9 @@ Notes:
 ## Pre-loaded Packages
 
 Data: numpy, pandas, polars, pyarrow, duckdb
-Viz: matplotlib, bokeh, altair\
+Viz: matplotlib, bokeh, altair
 Science: scipy, sympy, scikit-learn, statsmodels
-Utils: requests, rich, beautifulsoup4, pillow, geopandas, networkx
+Misc: requests, rich, beautifulsoup4, pillow, geopandas, networkx
 
 ## Example
 

packages/schema/README.md

@@ -1,6 +1,6 @@
 # @runt/schema
 
-LiveStore schema for notebooks. Events, tables, and types.
+LiveStore schema for anode notebooks. Events, tables, and types.
 
 ```typescript
 import { events, schema, tables } from "jsr:@runt/schema";