M1: add POV-Ray rendering backend

.github/workflows/amiga.yml

@@ -0,0 +1,43 @@
+name: Amiga build
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  amiga-build:
+    runs-on: ubuntu-latest
+    env:
+      AMIGA_DEV_IMAGE: ghcr.io/ploos-as/amiga-dev:edge
+      AMIGA_CPU_PROFILE: "68000"
+    steps:
+      - uses: actions/checkout@v4
+      - name: Pull amiga-dev
+        run: docker pull "$AMIGA_DEV_IMAGE"
+      - name: Verify amiga-dev contract
+        run: docker run --rm "$AMIGA_DEV_IMAGE" amiga-check
+      - name: Build and stage AmiRender Amiga client
+        run: |
+          mkdir -p amiga-runtime-payload/C amiga-runtime-payload/S
+          chmod 0777 amiga-runtime-payload/C
+          cp clients/amiga/runtime/amiga-runtime.json amiga-runtime-payload/
+          cp clients/amiga/runtime/run-test amiga-runtime-payload/S/
+          docker run --rm \
+            -e AMIGA_CPU_PROFILE="$AMIGA_CPU_PROFILE" \
+            -v "$PWD:/workspace:ro" \
+            -v "$PWD/amiga-runtime-payload/C:/out" \
+            "$AMIGA_DEV_IMAGE" \
+            amiga-build sh -ec 'cd /workspace/clients/amiga && make TARGET=/out/amirender CC=m68k-amigaos-gcc CFLAGS="$AMIGA_CPU_FLAGS -Os -Wall -Wextra -Werror" && test -s /out/amirender && amiga-inspect /out/amirender'
+          test -s amiga-runtime-payload/C/amirender
+      - name: Upload classic runtime payload
+        uses: actions/upload-artifact@v4
+        with:
+          name: amirender-m1-amiga-runtime-payload
+          path: amiga-runtime-payload/
+          if-no-files-found: error
+
+# M1 uses :edge as the consumer-integration gate. Pin to a qualified immutable
+# amiga-dev sha-* tag or digest before release qualification.

.github/workflows/ci.yml

@@ -3,14 +3,41 @@ on:
   push:
   pull_request:
 jobs:
-  m0:
+  m1:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-go@v5
         with:
           go-version: '1.22.x'
-      - run: gofmt -w cmd
+      - name: Install POV-Ray
+        run: |
+          sudo apt-get update
+          sudo DEBIAN_FRONTEND=noninteractive apt-get install -y povray
+      - run: gofmt -w cmd internal
       - run: git diff --exit-code
       - run: go test ./...
       - run: go build ./cmd/amirender-node ./cmd/amirender-controller
+      - name: Test portable Amiga client
+        run: |
+          cc -std=c99 -Wall -Wextra -Werror -pedantic \
+            -Iclients/amiga/include \
+            clients/amiga/src/submit.c clients/amiga/tests/test_submit.c \
+            -o build-amiga-client-test
+          ./build-amiga-client-test
+          cc -std=c99 -Wall -Wextra -Werror -pedantic \
+            -Iclients/amiga/include \
+            clients/amiga/src/upload.c clients/amiga/tests/test_upload.c \
+            -o build-amiga-upload-test
+          ./build-amiga-upload-test
+          cc -std=c99 -Wall -Wextra -Werror -pedantic \
+            -Iclients/amiga/include \
+            clients/amiga/src/submit.c clients/amiga/src/upload.c clients/amiga/src/client.c \
+            clients/amiga/tests/test_client.c \
+            -o build-amiga-transport-test
+          ./build-amiga-transport-test
+      - name: Render POV-Ray smoke scene
+        run: |
+          mkdir -p build
+          povray +Itests/scenes/m1-smoke.pov +Obuild/m1-smoke.png +W160 +H120 -D +FN
+          test -s build/m1-smoke.png

README.md

@@ -1,6 +1,6 @@
 # AmiRender
 
-A render accelerator appliance and distributed rendering system for classic Amiga workflows.
+A render accelerator appliance, distributed Linux render farm, and preservation bridge for classic 3D workflows.
 
 The Amiga is the workstation. AmiRender provides the modern compute.
 
@@ -28,6 +28,36 @@ AmiRender is intended to support, over time:
 - AmiTerrain
 - Ami3D
 - Blender/Cycles/Eevee as appliance/farm backends
