feat: /src clean architecture scaffold — Core, Application, Infrastructure, Cloud, EdgeAgent, UI (Phase 1–3, 5–7)

[Copilot]

MakerPrompt has grown organically into a multi-backend printer farm ecosystem but lacks the architectural layering to support distributed scenarios (local edge agents, cloud telemetry, multi-printer providers). This PR creates a clean, additive /src foundation alongside the existing projects — no existing code is deleted or modified.

New projects

Project	Layer	Purpose
MakerPrompt.Core	Domain	Pure interfaces + domain models. Zero Blazor/platform deps.
MakerPrompt.Application	Application	Fleet orchestration, telemetry aggregation, filament inventory, analytics, print projects, farm management
MakerPrompt.Infrastructure	Infrastructure	In-memory stores for telemetry, filament, analytics, print projects, farm profiles, and camera snapshots. Includes SerialCommunicationServiceBase for Marlin G-code printers and MjpegCameraProvider for webcam capture.
MakerPrompt.Infrastructure.Sqlite	Infrastructure	SQLite-backed ITelemetryStore and ICameraSnapshotStore via raw Microsoft.Data.Sqlite
MakerPrompt.Infrastructure.InfluxDb	Infrastructure	InfluxDB-backed ITelemetryStore using InfluxDB.Client 5.0.0 — Line Protocol ingest, Flux queries
MakerPrompt.Cloud	Host	ASP.NET Core minimal API — telemetry + camera ingest/retrieval, OIDC/JWT bearer authentication
MakerPrompt.EdgeAgent	Host	.NET Worker Service — polls local printers, captures camera frames, forwards both to cloud
MakerPrompt.UI.Components	UI	Razor Class Library — Fleet, Dashboard, FilamentInventory, Analytics, Settings pages (depends only on Core + Application)
MakerPrompt.UI.Blazor	UI Host	Blazor WASM host — wires Application + Infrastructure via DI, hosts UI.Components
MakerPrompt.UI.MAUI	UI Host	MAUI BlazorWebView host — wraps UI.Components; platform-specific serial backends
MakerPrompt.Tests.Unit	Tests	82 xUnit tests covering fleet, telemetry, filament inventory, analytics, print projects, farm profiles, infrastructure stores, SQLite stores, and camera store

Key architectural distinction formalized

The existing codebase conflated fleet enumeration with printer control. Core now makes this explicit:

// IPrinterProvider — "which printers does this account expose?"
// One provider → many printers (PrusaConnect, OctoPrint farm, etc.)
public interface IPrinterProvider
{
    Task ConfigureAsync(string bearerToken, CancellationToken ct = default);
    Task<IReadOnlyList<PrinterInfo>> GetPrintersAsync(CancellationToken ct = default);
}

// IPrinterCommunicationService — "control this one printer"
// One instance → one printer
public interface IPrinterCommunicationService : IAsyncDisposable
{
    Task<bool> ConnectAsync(PrinterConnectionSettings settings, CancellationToken ct = default);
    Task<PrinterTelemetry> GetTelemetryAsync(CancellationToken ct = default);
    // ...
}

Domain models migrated to Core

• FilamentSpool, PrintJobUsageRecord, PrintProject / PrintJob, FarmConfiguration / PrinterConnectionDefinition, NotificationRecord
• CameraSnapshot — domain model for webcam/MJPEG frames (CameraId, Label, JpegData, Width, Height, CapturedAt)

New Core abstractions

• IFilamentInventoryStore — spool CRUD + deduction (clamped, never negative)
• IPrintJobAnalyticsStore — record storage + per-printer / per-spool queries
• IPrintProjectRepository — project CRUD + G-code file storage
• IFarmRepository — farm profile CRUD
• ICameraProvider — CaptureSnapshotAsync, CheckAvailabilityAsync, IsAvailable
• ICameraSnapshotStore — SaveAsync, GetLatestAsync, GetHistoryAsync

Application services (migrated and improved from MakerPrompt.Shared)

