PanLL eNSAID — Environment for NeSy-Agentic Integrated Development
  • ReScript 67.7%
  • Rust 12.4%
  • JavaScript 11.1%
  • TOML 3.4%
  • NCL 1.9%
  • Other 3.4%
Find a file
Jonathan D.A. Jewell 9eed9ac0fe
test: blitz panll to CRG C — Testing & Benchmarking Taxonomy v1.0
Adds all missing taxonomy categories to reach CRG C grade:

Benchmarks:
- benches/panll_bench.js: 4 groups (TEA cycle, panel lifecycle, IPC
  throughput, layout scaling), 35+ Deno.bench entries with groups and
  baselines. deno task bench added to deno.json.

P2P property-based tests (tests/p2p/tea_properties_test.mjs):
- 8 properties x 100 random trials: model shape invariant, no-overlap
  layout, JSON round-trip, AntiCrash monotonicity, Vexometer non-
  decreasing, Contractiles totality, PanelRegistry inverse consistency,
  TypeLL serviceActive type guard.

Aspect tests (tests/aspect/security_test.mjs):
- 36 tests: IPC sanitization (malformed TAGs, null payloads), plugin
  sandboxing (cross-panel state isolation), redaction idempotency and
  pattern coverage, XSS/injection resistance (script, javascript: URIs,
  event handlers, 1MB rejection), governance range invariants.

Contract tests (tests/contract/panel_contracts_test.mjs):
- 30 tests covering C1-C9: orbital stability, vexation ceiling, anti-crash
  quorum, TypeLL service, panel bus, default contractiles, governance
  engine, elasticity adaptation.

Reflexive tests (tests/reflexive/manifest_test.mjs):
- 22 tests: AI manifest claims vs PanelRegistry reality, module export
  verification for all 11 core engines, TEA module exports, model default
  values.

Rust smoke tests added to 11 previously-untested crates:
- security, capture, farm, minter, plaza, watcher, workspace, ai,
  cloudguard, voicetag, hypatia — 267/267 Rust tests pass.

