Merge branch 'codex/regulatory-compatibility-sweep'

alpha912 · alpha912 · commit edc01aa770d2 · 2026-03-08T09:50:40.000Z
# Conflicts:
#	src/routes/federation.ts
#	src/schemas/handshake.schema.json
#	src/schemas/match.schema.json
#	src/schemas/material-dna.schema.json
#	src/schemas/material-status.schema.json
#	src/schemas/offer.schema.json
#	src/schemas/transfer.schema.json
#	tests/federation.routes.test.ts
#	tests/loop.routes.test.ts
diff --git a/.env.docker.example b/.env.docker.example
@@ -1,7 +1,7 @@
 PORT=8088
 PUBLIC_BASE_URL=https://loop-api.urbnia.com
 NODE_ID=lab-hub.loop
-NODE_NAME=LocalLoop Lab Hub
+NODE_NAME=localLOOP Lab Hub
 NODE_CAPABILITIES=material-registry,lab-relay
 
 # Postgres
diff --git a/.env.example b/.env.example
@@ -1,4 +1,4 @@
-# LocalLoop Backend Environment Configuration
+# localLOOP Backend Environment Configuration
 # Copy to .env and modify values as needed
 
 # IMPORTANT: In production (NODE_ENV=production), you MUST set:
@@ -12,7 +12,7 @@ NODE_ENV=development
 PORT=8088
 PUBLIC_BASE_URL=https://loop-api.urbnia.com
 NODE_ID=lab-hub.loop
-NODE_NAME=LocalLoop Lab Hub
+NODE_NAME=localLOOP Lab Hub
 NODE_CAPABILITIES=material-registry,lab-relay
 
 # Postgres
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
@@ -28,7 +28,7 @@ Project maintainers may remove, edit, or reject contributions that violate this
 
 ## Reporting
 
-Report violations to: alphinctom@gmail.com (GitHub: @alpha912)
+Report violations to: alphin@mycel-ai.de (GitHub: @alpha912)
 
 ## Attribution
 
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -1,4 +1,4 @@
-# Contributing to LocalLoop Backend
+# Contributing to localLOOP Backend
 
 Thanks for your interest in contributing! This backend is intentionally small and focused.
 
@@ -20,4 +20,4 @@ bun run dev
 - [ ] No secrets committed
 
 ## Contact
-Questions? Email alphinctom@gmail.com or open a GitHub Discussion.
+Questions? Email alphin@mycel-ai.de or open a GitHub Discussion.
diff --git a/DOMAIN-POLICY.md b/DOMAIN-POLICY.md
@@ -1,6 +1,6 @@
 # Domain Policy
 
-This backend serves the LocalLoop lab demo and public APIs.
+This backend serves the localLOOP lab demo and public APIs.
 
 ## Canonical domains
 
diff --git a/LICENSE b/LICENSE
@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025-2026 Alphin Tom
+Copyright (c) 2025-2026 Alphin Tom / Mycel UG (haftungsbeschränkt)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
diff --git a/README.md b/README.md
@@ -1,6 +1,6 @@
-# LocalLoop Backend
+# localLOOP Backend
 
-Backend service for collecting and publishing Expressions of Interest for the LocalLoop protocol.
+Backend service for collecting and publishing Expressions of Interest for the localLOOP platform.
 
 > This project is an early, low-TRL concept. There are no public pilots or deployments. Lab demo only.
 
@@ -27,8 +27,8 @@ bun test
 - `POST /api/interest`: submit an Expression of Interest.
 - `GET /api/interest`: list Expressions of Interest.
 - `GET /api/interest/stream`: SSE stream for new interest.
-- `GET /api/loop/stream`: SSE stream for lab demo flow.
-- `POST /api/loop/material-status`: record a material status update (lab demo).
+- `GET /api/v1/stream`: SSE stream for lab demo flow.
+- `POST /api/v1/material-status`: record a material status update (lab demo).
 - `GET /api/metrics`: service metrics.
 
 LOOP interop write routes accept `application/ld+json` as the preferred content type.
