pico-engine 1.9.0 → 1.9.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.
- package/README.md +2 -2
- package/dist/xmluiRuntime.js +1 -1
- package/krl/io.picolabs.pico-engine-ui.krl +2 -0
- package/krl/io.picolabs.wrangler.krl +7 -1
- package/krl/io.picolabs.xmlui.krl +19 -7
- package/mcp/devResources.js +17 -7
- package/mcp/docs/CLAUDE.md +85 -0
- package/{public → mcp}/docs/pico-engine.md +8 -8
- package/package.json +6 -6
- package/public/pico-engine-ui.css +1 -1
- package/public/pico-engine-ui.js +24 -24
- package/public/xmlui/0.14.28.js +171 -0
- package/public/xmlui/pico-view-boot.js +1 -1
- package/src/xmluiRuntime.ts +1 -1
- package/public/.DS_Store +0 -0
- package/public/docs/README.md +0 -9
- package/public/docs/_media/logo.png +0 -0
- package/public/docs/_sidebar.md +0 -7
- package/public/docs/contributing.md +0 -64
- package/public/docs/favicon.ico +0 -0
- package/public/docs/index.html +0 -29
- package/public/docs/krl/README.md +0 -3
- package/public/docs/krl/_sidebar.md +0 -10
- package/public/docs/krl/discovery.md +0 -144
- package/public/docs/krl/modules/ctx.md +0 -151
- package/public/docs/krl/modules/event.md +0 -70
- package/public/docs/krl/modules/http.md +0 -42
- package/public/docs/krl/modules/math.md +0 -5
- package/public/docs/krl/modules/schedule.md +0 -5
- package/public/docs/krl/modules.md +0 -11
- package/public/docs/krl/rulesets.md +0 -81
- package/public/docs/krl/stdlib.md +0 -3
- package/public/docs/llms-full.txt +0 -630
- package/public/docs/llms.txt +0 -38
- package/public/docs/openapi.yaml +0 -78
- package/public/docs/pico-views-xmlui.md +0 -5
- package/public/docs/pico-views.md +0 -140
- package/public/docs/pico.md +0 -5
- package/public/docs/rulesets/README.md +0 -26
- package/public/docs/rulesets/io.picolabs.oauth.md +0 -71
- package/public/docs/rulesets/io.picolabs.pds.md +0 -327
- package/public/docs/rulesets/io.picolabs.pico-engine-ui.md +0 -65
- package/public/docs/rulesets/io.picolabs.portable_subtree.md +0 -94
- package/public/docs/rulesets/io.picolabs.subscription.md +0 -398
- package/public/docs/rulesets/io.picolabs.wrangler.md +0 -471
- /package/{public → mcp}/docs/pico-overview.md +0 -0
package/README.md
CHANGED
|
@@ -11,9 +11,9 @@ npm install -g pico-engine
|
|
|
11
11
|
pico-engine
|
|
12
12
|
```
|
|
13
13
|
|
|
14
|
-
Open `http://localhost:3000` — a root pico and UI channel are created on first run. Operator settings (port, data dir, policy ceiling) live in **`~/.config/pico-engine/config.json`**; copy [`config.example.json`](config.example.json). See [`
|
|
14
|
+
Open `http://localhost:3000` — a root pico and UI channel are created on first run. Operator settings (port, data dir, policy ceiling) live in **`~/.config/pico-engine/config.json`**; copy [`config.example.json`](config.example.json). See [`docs/pico-engine.md`](../../docs/pico-engine.md) (published at https://docs.picolabs.io/).
|
|
15
15
|
|
|
16
|
-
**Agents (local dev):** [`CLAUDE.md`](../../CLAUDE.md) at repo root + `pico-engine mcp --stdio` (stdio MCP to the same engine). Machine-readable docs: [`
|
|
16
|
+
**Agents (local dev):** [`CLAUDE.md`](../../CLAUDE.md) at repo root + `pico-engine mcp --stdio` (stdio MCP to the same engine). Machine-readable docs: [`docs/llms.txt`](../../docs/llms.txt).
|
|
17
17
|
|
|
18
18
|
## Getting Started
|
|
19
19
|
|
package/dist/xmluiRuntime.js
CHANGED
|
@@ -8,7 +8,7 @@ exports.isXmluiSpaClientRoute = isXmluiSpaClientRoute;
|
|
|
8
8
|
exports.viewQueryNameForComponent = viewQueryNameForComponent;
|
|
9
9
|
exports.contentTypeForUiPath = contentTypeForUiPath;
|
|
10
10
|
/** Pinned XMLUI standalone runtime shipped under `public/xmlui/`. */
|
|
11
|
-
exports.XMLUI_RUNTIME_VERSION = "0.
|
|
11
|
+
exports.XMLUI_RUNTIME_VERSION = "0.14.28";
|
|
12
12
|
exports.XMLUI_RUNTIME_PUBLIC_PATH = `/xmlui/${exports.XMLUI_RUNTIME_VERSION}.js`;
|
|
13
13
|
/** XMLUI standalone always requests Main.xmlui.xs (and per-component .xmlui.xs). */
|
|
14
14
|
exports.XMLUI_EMPTY_CODE_BEHIND = "var __pico_xmlui_codebehind = 0;\n";
|
|
@@ -388,6 +388,8 @@ ruleset io.picolabs.pico-engine-ui {
|
|
|
388
388
|
// url from pico(){"rulesets"}, so it is exactly the installed ruleset's url.
|
|
389
389
|
// (Previously the rid was parsed out of the url, which never matched —
|
|
390
390
|
// substr(0, 11) is "io.picolabs" without the dot — and truncated dotted rids.)
|
|
391
|
+
// install_ruleset_absolutely raises ruleset_installed only for a new rid, so
|
|
392
|
+
// this reinstall does not look like a first install.
|
|
391
393
|
rule reinstall_after_flush {
|
|
392
394
|
select when engine_ui flush_succeeded
|
|
393
395
|
pre {
|
|
@@ -625,7 +625,9 @@ ruleset io.picolabs.wrangler {
|
|
|
625
625
|
/**
|
|
626
626
|
* Install (or reinstall) a ruleset from a URL on this pico. The URL is fetched
|
|
627
627
|
* and compiled first, so this also picks up a new version. Raises
|
|
628
|
-
* wrangler:ruleset_installed with the installed rid
|
|
628
|
+
* wrangler:ruleset_installed with the installed rid only when that rid was
|
|
629
|
+
* not already on this pico. A flush reinstalls the source and does not
|
|
630
|
+
* raise it.
|
|
629
631
|
* @attr url String "URL of the .krl file"
|
|
630
632
|
* @attr config Map optional "configuration for the installed ruleset"
|
|
631
633
|
* @example "from a URL" { "url": "https://example.com/krl/<rid>.krl" }
|
|
@@ -642,6 +644,9 @@ ruleset io.picolabs.wrangler {
|
|
|
642
644
|
validate_errors = validation{"errors"}
|
|
643
645
|
validate_warnings = validation{"warnings"}
|
|
644
646
|
validate_rid = validation{"rid"}
|
|
647
|
+
already_installed = ctx:rulesets.filter(function(rs) {
|
|
648
|
+
rs{"rid"} == validate_rid
|
|
649
|
+
}).length() > 0
|
|
645
650
|
}
|
|
646
651
|
if ok then every {
|
|
647
652
|
ctx:flush(url=url)
|
|
@@ -650,6 +655,7 @@ ruleset io.picolabs.wrangler {
|
|
|
650
655
|
fired {
|
|
651
656
|
raise wrangler event "ruleset_installed" attributes
|
|
652
657
|
event:attrs.put({"rids": [rid]})
|
|
658
|
+
if not already_installed
|
|
653
659
|
}
|
|
654
660
|
else {
|
|
655
661
|
raise wrangler event "ruleset_install_failed" attributes
|
|
@@ -11,7 +11,7 @@ ruleset io.picolabs.xmlui {
|
|
|
11
11
|
}
|
|
12
12
|
|
|
13
13
|
global {
|
|
14
|
-
xmluiRuntimeVersion = "0.
|
|
14
|
+
xmluiRuntimeVersion = "0.14.28"
|
|
15
15
|
xmluiFileRid = "io.picolabs.xmlui"
|
|
16
16
|
|
|
17
17
|
xmluiRuntimePath = function() {
|
|
@@ -85,10 +85,20 @@ ruleset io.picolabs.xmlui {
|
|
|
85
85
|
" />"
|
|
86
86
|
}
|
|
87
87
|
|
|
88
|
+
// A channel matches when it has every requested tag. Extra tags, such as
|
|
89
|
+
// oauth-webhook on the app channel, still match.
|
|
88
90
|
newestChannelWithTags = function(tags) {
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
91
|
+
wanted = tags.typeof() == "Array" => tags.map(function(t) { t.lc() }) |
|
|
92
|
+
tags.typeof() == "String" => tags.lc().split(",") |
|
|
93
|
+
[]
|
|
94
|
+
wrangler:channels()
|
|
95
|
+
.filter(function(c) {
|
|
96
|
+
have = c{"tags"}.defaultsTo([]).map(function(t) { t.lc() })
|
|
97
|
+
wanted.filter(function(t) { have >< t }).length() == wanted.length()
|
|
98
|
+
})
|
|
99
|
+
.sort(function(a, b) { a{"id"} cmp b{"id"} })
|
|
100
|
+
.reverse()
|
|
101
|
+
.head()
|
|
92
102
|
}
|
|
93
103
|
|
|
94
104
|
app_url = function(tags, app_rid) {
|
|
@@ -252,10 +262,12 @@ ruleset io.picolabs.xmlui {
|
|
|
252
262
|
"<NavPanel>" + navLinksForApp(app_rid, multiView) + "</NavPanel>"
|
|
253
263
|
}
|
|
254
264
|
|
|
255
|
-
// XMLUI
|
|
256
|
-
//
|
|
265
|
+
// XMLUI's default layout, condensed-sticky, mis-measures header height in
|
|
266
|
+
// WebKit (Safari) and can hide page content. Do not add
|
|
267
|
+
// scrollWholePage="false": in XMLUI 0.14 it makes each Table header as tall
|
|
268
|
+
// as the table, which hides every row.
|
|
257
269
|
shellAppAttrs = function() {
|
|
258
|
-
" layout=\"vertical-sticky\"
|
|
270
|
+
" layout=\"vertical-sticky\""
|
|
259
271
|
}
|
|
260
272
|
|
|
261
273
|
mainXmlui = function(app_rid) {
|
package/mcp/devResources.js
CHANGED
|
@@ -3,8 +3,12 @@
|
|
|
3
3
|
const fs = require("fs");
|
|
4
4
|
const path = require("path");
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
|
|
6
|
+
// Docs live at the repo root (docs/, CLAUDE.md). In a checkout, read them there;
|
|
7
|
+
// in an npm install, read the copies `npm pack` bundled into mcp/docs/.
|
|
8
|
+
const repoRoot = path.join(__dirname, "..", "..", "..");
|
|
9
|
+
const bundledDir = path.join(__dirname, "docs");
|
|
10
|
+
|
|
11
|
+
function readFile(filePath) {
|
|
8
12
|
try {
|
|
9
13
|
return fs.readFileSync(filePath, "utf8");
|
|
10
14
|
} catch (_e) {
|
|
@@ -12,6 +16,13 @@ function readDoc(relativeFromPackage) {
|
|
|
12
16
|
}
|
|
13
17
|
}
|
|
14
18
|
|
|
19
|
+
function readDoc(relativeFromRepoRoot) {
|
|
20
|
+
return (
|
|
21
|
+
readFile(path.join(repoRoot, relativeFromRepoRoot)) ||
|
|
22
|
+
readFile(path.join(bundledDir, path.basename(relativeFromRepoRoot)))
|
|
23
|
+
);
|
|
24
|
+
}
|
|
25
|
+
|
|
15
26
|
function registerDevResources(server, client) {
|
|
16
27
|
server.resource(
|
|
17
28
|
"krl-conventions",
|
|
@@ -25,7 +36,7 @@ function registerDevResources(server, client) {
|
|
|
25
36
|
{
|
|
26
37
|
uri: "pico://docs/krl-conventions",
|
|
27
38
|
mimeType: "text/markdown",
|
|
28
|
-
text: readDoc("
|
|
39
|
+
text: readDoc("CLAUDE.md"),
|
|
29
40
|
},
|
|
30
41
|
],
|
|
31
42
|
})
|
|
@@ -44,8 +55,7 @@ function registerDevResources(server, client) {
|
|
|
44
55
|
uri: "pico://docs/pico-overview",
|
|
45
56
|
mimeType: "text/markdown",
|
|
46
57
|
text:
|
|
47
|
-
readDoc("
|
|
48
|
-
readDoc("../../../docs/design/pico-overview.md"),
|
|
58
|
+
readDoc("docs/pico-overview.md"),
|
|
49
59
|
},
|
|
50
60
|
],
|
|
51
61
|
})
|
|
@@ -63,7 +73,7 @@ function registerDevResources(server, client) {
|
|
|
63
73
|
{
|
|
64
74
|
uri: "pico://docs/pico-engine",
|
|
65
75
|
mimeType: "text/markdown",
|
|
66
|
-
text: readDoc("
|
|
76
|
+
text: readDoc("docs/pico-engine.md"),
|
|
67
77
|
},
|
|
68
78
|
],
|
|
69
79
|
})
|
|
@@ -93,7 +103,7 @@ function registerDevResources(server, client) {
|
|
|
93
103
|
schemaBlock = `\n\n(Could not load channel schema: ${String(err)})\n`;
|
|
94
104
|
}
|
|
95
105
|
}
|
|
96
|
-
const conventions = readDoc("
|
|
106
|
+
const conventions = readDoc("CLAUDE.md");
|
|
97
107
|
return {
|
|
98
108
|
messages: [
|
|
99
109
|
{
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
# pico-engine — guide for coding agents
|
|
2
|
+
|
|
3
|
+
This is the **pico engine**: an open-source Node.js runtime for **picos** (persistent compute objects) — small, always-on actors with persistent identity, state, and availability that talk by events and queries. Behavior is written in **KRL** (the pico rules language), compiled to JavaScript. Read `docs/design/pico-overview.md` first if the model isn't in your head yet.
|
|
4
|
+
|
|
5
|
+
Lerna mono-repo. Current release line: 1.9.0 (`docs/release/1.9.0.md`).
|
|
6
|
+
|
|
7
|
+
## The one rule that governs all design: strict layering
|
|
8
|
+
|
|
9
|
+
```
|
|
10
|
+
engine ← primitives only (channels, events, persistence, DIDs, schema). Knows nothing about Manifold.
|
|
11
|
+
wrangler ← the "pico OS": wraps primitives in KRL functions/events (children, channels, relationships).
|
|
12
|
+
manifold ← framework for pico meshes; supplies the vocabulary (owner, thing, community). Separate repo.
|
|
13
|
+
apps ← sensor-network, Fuse, … built on Manifold.
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
Engine and wrangler stay **domain-agnostic**. If a change needs the words "owner", "thing", or "community" in engine or wrangler code, it belongs in `manifold-api` instead. Picos are **actors**, not "agents"; say pico/actor in docs and code.
|
|
17
|
+
|
|
18
|
+
## Layout
|
|
19
|
+
|
|
20
|
+
| Path | What |
|
|
21
|
+
|------|------|
|
|
22
|
+
| `packages/pico-engine` | The npm package people install; HTTP server, CLI, auth/OAuth, identity, UI host |
|
|
23
|
+
| `packages/pico-engine-core` | Executes compiled KRL; event lifecycle |
|
|
24
|
+
| `packages/krl-parser` → `krl-compiler` → `krl-generator` | KRL → AST → JS; AST → KRL |
|
|
25
|
+
| `packages/krl-stdlib` | KRL standard library |
|
|
26
|
+
| `packages/pico-engine-ui` | Default web UI (`npm run build` at repo root includes its bundle in `public/`) |
|
|
27
|
+
| `docs/` (top level) | **User-facing docs** (pico, pico-engine, KRL manual, discovery): Docsify site published to GitHub Pages (https://docs.picolabs.io/). `docs/design`, `docs/release`, `docs/guides` are developer docs alongside it. The dev MCP server's doc resources are copied into the package at `npm pack` (`packages/pico-engine/scripts/bundle-docs.js`) |
|
|
28
|
+
| `docs/design/` | Design docs (schemas, identity, move, relationships, harness) |
|
|
29
|
+
| `docs/release/` | Per-release plans (`1.8.md`) and notes (`1.7.0.md`) |
|
|
30
|
+
| `MEMORY.md` | Long-running working log: roadmap, decisions, gotchas. Source of truth for *why*; skim the TOC |
|
|
31
|
+
| `test-rulesets/`, `demos/` | KRL used by tests and demos |
|
|
32
|
+
|
|
33
|
+
Sibling repos (same org, not in this tree): `manifold-api` (Manifold KRL), `sensor-network`, `MCPforEXP`, `pico-framework` (lifecycle/channels/LevelDB; engine depends on `^0.8.2` for 1.8 policy ceiling).
|
|
34
|
+
|
|
35
|
+
## Commands
|
|
36
|
+
|
|
37
|
+
```sh
|
|
38
|
+
npm run setup # NOT `npm i` — lerna links packages
|
|
39
|
+
npm start # dev engine with watch (cd packages/pico-engine && npm start)
|
|
40
|
+
npm run build # all packages with a build script (parser, stdlib, core, engine, UI → public/)
|
|
41
|
+
npm test # lerna run test (ava); Node 20/22 — Node 24 breaks krl-parser timeouts
|
|
42
|
+
cd packages/pico-engine && npm run test:layer2-policy # focused suites: see package.json scripts
|
|
43
|
+
cd packages/pico-engine-ui && npm run dev # Vite dev server (optional; root build updates public/ bundle)
|
|
44
|
+
echo 'ruleset x { … }' | npx krl-compiler # KRL → JS on stdout (no diagnostics mode yet; 1.8 adds `krl check`)
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
Env vars: `PORT`, `PICO_ENGINE_HOME`, `PICO_ENGINE_BASE_URL` and others — `pico-engine --help`, full registry in `MEMORY.md` ("Engine environment variables").
|
|
48
|
+
|
|
49
|
+
## KRL conventions (engine behavior — these are not style preferences)
|
|
50
|
+
|
|
51
|
+
Rule shape:
|
|
52
|
+
```krl
|
|
53
|
+
rule name {
|
|
54
|
+
select when domain type
|
|
55
|
+
pre { x = event:attr("x") } // NAME DECLARATIONS, not assignment; no re-binding
|
|
56
|
+
if cond then every { action1(); action2() } // ONE action block; no action-level else
|
|
57
|
+
fired { ent:things{[id, "name"]} := x; raise domain event "next" attributes {...} }
|
|
58
|
+
else { error warn <<skipped: …>> } // optional; runs when the rule did NOT fire
|
|
59
|
+
}
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
| Do | Don't |
|
|
63
|
+
|----|-------|
|
|
64
|
+
| One action block, `every { }` for several actions | Two `if … then` blocks, or `else` on the action |
|
|
65
|
+
| One postlude: `always` / `fired` / `notfired`, optional `else`, optional `finally` | `fired { } notfired { }` as two blocks |
|
|
66
|
+
| `event:send(...)` in the action block | `event:send` inside `fired` |
|
|
67
|
+
| Composite path for nested entity keys: `ent:m{[a, "b"]} := v` | Chained paths `ent:m{a}{"b"} := v` (parse error) |
|
|
68
|
+
| Path assignment `ent:m{k} := v` | `ent:m := ent:m.put([k], v)` |
|
|
69
|
+
| Direct path reads in `pre`: `n = ent:p{rcn}{"name"} \|\| event:attr("name")` | Refining a binding by re-declaring it |
|
|
70
|
+
| Chain multi-step setup with **events + callbacks** (`callback_eci`, `rcn`) | `schedule … at time:add(...)` to wait for work to finish |
|
|
71
|
+
| Wrangler for lifecycle: channels, children, rulesets, `wrangler:picoQuery` | `ctx:*` from application or demo rulesets (engine escape hatch) |
|
|
72
|
+
| `raise wrangler event "child_deletion_request" attributes {"eci": picoId}` | legacy `wrangler child_deletion` with `{"id": …}` (never runs) |
|
|
73
|
+
| `wrangler:picoQuery` (works over family channels) | `wrangler:skyQuery` (deprecated; HTTP blocked on family channels) |
|
|
74
|
+
|
|
75
|
+
Also: `if X then noop(); fired { … }` runs `fired` when X is **true**. Rules in one ruleset selecting the same event run in **rule-name lexicographic order**; across rulesets the order is undefined. A stray character after `meta { }` silently prevents registration — if a ruleset never seems to run, check it actually loaded.
|
|
76
|
+
|
|
77
|
+
Terminology: **relationships** (1.6.2+; "subscriptions" in older code and docs). Channels have **ECIs** and **policies**; policy is the authorization gate. Every pico has a `discovery` channel.
|
|
78
|
+
|
|
79
|
+
## Working in this repo
|
|
80
|
+
|
|
81
|
+
- Design before code for anything touching identity, policy, schema, or the Sky API: add or update a doc in `docs/design/` and link it from `MEMORY.md`.
|
|
82
|
+
- Keep `MEMORY.md` current when you learn an engine behavior the hard way; it is what future sessions read.
|
|
83
|
+
- Don't commit or publish; leave that to the maintainer. `npm run publish` builds and publishes every package — never run it.
|
|
84
|
+
- Tests are ava, serial for engine suites (`--serial`, 2–3 min timeouts). Add a focused `test:*` script when you add a suite.
|
|
85
|
+
- UI changes need `npm run build` (repo root) or `npm run dev` in `pico-engine-ui` or they won't appear in `public/`.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# pico-engine — operator guide
|
|
2
2
|
|
|
3
|
-
This document is the **canonical operator reference** for running and configuring the pico engine. It
|
|
3
|
+
This document is the **canonical operator reference** for running and configuring the pico engine. It lives in the repo's top-level `docs/`, is published at <https://docs.picolabs.io/>, and is indexed in [`llms.txt`](llms.txt).
|
|
4
4
|
|
|
5
5
|
**New to picos?** Read [pico-overview.md](pico-overview.md) — what picos are, why they exist, and the event-query model (`docs/design/pico-overview.md` in the repo).
|
|
6
6
|
|
|
@@ -8,10 +8,10 @@ This document is the **canonical operator reference** for running and configurin
|
|
|
8
8
|
|
|
9
9
|
| Location | Role |
|
|
10
10
|
|----------|------|
|
|
11
|
-
| **This file** (`
|
|
11
|
+
| **This file** (`docs/pico-engine.md`) | Authoritative for install, config, security flags, and deployment. Versioned with the engine; bundled into the npm package for the dev MCP server, so it's what agents read. |
|
|
12
12
|
| **README** in the same package | Quick start, CLI overview, OAuth, containers — links here for config details. |
|
|
13
13
|
| **`MEMORY.md`** (engine repo) | Maintainer log: rationale, gotchas, env registry — not end-user docs. |
|
|
14
|
-
| **Confluence / wiki** | Optional mirror for Picolab internal use. **Do not treat Confluence as primary:** edit this file in git first, then update Confluence to match (or replace Confluence pages with a short blurb + link to [
|
|
14
|
+
| **Confluence / wiki** | Optional mirror for Picolab internal use. **Do not treat Confluence as primary:** edit this file in git first, then update Confluence to match (or replace Confluence pages with a short blurb + link to [`docs/pico-engine.md`](https://github.com/Picolab/pico-engine/blob/master/docs/pico-engine.md) on `master` or the release tag). |
|
|
15
15
|
|
|
16
16
|
If Confluence and this guide disagree, **trust the repo at the release you run** (`pico-engine --version`).
|
|
17
17
|
|
|
@@ -30,7 +30,7 @@ Copy the example config and adjust paths:
|
|
|
30
30
|
|
|
31
31
|
```sh
|
|
32
32
|
mkdir -p ~/.config/pico-engine
|
|
33
|
-
cp "$(npm root -g)/pico-engine/config.example.json ~/.config/pico-engine/config.json
|
|
33
|
+
cp "$(npm root -g)/pico-engine/config.example.json" ~/.config/pico-engine/config.json
|
|
34
34
|
# or from a git checkout: packages/pico-engine/config.example.json
|
|
35
35
|
pico-engine
|
|
36
36
|
```
|
|
@@ -163,7 +163,7 @@ If something you need **cannot be done through wrangler**:
|
|
|
163
163
|
|
|
164
164
|
Install optional rulesets from the **Rulesets** tab (URL like `https://your-engine/krl/io.picolabs.oauth.krl`) or send `wrangler:install_ruleset_request`.
|
|
165
165
|
|
|
166
|
-
**Generated API docs** (events, queries, `@example` from KRL annotations) live under **[rulesets/](rulesets/README.md)** — notably [wrangler](rulesets/io.picolabs.wrangler.md). Refresh in a git checkout: `npm run check:krl-schema-samples` then **`npm run generate:llms`** (copies samples into `
|
|
166
|
+
**Generated API docs** (events, queries, `@example` from KRL annotations) live under **[rulesets/](rulesets/README.md)** — notably [wrangler](rulesets/io.picolabs.wrangler.md). Refresh in a git checkout: `npm run check:krl-schema-samples` then **`npm run generate:llms`** (copies samples into `docs/rulesets/`).
|
|
167
167
|
|
|
168
168
|
---
|
|
169
169
|
|
|
@@ -193,7 +193,7 @@ Install **`io.picolabs.manifold_bootstrap`** on the engine root to stand up the
|
|
|
193
193
|
- **Deny overrides permit** on channel policies (pico-framework 0.8.2+).
|
|
194
194
|
- **Policy ceiling:** parent can cap child channel policies; optional `defaultRootPolicyCeiling` on the root.
|
|
195
195
|
- **Wildcard channels:** opt-in `wildcardSkyRequireBearer` so wide `/sky/*` access requires a validated bearer.
|
|
196
|
-
- **Channel policy audit:** [channel-policy-audit-2026-10.md](https://github.com/Picolab/pico-engine/blob/
|
|
196
|
+
- **Channel policy audit:** [channel-policy-audit-2026-10.md](https://github.com/Picolab/pico-engine/blob/master/docs/design/channel-policy-audit-2026-10.md) (repo; summary in [1.8.0 release notes](https://github.com/Picolab/pico-engine/blob/master/docs/release/1.8.0.md)).
|
|
197
197
|
|
|
198
198
|
Owner UI uses the **UI channel** (passkey). Automation uses **OAuth** on `/sky/*` and narrow channels — see README § OAuth.
|
|
199
199
|
|
|
@@ -209,7 +209,7 @@ Owner UI uses the **UI channel** (passkey). Automation uses **OAuth** on `/sky/*
|
|
|
209
209
|
| `/mcp/:eci` | OAuth bearer | Mesh MCP (Streamable HTTP) |
|
|
210
210
|
| `/auth/*` | WebAuthn flows | Registration, login |
|
|
211
211
|
|
|
212
|
-
Local dev MCP: `pico-engine mcp --stdio` — not exposed on hosted load balancers; see [1.8 plan § MCP](https://github.com/Picolab/pico-engine/blob/
|
|
212
|
+
Local dev MCP: `pico-engine mcp --stdio` — not exposed on hosted load balancers; see [1.8 plan § MCP](https://github.com/Picolab/pico-engine/blob/master/docs/release/1.8.md) (deployment table).
|
|
213
213
|
|
|
214
214
|
---
|
|
215
215
|
|
|
@@ -239,4 +239,4 @@ Logs: default `$home/pico-engine.log`, or stdout when configured. Engine logs **
|
|
|
239
239
|
|
|
240
240
|
- [Pico overview / philosophy](pico-overview.md) · [Pico views](pico-views.md) · [Bundled rulesets (wrangler, PDS, …)](rulesets/README.md) · [Manifold mesh framework](https://github.com/Picolab/manifold-api/blob/main/docs/llms.txt) · [KRL manual](krl/README.md)
|
|
241
241
|
- Package [README](../../README.md) — OAuth, authentication, full container checklist
|
|
242
|
-
- Release [1.8.0 notes](https://github.com/Picolab/pico-engine/blob/
|
|
242
|
+
- Release [1.8.0 notes](https://github.com/Picolab/pico-engine/blob/master/docs/release/1.8.0.md) — what changed in this line
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pico-engine",
|
|
3
|
-
"version": "1.9.
|
|
3
|
+
"version": "1.9.2",
|
|
4
4
|
"description": "An implementation of the pico-engine targeting node.js",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -35,6 +35,7 @@
|
|
|
35
35
|
},
|
|
36
36
|
"scripts": {
|
|
37
37
|
"build": "rm -rf dist && tsc",
|
|
38
|
+
"prepack": "node scripts/bundle-docs.js",
|
|
38
39
|
"start": "npm run dev -s",
|
|
39
40
|
"dev": "scriptsp -r dev:tsc dev:api",
|
|
40
41
|
"dev:tsc": "tsc -w --preserveWatchOutput",
|
|
@@ -92,8 +93,8 @@
|
|
|
92
93
|
"express": "^4.16.4",
|
|
93
94
|
"helmet": "^7.1.0",
|
|
94
95
|
"home-dir": "^1.0.0",
|
|
95
|
-
"krl-compiler": "^1.
|
|
96
|
-
"krl-stdlib": "^1.
|
|
96
|
+
"krl-compiler": "^1.9.0",
|
|
97
|
+
"krl-stdlib": "^1.9.0",
|
|
97
98
|
"level-json-coerce-null": "^1.0.1",
|
|
98
99
|
"lodash": "^4.17.11",
|
|
99
100
|
"make-dir": "^4.0.0",
|
|
@@ -113,8 +114,7 @@
|
|
|
113
114
|
"onchange": "^7.1.0",
|
|
114
115
|
"scriptsp": "^1.1.1",
|
|
115
116
|
"ts-node": "^10.4.0",
|
|
116
|
-
"typescript": "^5.2.2"
|
|
117
|
-
"xmlui": "^0.12.7"
|
|
117
|
+
"typescript": "^5.2.2"
|
|
118
118
|
},
|
|
119
119
|
"ava": {
|
|
120
120
|
"extensions": [
|
|
@@ -130,5 +130,5 @@
|
|
|
130
130
|
"!test/helpers/**/*"
|
|
131
131
|
]
|
|
132
132
|
},
|
|
133
|
-
"gitHead": "
|
|
133
|
+
"gitHead": "e7b5699ce223e802b8d2b68f78f3a87bd369b273"
|
|
134
134
|
}
|