Pre-existing Rust bug fixes (valence_shell):
- checkpoint_restore called with 1 arg instead of 2 in existing tests
- map_or_else type annotation needs explicit Ok::<_, Infallible>

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>
2026-04-04 00:53:02 +01:00
.claude docs: replace all Tauri references with Gossamer across documentation and comments 2026-03-23 22:57:57 +00:00
.github ci: add E2E + crosscutting + bench + Rust backend CI pipeline 2026-03-30 11:19:06 +01:00
.machine_readable test: blitz panll to CRG C — Testing & Benchmarking Taxonomy v1.0 2026-04-04 00:53:02 +01:00
.well-known feat: 4-tier clade system upgrade — protocols, capabilities, event bus, security 2026-03-08 22:08:57 +00:00
beam/panll_beam feat: 28 game dev panels + Coprocessor Phase 2/3 + PanelBus scaling + BEAM promotion 2026-03-15 00:06:55 +00:00
benches test: blitz panll to CRG C — Testing & Benchmarking Taxonomy v1.0 2026-04-04 00:53:02 +01:00
clade-portal feat(ux): add onboarding, contractiles, and UX infrastructure 2026-03-24 11:02:21 +00:00
contractiles chore: add UX infrastructure (quickstart, doctor, setup) 2026-03-28 08:29:31 +00:00
contracts feat: add Wiring Inspector panel + 77 panel contracts 2026-03-14 22:47:27 +00:00
data feat: align Hypatia panel with real neural network architecture 2026-03-07 20:09:40 +00:00
docs docs: dogfooding opportunities — C→Zig, V adapters, proven modules, VeriSimDB 2026-03-30 09:44:57 +01:00
ffi/zig feat: 28 game dev panels + Coprocessor Phase 2/3 + PanelBus scaling + BEAM promotion 2026-03-15 00:06:55 +00:00
layouts chore: RSR sync and mass repository update 2026-03-17 13:34:16 +00:00
LICENSES Standardise license setup: MPL-2.0 + PMPL-1.0-or-later (REUSE) 2026-03-11 02:53:18 +00:00
panel-clades refactor: purge all stale Tauri references from ReScript source 2026-03-29 17:06:55 +01:00
public fix(security): sanitize panelName with DOMPurify in detached.html 2026-04-03 15:12:18 +01:00
runtime feat: complete all 19 SONNET-TASKS.md items for v0.1.0 milestone 2026-02-12 16:32:33 +00:00
schema feat: Gossamer migration — RuntimeBridge, GossamerCmd, 66 command files, minter, harness v2 2026-03-22 23:09:12 +00:00
scripts fix: replace deno -A with specific permission flags in bundle.ts 2026-03-30 11:12:18 +01:00
src refactor: rename ProtoTauriIPC to ProtoGossamerIPC, clean Tauri references 2026-04-03 15:06:49 +01:00
src-gossamer/src test: blitz panll to CRG C — Testing & Benchmarking Taxonomy v1.0 2026-04-04 00:53:02 +01:00
tests test: blitz panll to CRG C — Testing & Benchmarking Taxonomy v1.0 2026-04-04 00:53:02 +01:00
tools/pcc chore: add #![forbid(unsafe_code)] to safe Rust crates 2026-03-16 14:47:34 +00:00
.editorconfig Auto-commit: Sync changes [2026-02-11] 2026-02-11 12:29:47 +00:00
.gitattributes chore: RSR sync and mass repository update 2026-03-17 13:34:16 +00:00
.gitignore chore: gitignore .tool-versions (asdf) 2026-03-28 09:12:48 +00:00
.hypatia-rules.yml feat: TypeLL 41-panel integration, ECHIDNA ProofChain, SafeDOM defence-in-depth, flaky test fixes 2026-03-09 02:23:19 +00:00
0-AI-MANIFEST.a2ml feat(ux): add onboarding, contractiles, and UX infrastructure 2026-03-24 11:02:21 +00:00
Cargo.lock chore: track Cargo.lock 2026-03-28 07:38:02 +00:00
Cargo.toml feat: complete Tauri removal — 270 commands migrated to Gossamer 2026-03-23 22:38:25 +00:00
CHANGELOG.md docs: add CRG D→C prep to CHANGELOG 2026-03-29 21:51:24 +01:00
CODE_OF_CONDUCT.md fix: replace template placeholders with actual values 2026-03-16 01:23:45 +00:00
contractile.just feat(contractiles): tailor for PanLL — SafeDOM, panels-not-panes, 9 intents 2026-03-14 16:28:11 +00:00
CONTRIBUTING.md docs: replace all Tauri references with Gossamer across documentation and comments 2026-03-23 22:57:57 +00:00
deno.json test: blitz panll to CRG C — Testing & Benchmarking Taxonomy v1.0 2026-04-04 00:53:02 +01:00
deno.lock refactor: rename ProtoTauriIPC to ProtoGossamerIPC, clean Tauri references 2026-04-03 15:06:49 +01:00
EXPLAINME.adoc Fix EXPLAINME.adoc section heading quotes 2026-03-28 23:25:17 +00:00
flake.nix feat(ux): add onboarding, contractiles, and UX infrastructure 2026-03-24 11:02:21 +00:00
gossamer.conf.json feat: Gossamer migration — RuntimeBridge, GossamerCmd, 66 command files, minter, harness v2 2026-03-22 23:09:12 +00:00
guix.scm feat(ux): add onboarding, contractiles, and UX infrastructure 2026-03-24 11:02:21 +00:00
Justfile feat(ux): add onboarding, contractiles, and UX infrastructure 2026-03-24 11:02:21 +00:00
LICENSE Standardise license setup: MPL-2.0 + PMPL-1.0-or-later (REUSE) 2026-03-11 02:53:18 +00:00
llm-warmup-user.md chore: deploy UX infrastructure (contractile.just, .well-known, manifest) 2026-03-29 11:54:25 +01:00
mod.js chore: batch RSR compliance — SPDX headers, SHA-pin actions, forbid(unsafe_code), CODE_OF_CONDUCT, CONTRIBUTING 2026-03-22 13:22:42 +00:00
NOTICE Standardise license setup: MPL-2.0 + PMPL-1.0-or-later (REUSE) 2026-03-11 02:53:18 +00:00
package.json feat: complete Tauri removal — 270 commands migrated to Gossamer 2026-03-23 22:38:25 +00:00
panll.desktop Add .desktop file and install script for Linux desktop integration 2026-03-28 23:22:36 +00:00
PROOF-NEEDS.md chore: sync deno.lock, opsm-panel + audit docs 2026-03-30 13:28:17 +01:00
QUICKSTART-DEV.adoc chore: add UX infrastructure (quickstart, doctor, setup) 2026-03-28 08:29:31 +00:00
QUICKSTART-MAINTAINER.adoc chore: add UX infrastructure (quickstart, doctor, setup) 2026-03-28 08:29:31 +00:00
QUICKSTART-USER.adoc chore: add UX infrastructure (quickstart, doctor, setup) 2026-03-28 08:29:31 +00:00
README.adoc Enhance README with detailed PanLL descriptions 2026-03-27 18:43:16 +00:00
rescript.json feat: 28 game dev panels + Coprocessor Phase 2/3 + PanelBus scaling + BEAM promotion 2026-03-15 00:06:55 +00:00
SECURITY.md fix: SPDX headers (AGPL→PMPL), email, author name 2026-03-16 00:45:52 +00:00
setup.sh chore: add UX infrastructure (quickstart, doctor, setup) 2026-03-28 08:29:31 +00:00
stapeln.toml feat: add Stapeln container configuration 2026-03-29 11:54:25 +01:00
start.sh Auto-commit: Sync changes [2026-03-03] 2026-03-03 17:48:34 +00:00
tailwind.config.js chore: update license and author attribution, add standard workflows 2026-02-04 11:00:11 +00:00
TEST-NEEDS.md test: blitz panll to CRG C — Testing & Benchmarking Taxonomy v1.0 2026-04-04 00:53:02 +01:00
TOPOLOGY.md docs: add root TOPOLOGY.md with module structure and architecture map 2026-04-03 15:09:50 +01:00

