Skip to content

Commit 67d2755

Browse files
hyperpolymathclaude
andcommitted
docs: add HAR integration, proven-servers, Ephapax, PanLL cross-references
README.adoc: - New sections: HAR integration (standalone vs with HAR), formally verified foundations (proven-fsm, proven-queueconn, Ephapax), PanLL panels ROADMAP.adoc: - Phase 1.1: add ABI/FFI, proven-fsm, proven-queueconn, Ephapax, PanLL as deliverables (all marked complete as of 2026-03-17) ECOSYSTEM.a2ml: - Add hybrid-automation-router as integration-target relationship META.a2ml: - ADR-006: proven-servers integration - ADR-007: Ephapax linear types - ADR-008: PanLL monitoring panels 0-AI-MANIFEST.a2ml: - Add panels/ to canonical locations - Add integration section (standalone + HAR modes) TOPOLOGY.md: - Update ABI/FFI section: proven-fsm 100%, proven-queueconn 100%, Ephapax 100%, Zig FFI 10% - Add PanLL panels section (both 100%) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 9f8812e commit 67d2755

6 files changed

Lines changed: 95 additions & 4 deletions

File tree

.machine_readable/ECOSYSTEM.a2ml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,10 @@ description = "Management console could use PanLL for panel layout"
3333
type = "consumer"
3434
description = "Uses Hypatia for neurosymbolic CI/CD scanning"
3535

36+
[relationships.hybrid-automation-router]
37+
type = "integration-target"
38+
description = "HAR routes events to rpa-elysium via proven-queueconn. Both share ABI types (proven-fsm, proven-queueconn). Either works standalone."
39+
3640
[relationships.rhodium-standard-repositories]
3741
type = "implements"
3842
description = "RSR-certified repository following Rhodium standards"

.machine_readable/META.a2ml

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,24 @@ status = "accepted"
3939
date = "2026-03-16"
4040
rationale = "Filesystem automation CLI is functional now. Ship standalone, absorb into full framework later. Validates core architecture."
4141

42+
[architecture-decisions.adr-006]
43+
title = "proven-servers integration (proven-fsm + proven-queueconn)"
44+
status = "accepted"
45+
date = "2026-03-17"
46+
rationale = "Formally verified state machine and queue types from proven-servers give compile-time guarantees for workflow transitions and event delivery. Tag values shared with HAR for interop."
47+
48+
[architecture-decisions.adr-007]
49+
title = "Ephapax linear types for ownership safety"
50+
status = "accepted"
51+
date = "2026-03-17"
52+
rationale = "Linear types enforce single-use of events, transitions, and queue handles. Supplementary to Idris2 (not authoritative when they conflict). Enables gradual adoption via affine/linear dyadic design."
53+
54+
[architecture-decisions.adr-008]
55+
title = "PanLL panels for monitoring dashboards"
56+
status = "accepted"
57+
date = "2026-03-17"
58+
rationale = "JSON panel definitions in panels/ enable integration with PanLL monitoring system. Two panels: fs-workflow (runtime) and plugin-status (sandbox)."
59+
4260
[development-practices]
4361
test-coverage-target = "80%"
4462
ci-pipelines = 17

0-AI-MANIFEST.a2ml

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,9 +9,15 @@
99
## Canonical File Locations
1010
- SCM/A2ML files: `.machine_readable/` ONLY (never root)
1111
- Rust source: `crates/` (workspace members)
12-
- ABI definitions: `src/abi/` (Idris2)
12+
- ABI definitions: `src/abi/` (Idris2 + Ephapax)
1313
- FFI implementation: `ffi/zig/` (Zig)
14+
- PanLL panels: `panels/` (JSON panel definitions)
1415
- CI/CD workflows: `.github/workflows/`
16+
17+
## Integration
18+
- Works standalone OR as a target for hybrid-automation-router (HAR)
19+
- Shares ABI types with HAR (proven-fsm, proven-queueconn)
20+
- HAR publishes events → rpa-elysium subscribes via proven-queueconn
1521
- Examples: `examples/`
1622

1723
## Critical Invariants

README.adoc

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -264,6 +264,40 @@ Palimpsest License (PMPL-1.0-or-later)
264264
_Transform your business processes — Watch this repository to stay updated with development progress._
265265

266266

