https://github.com/hyperpolymath/panll
PanLL eNSAID - Environment for NeSy-Agentic Integrated Development
https://github.com/hyperpolymath/panll
ai development-tools hyperpolymath ide nesy neurosymbolic palimpsest
Last synced: about 1 month ago
JSON representation
PanLL eNSAID - Environment for NeSy-Agentic Integrated Development
- Host: GitHub
- URL: https://github.com/hyperpolymath/panll
- Owner: hyperpolymath
- License: other
- Created: 2026-01-16T03:44:02.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-01-30T01:39:59.000Z (about 2 months ago)
- Last Synced: 2026-01-30T16:29:48.938Z (about 2 months ago)
- Topics: ai, development-tools, hyperpolymath, ide, nesy, neurosymbolic, palimpsest
- Language: ReScript
- Size: 55.7 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.adoc
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Roadmap: ROADMAP.adoc
Awesome Lists containing this project
README
// SPDX-License-Identifier: PMPL-1.0-or-later
= PanLL eNSAID
:toc:
:toc-placement: preamble
:icons: font
image:https://img.shields.io/badge/version-v0.1.0--alpha-blue[Version]
image:https://img.shields.io/badge/completion-95%25-brightgreen[Completion]
image:https://img.shields.io/badge/License-PMPL--1.0-indigo.svg[PMPL-1.0-or-later,link="LICENSE"]
image:https://img.shields.io/badge/Tests-33%20passing%20(719ms)-brightgreen[Tests]
image:https://img.shields.io/badge/Coverage-87--91%25-green[Coverage]
image:https://img.shields.io/badge/RSR-compliant-blue[RSR Compliant]
**Environment for NeSy-Agentic Integrated Development**
PanLL (pronounced "parallel") is a Human-Things Interface (HTI) designed to facilitate a "Binary Star" co-orbit between a Human Operator and a Neurosymbolic Machine.
== Vision
This is not a passive text editor. It is an active, synchronous environment that manages Cognitive Ergonomics and kills Inertia.
== Architecture
=== The Three-Pane Parallel Layout
[cols="1,3"]
|===
|Pane-L (Symbolic)|Strict logic, types, and constraints. "The Law" that governs neural inference.
|Pane-N (Neural)|Streaming "Inference Manifold" showing the Agent's internal monologue and OODA loop.
|Pane-W (World)|Central shared canvas (The Barycentre) where results manifest.
|===
=== 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
== Technical Stack
[cols="1,2"]
|===
|Frontend|ReScript + Custom TEA (The Elm Architecture)
|Backend|Rust + Tauri 2.0
|Runtime|Deno (tests, build orchestration)
|Testing|Deno.test (33 tests, 719ms)
|Styling|Tailwind CSS 4.x
|Middleware|Elixir/BEAM (planned)
|Verification|Echidna (planned)
|===
== Development
PanLL uses Deno for runtime, testing, and build orchestration. ReScript compilation uses the symlinked compiler in node_modules.
[source,bash]
----
# Compile ReScript modules
node_modules/rescript/rescript build
# Watch ReScript sources during development
node_modules/rescript/rescript build -w
# Run tests (33 tests, ~719ms)
deno task test
# Watch mode for tests
deno task test:watch
# Development mode (Tailwind + Tauri hot reload)
deno task dev
# Build Tailwind CSS
deno task css:build
# Full production build
deno task build
----
=== Quick Start
[source,bash]
----
# 1. Compile ReScript
node_modules/rescript/rescript build
# 2. Run tests to verify
deno task test
# 3. Start development server
deno task dev
----
== Documentation
* **link:docs/TEA_GUIDE.md[TEA Architecture Guide]** — Comprehensive documentation for The Elm Architecture (TEA) implementation including Tea_Cmd, Tea_Sub, Tea_Vdom, and Tea_App modules with testing guide and best practices
== Keyboard Shortcuts
[cols="1,2"]
|===
|`Ctrl+Shift+L`|Toggle Pane-L (Symbolic Mass)
|`Ctrl+Shift+N`|Toggle Pane-N (Neural Stream)
|`Ctrl+Shift+B`|Toggle Pane-W (Task Barycentre)
|===
== Licence
PMPL-1.0-or-later
== Status
**v0.1.0-alpha** (95% complete)
✅ Complete TEA implementation (Model-Update-View)
✅ All UI components functional (PaneL, PaneN, PaneW, Vexometer, FeedbackOTron)
✅ Tauri 2.0 backend with working commands
✅ 33 tests passing in 719ms (Deno.test)
✅ npm→Deno migration complete
✅ Full ReScript compilation (180ms)
**Next:** v0.1.0 release preparation