JohnBasrai / JohnBasrai/rust-edge-agent

Define and exercise a minimal distributed-system behavior (v0.2.0)

Open
#1 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Rust
Stars
1
Forks
0
PR merge metrics
No merged PRs in 30d

Description

## Goal

Move beyond toolchain and execution correctness by exercising a *single* distributed-system behavior appropriate for an edge agent.

This issue is intentionally scoped to **one minimal proving example**.

## Motivation

v0.1.0 successfully establishes:
- ARM64 cross-compilation
- runtime correctness under QEMU
- reproducible CI workflows

What is still missing is a concrete demonstration of reasoning about an edge agent *as a constrained distributed system*, rather than as a
standalone program.

## Proposed scope (choose one)

One of the following is sufficient to close this issue:

- **Lifecycle driven by an external stimulus**
- e.g. message → state transition
- **Failure / reconnect behavior**
- e.g. simulated message bus outage → recovery
- **Explicit coordination contract**
- e.g. heartbeat, liveness check, or command acknowledgement

## Non-goals

- No hardware integration
- No firmware or device drivers
- No production-grade messaging guarantees
- No full async refactor unless required by the chosen example

## Acceptance criteria

- Behavior is observable (logs or output)
- Behavior is exercised in CI (native or QEMU)
- Code remains explicit and small
- README updated to reflect the added capability

## Versioning

Target: **v0.2.0**

Contributor guide

Open the contributing guide

Research direction

Start by inspecting the existing edge-agent behavior, CI workflows, QEMU execution path, and README. Choose one proposed behavior, keep the implementation explicit and small, then verify observable logs or output in native or QEMU CI and document the capability in the README.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
distributed-systems, embedded-iot
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.