diff --git a/SECURITY.md b/SECURITY.md
@@ -2,12 +2,12 @@
 
 ## Reporting a Vulnerability
 
-Please report security issues by emailing **alphinctom@gmail.com** (GitHub: @alpha912).
+Please report security issues by emailing **alphin@mycel-ai.de** (GitHub: @alpha912).
 Do not open public issues for security-sensitive reports.
 
 ## Scope
 
-This repository contains the LocalLoop backend API. All dependencies and server logic
+This repository contains the localLOOP backend API. All dependencies and server logic
 are in scope.
 
 ## Response Timeline
diff --git a/deploy/localloop-backend.service b/deploy/localloop-backend.service
@@ -1,5 +1,5 @@
 [Unit]
-Description=LocalLoop Backend API
+Description=localLOOP Backend API
 After=network.target postgresql.service redis.service
 Wants=postgresql.service redis.service
 
diff --git a/deploy/setup.sh b/deploy/setup.sh
@@ -1,5 +1,5 @@
 #!/bin/bash
-# LocalLoop Backend Deployment Setup Script
+# localLOOP Backend Deployment Setup Script
 # This script provisions the non-root user and sets up the deployment environment.
 # Run as root: sudo bash deploy/setup.sh
 
@@ -9,7 +9,7 @@ INSTALL_DIR="${INSTALL_DIR:-/opt/localloop-backend}"
 SERVICE_USER="${SERVICE_USER:-localloop}"
 SERVICE_GROUP="${SERVICE_GROUP:-localloop}"
 
-echo "=== LocalLoop Backend Deployment Setup ==="
+echo "=== localLOOP Backend Deployment Setup ==="
 echo "Install directory: $INSTALL_DIR"
 echo "Service user: $SERVICE_USER"
 echo ""
diff --git a/package.json b/package.json
@@ -2,7 +2,8 @@
   "name": "@local-loop/localloop-backend",
   "version": "0.2.0",
   "private": true,