• FilamentInventoryService — inventory management with deduction business rule and change events
• AnalyticsService — total print-time and filament aggregation per printer/spool
• PrintProjectService — project CRUD, job lifecycle (queue → print → complete/fail), G-code file dispatch
• FarmService — farm profiles, printer snapshots, JSON export/import

Serial communication infrastructure (Phase 7)

SerialCommunicationServiceBase in MakerPrompt.Infrastructure.Serial implements the full IPrinterCommunicationService contract for Marlin/RepRap firmware printers:

• All G-code command building (M104, M140, G28, G91/G1, M106, M220, M221, M105, M27, etc.)
• Marlin response parsing (temperature regex, SD progress regex)
• Telemetry polling timer
• protected const int DefaultBaudRate = 250_000 shared by all platform implementations

MakerPrompt.UI.MAUI/Services/SerialCommunicationService is a partial class with per-platform transport implementations:

Platform	Transport
Windows	System.IO.Ports.SerialPort with async send/receive loops
Android	UsbSerialForAndroid.Net driver
macOS	UsbSerialForMacOS driver
iOS	PlatformNotSupportedException stub

Camera / webcam support (Phase 5)

MjpegCameraProvider in Infrastructure handles both plain image/jpeg snapshot endpoints and multipart/x-mixed-replace MJPEG streams (first JPEG frame extracted via SOI/EOI byte marker scan). InMemoryCameraSnapshotStore uses a bounded ring buffer; history queries strip JPEG blobs to keep memory bounded.

CameraPollingWorker in EdgeAgent reads camera entries from appsettings.json (EdgeAgent:Cameras[]), checks availability at startup, and captures on a configurable CameraIntervalSeconds interval.

Cloud API camera endpoints:

• POST /api/camera/{id}/snapshot — EdgeAgent ingest (requires makerprompt:ingest scope)
• GET /api/camera/{id}/latest — returns raw image/jpeg bytes (MemberRead auth)
• GET /api/camera/{id}/history — metadata array without JPEG blobs (MemberRead auth)

UI layer (Phase 3)

MakerPrompt.UI.Components is a Razor Class Library that depends only on Core + Application (no Infrastructure coupling). It contains:

• FleetPage — lists all printers, live telemetry cards, connect/disconnect
• DashboardPage — per-printer temperature, print progress, quick controls (home, heaters off, fan off)
• FilamentInventoryPage — spool table with inline add/edit/delete form
• AnalyticsPage — total print time, filament consumed, recent jobs grouped by printer
• SettingsPage — Cloud API URL + token configuration

MakerPrompt.UI.Blazor (WASM host) and MakerPrompt.UI.MAUI (BlazorWebView host) both reference UI.Components and compose all layers via DI.

Cloud API authentication (Phase 6)

MakerPrompt.Cloud uses Microsoft.AspNetCore.Authentication.JwtBearer with OIDC-compatible configuration:

• Authority + Audience set via MakerPrompt:Auth:Authority / MakerPrompt:Auth:Audience (appsettings or environment)
• EdgeAgent policy — requires makerprompt:ingest scope (machine-to-machine token); protects telemetry and camera ingest endpoints
• MemberRead policy — any authenticated user; protects telemetry and camera read endpoints
• /health stays anonymous
• Development fallback: signature validation skipped when Authority is not configured

Persistence providers (Phase 6)

Two swappable ITelemetryStore implementations replace the in-memory default in production:

MakerPrompt.Infrastructure.Sqlite

• SqliteTelemetryStore — JSON payload column for forward-compatible, schema-free telemetry rows
• SqliteCameraSnapshotStore — BLOB column for JPEG data; metadata-only history queries
• Raw Microsoft.Data.Sqlite; fully async (OpenAsync throughout); schema initialised on construction

MakerPrompt.Infrastructure.InfluxDb

• InfluxDbTelemetryStore using InfluxDB.Client 5.0.0
• Line Protocol write with printer tags; Flux queries for latest/history
• All string values (including bucket and measurement names) escaped against Flux injection via EscapeFlux()

Register either provider at the DI composition root in EdgeAgent or Cloud — no Core or Application changes required.

Dependency graph