+- Atari ST CAD-3D / Cyber Studio family
+- Freescape / 3D Construction Kit scenes from C64, Atari ST, and Amiga
+
+## Render modes
+
+AmiRender keeps preservation and enhancement as separate, explicit goals:
+
+- `original`: use the original renderer/software where practical, on original hardware or a qualified emulator/VM, preserving native scene and output formats.
+- `authentic`: reproduce the original platform renderer, palette, resolution, shading, and relevant limitations in an automatable AmiRender backend.
+- `enhanced`: preserve the source scene semantics in AmiRender IR and render with modern backends for the best practical result.
+
+Importers must preserve original values and metadata alongside normalized IR data. Import must not destructively "improve" source assets.
+
+Native formats are first-class preservation inputs/outputs. Planned examples include Atari CAD-3D/Cyber formats and Freescape/3D Construction Kit data. Modern interchange formats are additional outputs, not replacements for native-format support.
+
+## Render farm
+
+POV-Ray and Blender are first-class modern Linux farm backends. The scheduler is intended to support amd64 and ARM64 CPU workers and GPU-capable workers where the backend supports them. Retro scene import is independent of the renderer: a preserved classic scene may be rendered in original/authentic mode or sent through the same modern farm in enhanced mode.
+
+## Landscape roadmap
+
+Landscape generation is a first-class render source, with AmiTerrain owning terrain semantics and format compatibility.
+
+- Preserve Vista/VistaPro, Scenery Animator, World Construction Set and other supported classic landscape inputs through AmiTerrain.
+- Render preserved landscape scenes in `original`, `authentic`, or `enhanced` mode.
+- Accept AmiTerrain Terrain IR without discarding native source metadata.
+- Use POV-Ray and Blender/Cycles/Eevee as modern Linux farm targets for enhanced landscape rendering.
+- Support modern open-source terrain workflows through AmiTerrain interchange, including TerraForge3D, Blender terrain/erosion workflows, generic heightmaps, meshes and DEM/GIS-derived terrain.
+- Keep reverse conversion possible where representable: modern terrain may be reduced/quantized into formats usable by original classic landscape software.
+- AmiRender does not replace AmiTerrain's importers or generators; it schedules and renders their outputs.
 
 ## User experience
 

clients/amiga/Makefile

@@ -0,0 +1,21 @@
+CC = m68k-amigaos-gcc
+CFLAGS ?= -O2 -Wall -Wextra
+CPPFLAGS ?= -Iinclude
+TARGET ?= amirender
+
+SOURCES = \
+	src/submit.c \
+	src/upload.c \
+	src/client.c \
+	src/bsdsocket_amiga.c \
+	src/main_amiga.c
+
+.PHONY: all clean
+
+all: $(TARGET)
+
+$(TARGET): $(SOURCES)
+	$(CC) $(CPPFLAGS) $(CFLAGS) $(SOURCES) -o $@
+
+clean:
+	rm -f $(TARGET)

clients/amiga/README.md

@@ -0,0 +1,25 @@
+# AmiRender Amiga client
+
+This directory contains the first AmigaOS/m68k submission client components.
+
+M1 deliberately separates the portable wire-protocol builder from networking. The
+portable C layer builds the same newline-delimited JSON `SUBMIT` message accepted
+by `amirender-node`. The Amiga transport layer will use `bsdsocket.library`.
+
+The protocol builder rejects control characters, quotes and backslashes in text
+fields rather than attempting incomplete JSON escaping. A later protocol utility
+may add full escaping.
+
+Target integration:
+
+```text
+Amiga application / CLI / ARexx
+             |
+     portable submit builder
+             |
+       bsdsocket.library
+             |
+       AmiRender node
+```
+
+No proprietary AmigaOS or Kickstart files belong in this repository.

clients/amiga/docs/BUILD-AMIGA.md

@@ -0,0 +1,29 @@
+# Building the AmigaOS/m68k client
+
+The portable client code is tested by the normal Linux CI. The Amiga-specific
+transport lives in `src/bsdsocket_amiga.c` and targets an AmigaOS-compatible
+m68k toolchain with `bsdsocket.library` development headers.
+
+Expected source set:
+
+```text
+src/submit.c
+src/client.c
+src/bsdsocket_amiga.c
+```
+
+The transport opens `bsdsocket.library` version 4, resolves the controller or
+worker host with `gethostbyname()`, creates an IPv4 TCP socket and exposes it
+through the portable `amirender_transport` interface.
+
+The default AmiRender TCP port is 6800.
+
+## Qualification
+
+M1 qualification should compile this source with the Ploos `amiga-dev` Bebbo
+toolchain, then execute the resulting m68k client in `amiga-runtime` against a
+real AmiRender node. Runtime qualification must use an m68k Amiga environment;
+AROS/i386 is not a substitute for this gate.
+
+No Kickstart ROM, AmigaOS installation, or other proprietary system file is
+stored in this repository.

clients/amiga/include/amirender_bsdsocket.h