PanLL eNSAID

Version Completion PMPL-1.0-or-later Tests RSR Compliant Green Hosting

PanLL is a practical cognitive-relief layer: a set of tools and mechanisms designed to reduce friction, lower cognitive overhead, and make difficult work more manageable.

It is not the whole ambient environment.

It is the part that helps.

PanLL is the eNSAID in the broader vision: not a complete cure, not the entire world, but a real reduction in pain, drag, and inertia so movement becomes possible again.

What PanLL is

PanLL (pronounced "parallel") is a Human-Things Interface (HTI) built to support a tighter, calmer, more effective co-orbit between a human operator and a neurosymbolic machine.

Its purpose is straightforward:

Reduce the amount of unnecessary thinking required to make progress.

PanLL is for cases where the user is already carrying too much:

  • too many decisions

  • too much context-switching

  • too much explicit control

  • too much interface friction

It aims to make work feel smoother, more recoverable, and less cognitively expensive.

What PanLL is not

PanLL is not:

  • the full ambient-computing vision

  • the total philosophy of a serene environment

  • a finished answer to cognitive overload

That broader work belongs elsewhere.

PanLL is the practical support layer:

  • the friction reducer

  • the context keeper

  • the anti-inertia mechanism

  • the thing that makes hard work less punishing

Why eNSAID

PanLL is described as an eNSAID because it plays a similar role to an anti-inflammatory:

  • it does not solve every underlying problem

  • it does reduce pain, friction, and strain

  • it helps keep movement possible

  • it prevents avoidable overload from becoming the whole experience

That is the role here.

PanLL does useful work now, while larger questions about ambient computing, serenity, and environment-first design continue to be explored elsewhere.

Vision

This is not a passive text editor.

It is an active, synchronous environment for reducing friction and managing cognitive ergonomics in real time.

The ambition is not simply “more powerful tooling”.

It is:

  • less drag

  • less interruption

  • less inertia

  • more continuity between intention and action

Architecture

The Three-Pane Parallel Layout

Pane-L (Symbolic)

Strict logic, types, and constraints. The symbolic and contractual layer — “the law” governing inference and action.

Pane-N (Neural)

Streaming inference manifold showing the agent’s internal monologue, reasoning traces, and OODA-style movement.

Pane-W (World)

Central shared canvas — the task barycentre — where results, actions, artefacts, and state become visible.

Core Systems

  • Anti-Crash Library: Logical circuit breaker preventing unvalidated neural output from reaching the barycentre

  • Vexometer: Real-time friction / cognitive-load monitoring with anti-inflammatory UI adjustments

  • Contractiles: Adaptive state contracts between operator and machine

  • Feedback-O-Tron: Community-driven performance reporting and constraint suggestions

These are not decorative features. They exist to reduce avoidable breakage, ambiguity, and strain.

Design principles

PanLL components aim to:

  • minimise explicit prompting

  • reduce unnecessary interruption

  • preserve reversibility (easy undo, refinement, recovery)

  • maintain context so the user does not have to keep re-establishing it

  • help without constantly demanding attention

  • make progress easier under real cognitive conditions, not ideal ones

Technical Stack

Layer Choice Why This

Frontend

ReScript + TEA (The Elm Architecture)

Actually type-safe — no any escape hatch, exhaustive pattern matching on every variant, and the compiler catches state bugs that TypeScript structurally cannot. We tried TypeScript early on; the as casts and Partial<T> workarounds in a 14-panel stateful app were untenable. See ReScript docs for the sound type system that made this possible.

Backend

Rust + Gossamer (WebKitGTK)

5 MB binary vs 100+ MB Electron. No garbage collector pauses during real-time panel updates. The notify crate handles filesystem watching across Linux/macOS/Windows without the cross-platform pain that Go’s fsnotify brings. Gossamer uses Zig + WebKitGTK for a lightweight, container-friendly webview shell.