-  "description": "Backend API for LocalLoop expression-of-interest submissions",
+  "description": "Backend API for localLOOP expression-of-interest submissions",
+  "author": "Alphin Tom / Mycel UG (haftungsbeschränkt) <alphin@mycel-ai.de>",
   "license": "MIT",
   "type": "module",
   "engines": {
diff --git a/scripts/simulate-federation.ts b/scripts/simulate-federation.ts
@@ -31,7 +31,7 @@ const relayEvent = async (
   baseUrl: string,
   event: { event_type: string; entity_type: string; entity_id: string; payload: Record<string, unknown> },
   sourceNode: string,
-) => postJson(`${baseUrl}/api/loop/relay`, { ...event, source_node: sourceNode });
+) => postJson(`${baseUrl}/api/v1/relay`, { ...event, source_node: sourceNode });
 
 export async function runFederationSimulation(
   nodeAUrl = process.env.LOOP_NODE_A_URL ?? `http://localhost:${config.port}`,
@@ -53,7 +53,7 @@ export async function runFederationSimulation(
     available_from: now.toISOString(),
   };
 
-  const materialCreated = await postJson(`${nodeAUrl}/api/loop/materials`, material);
+  const materialCreated = await postJson(`${nodeAUrl}/api/v1/material`, material);
   timeline.push({ label: 'MaterialDNA registered', node: 'Node A', id: materialCreated.id, createdAt: materialCreated.created_at });
   await relayEvent(nodeBUrl, {
     event_type: 'material.created',
@@ -77,7 +77,7 @@ export async function runFederationSimulation(
     terms: 'Lab federation demo pickup',
   };
 
-  const offerCreated = await postJson(`${nodeAUrl}/api/loop/offers`, offer);
+  const offerCreated = await postJson(`${nodeAUrl}/api/v1/offer`, offer);
   timeline.push({ label: 'Offer published', node: 'Node A', id: offerCreated.id, createdAt: offerCreated.created_at });
   await relayEvent(nodeBUrl, {
     event_type: 'offer.created',
@@ -100,7 +100,7 @@ export async function runFederationSimulation(
     matched_at: new Date(now.getTime() + 1000 * 60 * 60).toISOString(),
   };
 
-  const matchCreated = await postJson(`${nodeAUrl}/api/loop/matches`, match);
+  const matchCreated = await postJson(`${nodeAUrl}/api/v1/match`, match);
   timeline.push({ label: 'Match accepted', node: 'Node A', id: matchCreated.id, createdAt: matchCreated.created_at });
   await relayEvent(nodeBUrl, {
     event_type: 'match.created',
@@ -123,7 +123,7 @@ export async function runFederationSimulation(
     route: { from_city: 'DEMO Munich', to_city: 'DEMO Berlin', mode: 'road' },
   };
 
-  const transferCreated = await postJson(`${nodeAUrl}/api/loop/transfers`, transfer);
+  const transferCreated = await postJson(`${nodeAUrl}/api/v1/transfer`, transfer);
   timeline.push({ label: 'Transfer completed', node: 'Node A', id: transferCreated.id, createdAt: transferCreated.created_at });
   await relayEvent(nodeBUrl, {
     event_type: 'transfer.created',
diff --git a/scripts/simulate-lab.ts b/scripts/simulate-lab.ts
@@ -31,7 +31,7 @@ export async function runLabSimulation(baseUrl = `http://localhost:${config.port
     available_from: now.toISOString(),
   };
 
-  const materialResponse = await fetch(`${baseUrl}/api/loop/materials`, {
+  const materialResponse = await fetch(`${baseUrl}/api/v1/material`, {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
     body: JSON.stringify(material),
@@ -56,7 +56,7 @@ export async function runLabSimulation(baseUrl = `http://localhost:${config.port
     terms: 'Lab demo pickup',
   };
 
-  const offerResponse = await fetch(`${baseUrl}/api/loop/offers`, {
+  const offerResponse = await fetch(`${baseUrl}/api/v1/offer`, {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
     body: JSON.stringify(offer),
@@ -80,7 +80,7 @@ export async function runLabSimulation(baseUrl = `http://localhost:${config.port
     matched_at: new Date(now.getTime() + 1000 * 60 * 60).toISOString(),
   };
 
-  const matchResponse = await fetch(`${baseUrl}/api/loop/matches`, {
+  const matchResponse = await fetch(`${baseUrl}/api/v1/match`, {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
     body: JSON.stringify(match),
@@ -104,7 +104,7 @@ export async function runLabSimulation(baseUrl = `http://localhost:${config.port
     route: { from_city: 'DEMO Munich', to_city: 'DEMO Berlin', mode: 'road' },
   };
 
-  const transferResponse = await fetch(`${baseUrl}/api/loop/transfers`, {
+  const transferResponse = await fetch(`${baseUrl}/api/v1/transfer`, {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
     body: JSON.stringify(transfer),
diff --git a/src/config.ts b/src/config.ts
@@ -51,7 +51,7 @@ const envSchema = z.object({
   MINIO_USE_SSL: z.string().optional(),
   PUBLIC_BASE_URL: z.string().default('https://loop-api.urbnia.com'),
   NODE_ID: z.string().default('lab-hub.loop'),
-  NODE_NAME: z.string().default('LocalLoop Lab Hub'),
+  NODE_NAME: z.string().default('localLOOP Lab Hub'),
   NODE_CAPABILITIES: z.string().default('material-registry,lab-relay'),
   AUTH_TRUSTED_ORIGINS: z.string().optional(),
   BETTER_AUTH_SECRET: z.string().optional(),
diff --git a/src/routes/docs.ts b/src/routes/docs.ts
@@ -12,7 +12,7 @@ export async function registerDocsRoutes(app: FastifyInstance) {
   <head>
     <meta charset="utf-8"/>
     <meta name="viewport" content="width=device-width, initial-scale=1"/>
-    <title>LocalLoop API Docs</title>
+    <title>localLOOP API Docs</title>
     <style>body { margin: 0; }</style>
   </head>
   <body>
diff --git a/src/routes/federation.ts b/src/routes/federation.ts
@@ -50,7 +50,7 @@ const defaultDeps: FederationDeps = {
 export async function registerFederationRoutes(app: FastifyInstance, deps: FederationDeps = defaultDeps) {
   registerFederationSchemas(app);
 
-  app.get('/api/federation/nodes', {
+  app.get('/api/v1/federation/nodes', {
     schema: {
       response: {
         200: listResponseSchema,
@@ -64,7 +64,7 @@ export async function registerFederationRoutes(app: FastifyInstance, deps: Feder
     };
   });
 
-  app.post('/api/federation/handshake', {
+  app.post('/api/v1/federation/handshake', {
     config: { rateLimit: writeRateLimit },
     schema: {
       consumes: ['application/json', loopContentType],
@@ -97,7 +97,7 @@ export async function registerFederationRoutes(app: FastifyInstance, deps: Feder
 
     const local = deps.getLocalNode();
     reply.code(202).send({
-      '@context': 'https://local-loop-io.github.io/projects/loop-protocol/contexts/loop-v0.1.1.jsonld',
+      '@context': 'https://local-loop-io.github.io/projects/loop-protocol/contexts/loop-v0.2.0.jsonld',
       '@type': 'NodeHandshakeResponse',
       schema_version: '0.1.1',
       status: 'accepted',
diff --git a/src/routes/loop.ts b/src/routes/loop.ts
@@ -142,7 +142,7 @@ function sendWriteConflict(error: unknown, reply: FastifyReply) {
 }
 
 export async function registerLoopRoutes(app: FastifyInstance, deps: LoopDeps = defaultDeps) {
-  app.post('/api/loop/materials', {
+  app.post('/api/v1/material', {
     config: { rateLimit: writeRateLimit },
     schema: {
       consumes: ['application/json', loopContentType],
@@ -187,7 +187,7 @@ export async function registerLoopRoutes(app: FastifyInstance, deps: LoopDeps =
     reply.code(201).send(created);
   });
 
-  app.post('/api/loop/offers', {
+  app.post('/api/v1/offer', {
     config: { rateLimit: writeRateLimit },
     schema: {
       consumes: ['application/json', loopContentType],
@@ -237,7 +237,7 @@ export async function registerLoopRoutes(app: FastifyInstance, deps: LoopDeps =
     reply.code(201).send(created);
   });
 
-  app.post('/api/loop/matches', {
+  app.post('/api/v1/match', {
     config: { rateLimit: writeRateLimit },
     schema: {
       consumes: ['application/json', loopContentType],
@@ -296,7 +296,7 @@ export async function registerLoopRoutes(app: FastifyInstance, deps: LoopDeps =
     reply.code(201).send(created);
   });
 
-  app.post('/api/loop/transfers', {
+  app.post('/api/v1/transfer', {
     config: { rateLimit: writeRateLimit },
     schema: {
       consumes: ['application/json', loopContentType],
@@ -355,7 +355,7 @@ export async function registerLoopRoutes(app: FastifyInstance, deps: LoopDeps =
     reply.code(201).send(created);
   });
 
-  app.post('/api/loop/material-status', {
+  app.post('/api/v1/material-status', {
     config: { rateLimit: writeRateLimit },
     schema: {
       consumes: ['application/json', loopContentType],
@@ -400,7 +400,7 @@ export async function registerLoopRoutes(app: FastifyInstance, deps: LoopDeps =
     reply.code(201).send({ id: payload.id, created_at: created.created_at });
   });
 
-  app.get('/api/loop/events', {
+  app.get('/api/v1/events', {
     schema: {
       querystring: {
         type: 'object',
@@ -419,11 +419,11 @@ export async function registerLoopRoutes(app: FastifyInstance, deps: LoopDeps =
     return { results };
   });
 
-  app.get('/api/loop/stream', async (request, reply) => {
+  app.get('/api/v1/stream', async (request, reply) => {
     registerLoopStream(request, reply);
   });
 
-  app.post('/api/loop/relay', {
+  app.post('/api/v1/relay', {
     config: { rateLimit: writeRateLimit },
     schema: {
       consumes: ['application/json', loopContentType],
diff --git a/src/routes/privacy.ts b/src/routes/privacy.ts
@@ -8,7 +8,7 @@ const privacyPayload = {
     'Interest submissions are optional and explicitly consent-based.',
   ],
   retention: 'Lab demo data is retained only for validation and removed on request.',
-  contact: 'alphinctom@gmail.com',
+  contact: 'alphin@mycel-ai.de',
 };
 
 export async function registerPrivacyRoutes(app: FastifyInstance) {
diff --git a/src/schemas/handshake.schema.json b/src/schemas/handshake.schema.json
@@ -1,8 +1,8 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://local-loop-io.github.io/projects/loop-protocol/schemas/v0.1.1/handshake.schema.json",
+  "$id": "https://local-loop-io.github.io/projects/loop-protocol/schemas/v0.2.0/handshake.schema.json",
   "title": "NodeHandshake",
-  "description": "Lab-only federation handshake payload for LOOP Protocol v0.1.1",
+  "description": "Federation handshake schema — LOOP v0.2.0",
   "oneOf": [
     {
       "$ref": "#/definitions/HandshakeRequest"
@@ -27,15 +27,18 @@
       "properties": {
         "@context": {
           "type": "string",
-          "const": "https://local-loop-io.github.io/projects/loop-protocol/contexts/loop-v0.1.1.jsonld"
+          "enum": [
+            "https://local-loop-io.github.io/projects/loop-protocol/contexts/loop-v0.1.1.jsonld",
+            "https://local-loop-io.github.io/projects/loop-protocol/contexts/loop-v0.2.0.jsonld"
+          ]
         },
         "@type": {
           "type": "string",
           "const": "NodeHandshake"
         },
         "schema_version": {
           "type": "string",
-          "const": "0.1.1"
+          "pattern": "^0\\.[1-9]\\d*\\.\\d+$"
         },
         "node_id": {
           "type": "string",
@@ -106,15 +109,18 @@
       "properties": {
         "@context": {
           "type": "string",
-          "const": "https://local-loop-io.github.io/projects/loop-protocol/contexts/loop-v0.1.1.jsonld"
+          "enum": [
+            "https://local-loop-io.github.io/projects/loop-protocol/contexts/loop-v0.1.1.jsonld",
+            "https://local-loop-io.github.io/projects/loop-protocol/contexts/loop-v0.2.0.jsonld"
+          ]
         },
         "@type": {
           "type": "string",
           "const": "NodeHandshakeResponse"
         },
         "schema_version": {
           "type": "string",
-          "const": "0.1.1"
+          "pattern": "^0\\.[1-9]\\d*\\.\\d+$"
         },
         "status": {
           "type": "string",
diff --git a/src/schemas/match.schema.json b/src/schemas/match.schema.json
diff --git a/src/schemas/material-dna.schema.json b/src/schemas/material-dna.schema.json
diff --git a/src/schemas/material-status.schema.json b/src/schemas/material-status.schema.json
diff --git a/src/schemas/offer.schema.json b/src/schemas/offer.schema.json
diff --git a/src/schemas/transfer.schema.json b/src/schemas/transfer.schema.json
diff --git a/src/server.ts b/src/server.ts
diff --git a/tests/apiKey.routes.test.ts b/tests/apiKey.routes.test.ts
diff --git a/tests/federation.routes.test.ts b/tests/federation.routes.test.ts
diff --git a/tests/loop.routes.test.ts b/tests/loop.routes.test.ts