@@ -0,0 +1,18 @@
+#ifndef AMIRENDER_BSDSOCKET_H
+#define AMIRENDER_BSDSOCKET_H
+
+#include "amirender_transport.h"
+
+struct amirender_bsdsocket {
+    int socket_fd;
+};
+
+int amirender_bsdsocket_connect(
+    struct amirender_bsdsocket *socket,
+    const char *host,
+    unsigned short port,
+    struct amirender_transport *transport);
+
+void amirender_bsdsocket_close(struct amirender_bsdsocket *socket);
+
+#endif

clients/amiga/include/amirender_submit.h

@@ -0,0 +1,18 @@
+#ifndef AMIRENDER_SUBMIT_H
+#define AMIRENDER_SUBMIT_H
+
+#include <stddef.h>
+
+struct amirender_job {
+    const char *id;
+    const char *engine;
+    const char *scene;
+    const char *output;
+    int frame;
+    int width;
+    int height;
+};
+
+int amirender_build_submit(char *buffer, size_t size, const struct amirender_job *job);
+
+#endif

clients/amiga/include/amirender_transport.h

@@ -0,0 +1,70 @@
+#ifndef AMIRENDER_TRANSPORT_H
+#define AMIRENDER_TRANSPORT_H
+
+#include <stddef.h>
+
+struct amirender_job;
+
+struct amirender_transport {
+    void *context;
+    int (*send)(void *context, const char *data, size_t length);
+    int (*receive)(void *context, char *buffer, size_t size);
+};
+
+int amirender_upload_asset(
+    struct amirender_transport *transport,
+    const char *name,
+    const unsigned char *data,
+    size_t data_size,
+    char *asset,
+    size_t asset_size);
+
+int amirender_download_asset(
+    struct amirender_transport *transport,
+    const char *asset,
+    unsigned char *data,
+    size_t data_size,
+    size_t *received_size);
+
+int amirender_upload_begin(
+    struct amirender_transport *transport,
+    const char *name,
+    size_t total_size,
+    char *asset,
+    size_t asset_size);
+
+int amirender_upload_chunk(
+    struct amirender_transport *transport,
+    const char *asset,
+    size_t offset,
+    const unsigned char *data,
+    size_t data_size);
+
+int amirender_upload_end(
+    struct amirender_transport *transport,
+    const char *asset,
+    size_t total_size);
+
+int amirender_download_chunk(
+    struct amirender_transport *transport,
+    const char *asset,
+    size_t offset,
+    unsigned char *data,
+    size_t data_size,
+    size_t *received_size,
+    int *eof);
+
+int amirender_submit_job(
+    struct amirender_transport *transport,
+    const struct amirender_job *job,
+    char *reply,
+    size_t reply_size);
+
+int amirender_extract_output_asset(
+    const char *reply, char *asset, size_t asset_size);
+
+int amirender_download_file(
+    struct amirender_transport *transport, const char *asset,
+    const char *path, size_t *total_size);
+
+#endif

clients/amiga/include/amirender_upload.h

@@ -0,0 +1,13 @@
+#ifndef AMIRENDER_UPLOAD_H
+#define AMIRENDER_UPLOAD_H
+
+#include <stddef.h>
+
+int amirender_build_upload(
+    char *buffer,
+    size_t size,
+    const char *name,
+    const unsigned char *data,
+    size_t data_size);
+
+#endif

clients/amiga/runtime/amiga-runtime.json

@@ -0,0 +1,25 @@
+{
+  "schema": 1,
+  "project": "AmiRender",
+  "milestone": "M1-amiga-client",
+  "architecture": "m68k",
+  "cpu": "68000",
+  "os": "AmigaOS",
+  "emulator_profiles": ["a500-os204", "a500plus-os2", "a1200-020-os3"],
+  "payload": {
+    "programs": ["C/amirender"],
+    "script": "S/run-test"
+  },
+  "result": {
+    "logs": ["T/amirender.log"],
+    "required_lines": ["AMIRENDER_EXEC=PASS", "AMIRENDER_USAGE_RC=20"]
+  },
+  "policy": {
+    "roms_in_repository": false,
+    "amigaos_files_in_repository": false
+  },
+  "requirements": {
+    "network": false,
+    "bsdsocket_library": true
+  }
+}

clients/amiga/runtime/run-test

@@ -0,0 +1,14 @@
+; AmiRender M1 classic runtime smoke test
+; The client is intentionally invoked without arguments.
+; Exit code 20 proves the m68k executable reached its CLI validation path.
+
+C:amirender >T:amirender-cli.out
+SET rc $RC
+
+ECHO "AMIRENDER_USAGE_RC=$rc" >T:amirender.log
+
+IF $rc EQ 20
+  ECHO "AMIRENDER_EXEC=PASS" >>T:amirender.log
+ELSE
+  ECHO "AMIRENDER_EXEC=FAIL" >>T:amirender.log
+ENDIF