Runtime

Deno (tests, build orchestration)

No node_modules black hole — URL imports, built-in TypeScript support for glue code, secure-by-default permissions model. npm is only used for the ReScript compiler itself (pending upstream Deno support). See Deno.

Testing

Deno.test (97 JS) + cargo test (12 Rust)

Built into the runtime, no extra test framework dependency to manage. Jest/Vitest config files are their own maintenance burden; Deno.test just works.

Styling

Tailwind CSS 4.x

Utility-first, purged in production. Keeps panel styling consistent across a large panel surface without CSS specificity wars.

Middleware

Elixir/BEAM (beam/panll_beam)

BEAM’s supervision model is a good fit for a multi-panel environment where individual backend connections can fail without taking down the whole surface.

Verification

Idris2 ABI (planned) + Echidna

High-assurance interface verification and trust checking for places where “probably correct” is not enough.

Data Processing

Julia (batch scripts, analysis)

Useful for numeric analysis, calibration, and batch processing without fighting Python’s runtime limitations.

Development

PanLL uses Deno for runtime, testing, and build orchestration. ReScript compilation uses the symlinked compiler in node_modules.

# Compile ReScript modules
npx rescript build

# Watch ReScript sources during development
npx rescript build -w

# Run tests (97 JS tests + 12 Rust tests)
deno task test

# Watch mode for tests
deno task test:watch

# Development mode (Tailwind + static dev server + Gossamer dev mode)
deno task dev

# Build Tailwind CSS
deno task css:build

# Full production build
deno task build

Quick Start

# 1. Compile ReScript
npx rescript build

# 2. Run tests to verify
deno task test

# 3. Start development server
deno task dev

Documentation

Philosophy & Design

Architecture

  • Topology — System architecture map and completion dashboard

  • Architecture Reference — TEA modules, engine pattern, clade system, BoJ gateway, cognitive governance

  • System Diagrams — ASCII-art architecture diagrams (frontend, Pane-N, data flow, trust hierarchy)

  • Panel Inventory — Complete inventory of all panels

Guides

Planning

  • Roadmap — Version-by-version feature plan

  • TODO — Active task list with triaxial scoring

  • EXPLAINME — Backs up README claims for sceptics

Event-Chain Import (panic-attack)

PanLL can ingest PanLL event-chain JSON exported by panic-attack and surface it in Pane-W for MVP timeline review.

Paste the JSON export into the Event Chain panel and click Import JSON, or use Load File to open a saved export.

BEAM API Modes

The optional BEAM service (beam/panll_beam) supports all three API styles as runtime-selectable options:

  • HTTP via Bandit/Plug (/healthz, /v1/status)

  • GraphQL via Absinthe (/graphql, /graphiql)

  • gRPC via panll.v1.StatusService/GetStatus

Select protocols with PANLL_BEAM_APIS:

# defaults to all in non-test env
export PANLL_BEAM_APIS="http,graphql,grpc"

For containerized runtime orchestration (Chainguard base + Cerro Torre pack/verify + selur-compose stack), see runtime/README.adoc.

Local Dev Server

deno task dev starts a static server for public/ on http://localhost:8000 to satisfy the Gossamer webview.

Keyboard Shortcuts

Ctrl+Shift+L

Toggle Pane-L (Symbolic Mass)

Ctrl+Shift+N

Toggle Pane-N (Neural Stream)

Ctrl+Shift+B

Toggle Pane-W (Task Barycentre)

Ctrl+Shift+W

Toggle Pane-W (alternate binding)

Status

v0.2.0-dev (85% complete, 106 panels defined)

Complete TEA implementation (Model-Update-View)
All UI components functional (PaneL, PaneN, PaneW, Vexometer, FeedbackOTron)
Gossamer backend with 270 migrated commands
109 tests passing (97 JS via Deno.test + 12 Rust via cargo test)
npm→Deno migration complete
Full ReScript compilation (180ms, 0 warnings)
Anti-Crash token gating + backend validation hooks
Event-chain import from panic-attack (paste + file) with persistence
Security tool integration (panic-attack ambush, timeline import)
Feedback report types wired to backend
State persistence (localStorage auto-save)
ARIA accessibility attributes across all components
Keyboard shortcuts wired (Ctrl+Shift+L/N/B/W + vexation polling)
Tailwind CSS 4.x build pipeline (Deno)
BEAM API scaffold (HTTP/GraphQL/gRPC)

Next: v0.1.0 release preparation

Licence

PMPL-1.0-or-later

Architecture

See TOPOLOGY.md for a visual architecture map and completion dashboard.