267+
== Integration with Hybrid Automation Router
268+
269+
RPA Elysium works standalone as a filesystem automation CLI, or as a *target* for the https://github.com/hyperpolymath/hybrid-automation-router[Hybrid Automation Router (HAR)].
270+
271+
[cols="1,3"]
272+
|===
273+
|Mode |Description
274+
275+
|*Standalone*
276+
|Run `rpa-fs run workflow.json` directly. Events come from filesystem watchers only.
277+
278+
|*With HAR*
279+
|HAR routes events from multiple sources (webhooks, queues, schedules) to rpa-elysium via proven-queueconn. RPA Elysium subscribes to a task queue and executes received events.
280+
|===
281+
282+
Both repos share the same link:src/abi/[ABI layer] (proven-fsm state machines, proven-queueconn delivery guarantees) and link:src/abi/LinearDispatch.eph[Ephapax linear types] for ownership safety.
283+
284+
== Formally Verified Foundations
285+
286+
RPA Elysium consumes types from https://github.com/hyperpolymath/proven-servers[proven-servers]:
287+
288+
* **proven-fsm** — Workflow state machine with transition proofs (link:src/abi/ProvenFSM.idr[ProvenFSM.idr])
289+
* **proven-queueconn** — Queue connector with delivery guarantees (link:src/abi/ProvenQueue.idr[ProvenQueue.idr])
290+
* **Ephapax linear types** — Compile-time ownership enforcement (link:src/abi/LinearDispatch.eph[LinearDispatch.eph])
291+
292+
See link:ABI-FFI-README.md[ABI-FFI-README.md] for full type mappings and architecture.
293+
294+
== Monitoring Panels (PanLL)
295+
296+
Pre-built monitoring panels in `panels/`:
297+
298+
* `panels/fs-workflow/` — Workflow status, watch paths, rules, event timeline, FSM state diagram, queue connection status
299+
* `panels/plugin-status/` — Loaded WASM plugins, sandbox memory, execution logs
300+
267301
== Architecture
268302

269303
See link:TOPOLOGY.md[TOPOLOGY.md] for a visual architecture map and completion dashboard.

ROADMAP.adoc

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -114,8 +114,30 @@ Build the foundational bot framework in Rust that handles task scheduling, state
114114
|Guix packaging
115115
|Guix
116116
|guix.scm for reproducible builds
117+
118+
|ABI/FFI scaffold
119+
|Idris2 + Zig
120+
|Formal type definitions and C-compatible FFI stubs
121+
122+
|proven-fsm bindings
123+
|Idris2
124+
|Workflow state machine with transition proofs
125+
126+
|proven-queueconn bindings
127+
|Idris2
128+
|Queue connector for HAR event subscription
129+
130+
|Ephapax linear types
131+
|Ephapax
132+
|Compile-time ownership enforcement for events and transitions
133+
134+
|PanLL monitoring panels
135+
|JSON
136+
|fs-workflow and plugin-status panels
117137
|===
118138

139+
NOTE: All Phase 1.1 items are complete as of 2026-03-17.
140+
119141
==== 1.2 Bot Core (Rust)
120142

121143
[%autowidth]

TOPOLOGY.md

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -71,9 +71,16 @@ PLATFORM (PLANNED)
7171
AI Intelligence Engine █░░░░░░░░░ 10% WASM component stubs
7272
Backend Services (Gleam) █░░░░░░░░░ 10% Scaffold only
7373
74-
ABI / FFI
75-
Idris2 ABI definitions █░░░░░░░░░ 10% Type scaffolds
76-
Zig FFI implementation █░░░░░░░░░ 10% Build scaffold
74+
ABI / FFI / PROVEN
75+
Idris2 ABI (core types) ███░░░░░░░ 30% Types + Layout + Foreign
76+
proven-fsm bindings ██████████ 100% ProvenFSM.idr complete
77+
proven-queueconn bindings ██████████ 100% ProvenQueue.idr complete
78+
Ephapax linear types ██████████ 100% LinearDispatch.eph complete
79+
Zig FFI implementation █░░░░░░░░░ 10% Build scaffold only
80+
81+
PANLL PANELS
82+
fs-workflow panel ██████████ 100% Status, rules, timeline, FSM
83+
plugin-status panel ██████████ 100% Plugins, sandbox, logs
7784
7885
INFRASTRUCTURE
7986
CI/CD Pipelines (17+) ██████████ 100% Forge sync stable

0 commit comments

Comments
 (0)