Core  ←  Application  ←  Cloud
  ↑           ↑           ↑
  └── Infrastructure ──────┘
        ↑           ↑
   UI.Components  EdgeAgent
     ↑       ↑
UI.Blazor  UI.MAUI

Infrastructure (in-memory, Sqlite, InfluxDb) references only Core (clean arch rule enforced). Cloud, EdgeAgent, and UI hosts compose all layers.

Migration strategy

Old projects (MakerPrompt.Shared, MakerPrompt.Blazor, MakerPrompt.MAUI) coexist unchanged during incremental migration. The solution file includes both old and new projects grouped under a src solution folder.

Original prompt

Agent Task — Full Repository Audit + Architecture Restructure

You are a senior .NET software architect working on the MakerPrompt repository.

The project started as a replacement for an old application called Pronterface, but it evolved into a much larger cross-platform 3D printer farm ecosystem.

The current repository contains:

• Blazor WebAssembly UI
• .NET MAUI Blazor application
• Multiple printer backends
• Fleet/farm logic
• Telemetry
• Webcam integrations
• File management
• E2E tests
• Unit tests
• Experimental/incomplete systems

The codebase has grown organically and now requires a proper restructuring.

This is NOT a cosmetic refactor.

This is a controlled architectural rebuild while preserving working functionality.

---

Primary Goal

Create a new architecture inside the existing repository under:

/src

The old projects may temporarily coexist during migration.

Do NOT immediately delete old code.

The agent must first fully understand the current system before migrating functionality.

Phase 1 — Full Repository Audit

Analyze the ENTIRE repository.

The goal is to identify:

every service
every method
every feature
every backend
every UI flow
every communication pattern
every test
incomplete/experimental systems
dead code
duplicate logic
architecture violations

Generate a clear understanding of:

what exists
what works
what is incomplete
what should be migrated
what should be redesigned

Do NOT blindly copy the old architecture.

Phase 2 — New Architecture

Create a clean architecture under:

/src

Suggested structure:

/src
  /MakerPrompt.Core
  /MakerPrompt.Application
  /MakerPrompt.Infrastructure
  /MakerPrompt.Shared
  /MakerPrompt.UI.Web
  /MakerPrompt.UI.Maui
  /MakerPrompt.Tests.Unit
  /MakerPrompt.Tests.Integration
  /MakerPrompt.Tests.E2E

Additionally create new backend/server projects:

/src/MakerPrompt.Cloud
/src/MakerPrompt.EdgeAgent
New System Goals
1️⃣ Client Applications

Existing MAUI Blazor UI should remain the primary UI for now.

However architecture should prepare for:

future native XAML MAUI UI

Avoid tightly coupling business logic to Blazor components.

2️⃣ Edge Agent

Create a new local service project:

MakerPrompt.EdgeAgent

Purpose:

runs locally in hackerspace / farm
communicates with printers
collects telemetry
collects webcam snapshots/streams
sends telemetry securely to cloud backend

This acts as the local bridge between printers and cloud systems.

3️⃣ Cloud Backend

Create:

MakerPrompt.Cloud

Purpose:

authenticated users can retrieve telemetry
printer/farm status APIs
webcam relay APIs later
future notifications
future analytics

Do NOT overbuild cloud infrastructure yet.

Just create a clean foundation.

Printer Architecture Redesign

Current architecture incorrectly assumed:

1 connection = 1 printer

This is NOT always true.

Examples:

PrusaConnect
OctoPrint farms
future cloud providers

can expose MULTIPLE printers from one provider.

The new architecture must distinguish:

printer providers
vs
printer connections

Example:

IPrinterProvider
    -> retrieves printers

IPrinterCommunicationService
    -> controls one printer

This distinction must become foundational in the new architecture.

Backend Types

The architecture must support:

Single Printer Backends
Moonraker
PrusaLink
WebSerial
BambuLAb
Multi Printer Providers
PrusaConnect
OctoPrint farm systems
future cloud systems
Testing Requirements

Current tests exist but are incomplete and inconsistent.

The agent must:

audit existing tests
determine what they actually validate
identify missing coverage
identify useless tests
migrate useful tests
Unit Testing

Implement meaningful unit tests for:

application services
printer abstractions
telemetry parsing
provider logic
fleet logic
storage logic

Do NOT create fake coverage tests.

E2E Testing

The application is cross-platform.

Use:

Playwright
Appium

appropriately.

E2E architecture should support:

Blazor WASM
MAUI desktop
mock printer environments

Do NOT overengineer.

Migration Strategy

This must be incremental.

DO NOT:

rewrite everything at once
break working features
delete old systems prematurely

Instead:

audit
understand
restructure
migrate
verify

feature-by-feature.

Deliverables
New /src architecture
Repository audit summary
Migration plan
New foundational projects
Migrated core abstractions
New provider/connection architecture
Initial cloud + edge agent foundations
Improved test structure
Buildable solution
Constraints
Keep existing functionality operational where possible
Prefer additive migration
Avoid speculative abstractions
Avoid unnecessary frameworks
Reuse working logic where appropriate
Preserve cross-platform support
Mental Model

...

</details>



<!-- START COPILOT CODING AGENT SUFFIX -->

Created from [VS Code](https://code.visualstudio.com/docs/copilot/copilot-coding-agent).

[akinbender]

@copilot # Agent Task: Complete Project Restructure with Logical Improvements

You are a senior .NET architect tasked with fully restructuring the MakerPrompt project. The repository began as a single-client desktop app, but it has since evolved into a cross-platform 3D print farm solution.

Your task is to create a brand-new project structure inside the existing repository under a new /src folder. After the full audit, we will move the entire functionality into this new structure.

Do not keep old code unless it logically fits—this is a full rethink.

---

Steps

1. Full System Audit:
   Examine every method, class, service, and feature in the current project. Identify:

   • Working logic
   • Incomplete or broken functionality
   • Duplication or dead code
   • Printer communication patterns
   • UI flows
   • Test coverage gaps

2. Design New Structure:
   Create a new project structure under /src with these core layers:

   • Core models and abstractions
   • Application services (business logic)
   • Infrastructure (communication, storage, etc.)
   • UI (Blazor for now, with future XAML MAUI planned)
   • Shared utilities
     Ensure a clean separation of concerns but minimal over-engineering.

3. Logical Improvements:
   Identify where the logic can be improved to handle multiple printers in a single interface (e.g., PrusaConnect). Restructure the code so that one communication interface can retrieve and handle multiple printers logically. Do this with minimal but purposeful changes.

4. Core Concepts:
   Ensure that the core abstractions and models are re-implemented in a clean, intuitive way. Move all logic that pertains to business rules, printer telemetry, and fleet management into appropriate layers. Avoid bloating the UI layer.

5. Edge Agent & Cloud:
   After the audit, build a local Edge Agent project that runs in your hackerspace environment. It gathers telemetry and webcam data and securely sends it to a cloud backend. Keep this modular but allow future cloud APIs for authenticated member access to telemetry.

6. Testing:
   Audit all existing unit tests for relevance. Identify missing coverage. After restructuring, ensure thorough unit tests for:

   • Application services
   • Printer communication logic
   • Fleet management
   • Telemetry handling
     Do not focus solely on trivial coverage—ensure tests make logical sense for each feature.

7. UI:
   Keep the existing Blazor-based web UI for now, but design the core logic

[Copilot]

@copilot # Agent Task: Complete Project Restructure with Logical Improvements

You are a senior .NET architect tasked with fully restructuring the MakerPrompt project. The repository began as a sing...

Done in commits 5f26419 (Phase 2) building on 10d2769 (Phase 1). Here's what was delivered across both phases:

/src architecture — completed layers

Layer	Project	What's in it
Domain	MakerPrompt.Core	IPrinterCommunicationService, IPrinterProvider, ITelemetryStore, IFilamentInventoryStore, IPrintJobAnalyticsStore, IPrintProjectRepository, IFarmRepository + all domain models
Application	MakerPrompt.Application	PrinterFleetService, TelemetryAggregationService, FilamentInventoryService, AnalyticsService, PrintProjectService, FarmService
Infrastructure	MakerPrompt.Infrastructure	In-memory implementations of all 5 stores (swap for SQLite/cloud in production)
Cloud host	MakerPrompt.Cloud	ASP.NET Core minimal API — telemetry ingest + retrieval endpoints
Edge Agent	MakerPrompt.EdgeAgent	.NET Worker Service — PrinterPollingWorker polls local printers, forwards telemetry
Tests	MakerPrompt.Tests.Unit	67 meaningful unit tests (fleet, telemetry, filament inventory, analytics, print projects, farm profiles, infrastructure stores)

Key architectural improvements made:

• IPrinterProvider (fleet enumeration) is now separate from IPrinterCommunicationService (single-printer control) — PrusaConnect / OctoPrint expose multiple printers through a provider, each controlled independently
• All business logic is in Application — no UI coupling
• Infrastructure references only Core (clean arch dependency rule enforced)
• Old MakerPrompt.Shared code is left untouched during this incremental migration

[akinbender]

@copilot oki whats next?

[Copilot]

@copilot oki whats next?

Here's what's left to complete the full restructure, in priority order:

Phase 3 — Blazor UI project under /src
Create MakerPrompt.UI.Blazor (Blazor WASM or Server) that references only Application and Core — no direct infrastructure coupling. Migrate pages: Fleet, Dashboard, FilamentInventory, Analytics, Settings. Wire up DI with the new Application services. This replaces the current MakerPrompt.Blazor host over time.

Phase 4 — Notification service + remaining application services
NotificationService (Application layer, backed by INotificationStore in Core) — model already exists. Also: ConnectionEncryptionService wrapper so credentials are never stored in plaintext even in the new structure.

Phase 5 — EdgeAgent: camera / webcam support
Add a ICameraProvider abstraction to Core + an MJPEG/RTSP implementation in Infrastructure. PrinterPollingWorker in EdgeAgent already polls telemetry — extend it to snapshot camera frames and forward alongside telemetry to the Cloud API.

Phase 6 — Cloud API: authentication + member access
Add JWT/API-key auth middleware to MakerPrompt.Cloud. Expose read-only telemetry endpoints for authenticated members. Optionally connect to a real time-series store (InfluxDB, SQLite) to replace the in-memory ring buffer.

Phase 7 — MAUI host under /src
Create MakerPrompt.UI.MAUI (BlazorWebView wrapping the same Razor components as Phase 3). This is the last step since it requires platform-specific serial backends to be ported.

Want me to start on Phase 3 (the Blazor UI project)?

[akinbender]

@copilot lets do phase 3&7 with updated infra. MAUI Serial backend is so important dont mess up pls!!
afterwards i would like you to tackle phase 6, API auth with OICD

[Copilot]

@copilot lets do phase 3&7 with updated infra. MAUI Serial backend is so important dont mess up pls!!
afterwards i would like you to tackle phase 6, API auth with OICD

Done in commits 717af83 and ab6e751. Here's what was built:

Phase 3 — MakerPrompt.UI.Blazor + MakerPrompt.UI.Components

• src/MakerPrompt.UI.Components — Razor class library (depends only on Core + Application): Fleet, Dashboard, FilamentInventory, Analytics, and Settings pages
• src/MakerPrompt.UI.Blazor — Blazor WASM host that wires all Application services + Infrastructure stores via DI and hosts the component library

Phase 7 — MakerPrompt.UI.MAUI

• SerialCommunicationServiceBase added to MakerPrompt.Infrastructure.Serial — implements the full new IPrinterCommunicationService contract; handles all Marlin G-code command building, response parsing, and telemetry polling; platform-specific transport is abstracted via three hooks (OpenTransportAsync, CloseTransportAsync, WriteTransportAsync)
• SerialCommunicationService (partial class) in MakerPrompt.UI.MAUI/Services/:
  • Windows — System.IO.Ports.SerialPort with async send/receive loops (same logic as existing MAUI project)
  • Android — UsbSerialForAndroid.Net driver (same package as existing project)
  • macOS — UsbSerialForMacOS driver (same package as existing project)
  • iOS — PlatformNotSupportedException stub (same behaviour as existing project)
• Default baud rate constant DefaultBaudRate = 250_000 lives in the base class and is shared across all platform files

Phase 6 — Cloud OIDC/JWT

• MakerPrompt.Cloud updated with Microsoft.AspNetCore.Authentication.JwtBearer
• Authority + Audience configurable via MakerPrompt:Auth:Authority/Audience (env or appsettings)
• Two policies: EdgeAgent (requires makerprompt:ingest scope — for EdgeAgent M2M tokens) and MemberRead (any authenticated user)
• /health stays anonymous; ingest endpoint requires EdgeAgent policy; read endpoints require MemberRead
• Dev fallback: when Authority is not set in Development, signature validation is skipped

[akinbender]

@copilot implement phase 5 and phase 6 for SQLlite and InfluxDB as possible providers

[Copilot]

@copilot implement phase 5 and phase 6 for SQLlite and InfluxDB as possible providers

Done in commit 029b86d. Here's what was built:

Phase 5 — Camera abstraction

• ICameraProvider, CameraSnapshot, ICameraSnapshotStore added to Core
• MjpegCameraProvider in Infrastructure — works with any OctoPrint/Mainsail/mjpg-streamer snapshot URL or live MJPEG stream; handles both image/jpeg responses and multipart/x-mixed-replace streams (extracts first JPEG frame via SOI/EOI marker scan)
• InMemoryCameraSnapshotStore — bounded ring buffer, history returns metadata-only (no JPEG blobs in memory)
• CameraPollingWorker in EdgeAgent — cameras configured via appsettings.json under EdgeAgent:Cameras[] (each entry: CameraId, Label, MjpegUrl); configurable CameraIntervalSeconds
• Cloud API: POST /api/camera/{id}/snapshot (EdgeAgent auth), GET /api/camera/{id}/latest (raw image/jpeg bytes), GET /api/camera/{id}/history (metadata array)

Phase 6 persistence — SQLite + InfluxDB

Project	What it does
MakerPrompt.Infrastructure.Sqlite	SqliteTelemetryStore + SqliteCameraSnapshotStore — no EF, raw Microsoft.Data.Sqlite. JSON payload column for schema-free telemetry. Async OpenAsync throughout.
MakerPrompt.Infrastructure.InfluxDb	InfluxDbTelemetryStore using InfluxDB.Client 5.0.0. Line Protocol with printer tags; Flux queries for latest/history. All string values escaped against Flux injection.

Swap the store at DI registration in EdgeAgent Program.cs or Cloud Program.cs — no Application or Core code changes required.

Tests: 82 total (15 new) — SqliteStoreTests uses a TempDb helper that creates an isolated temp file and deletes it on dispose; CameraStoreTests covers ring-buffer eviction and camera isolation.

[akinbender]

@copilot did you also consider tests for the newly implemented code?

[Copilot]

@copilot did you also consider tests for the newly implemented code?

Yes — 15 new tests were added alongside the Phase 5/6 code (commit 029b86d), bringing the total to 82 (all passing):

CameraStoreTests.cs (5 tests — InMemoryCameraSnapshotStore):

• Save/GetLatest round-trip
• Returns null when empty
• History excludes JPEG blob data (memory efficiency)
• Ring buffer drops oldest when full
• Camera IDs are isolated from each other

SqliteStoreTests.cs (10 tests — SqliteTelemetryStore + SqliteCameraSnapshotStore):

• Telemetry save/GetLatest round-trip with all fields
• GetLatest returns null on empty DB
• GetHistory ordered newest-first
• GetHistory respects count limit
• Printer IDs are isolated from each other
• GetLatest always returns the newest of multiple snapshots
• Camera save/GetLatest round-trip with JPEG blob
• Camera GetLatest returns null on empty DB
• Camera GetHistory strips JPEG blob (metadata only)
• Camera GetHistory respects count limit

Each SQLite test uses a TempDb helper that creates an isolated temp-file database and deletes it on dispose, so no test files accumulate on disk.