Initial push

2026-06-13 09:58:58 -04:00
parent e386b0c17d
commit 6655102f44
5 changed files with 330 additions and 22 deletions
--- a/hubzilla/addon/scn01/scn01_spool.php
+++ b/hubzilla/addon/scn01/scn01_spool.php
@@ -0,0 +1,150 @@
+<?php
+
+/**
+ * SCN-01 Spool Handler
+ * Validates POST submissions, builds the spool envelope,
+ * and POSTs to the orchestrator receiver.
+ * Records are immutable — no edit path.
+ */
+
+// ---------------------------------------------------------------------------
+// POST HANDLER
+// ---------------------------------------------------------------------------
+
+function scn01_handle_post($association_slug, $access) {
+    $narrative = isset($_POST['narrative'])
+        ? substr(strip_tags((string) $_POST['narrative']), 0, 8192)
+        : '';
+
+    $raw_pinned = $_POST['pinned_scenario_ids'] ?? [];
+    $pinned = [];
+    if (is_array($raw_pinned)) {
+        $valid_ids = array_column(scn01_load_scenarios(), 'id');
+        foreach ($raw_pinned as $id) {
+            $id = trim((string) $id);
+            if (in_array($id, $valid_ids, true) && !in_array($id, $pinned, true)) {
+                $pinned[] = $id;
+            }
+        }
+        $pinned = array_slice($pinned, 0, 5);
+    }
+
+    if ($narrative === '') {
+        $out  = '<div class="alert alert-danger"><strong>Please describe your situation before submitting.</strong></div>';
+        $out .= scn01_render_landing($association_slug, $access);
+        return $out;
+    }
+
+    $cfg_raw = @file_get_contents('addon/vs01/config.json');
+    $cfg     = $cfg_raw ? json_decode($cfg_raw, true) : [];
+    $assoc   = $cfg['associations'][$association_slug] ?? [];
+
+    $envelope = scn01_build_spool_envelope(
+        $narrative,
+        $pinned,
+        $association_slug,
+        $assoc['channel_id'] ?? '',
+        $access
+    );
+
+    $result = scn01_post_to_orchestrator($envelope);
+
+    if ($result === true) {
+        $assoc_name = scn01_h($assoc['name'] ?? $association_slug);
+        return '<div class="scn01-content">
+                    <div class="alert alert-success">
+                        Your account for ' . $assoc_name . ' has been submitted. Records cannot be edited —
+                        if you want to add more later, submit a new record.
+                        <a href="' . z_root() . '/vs01/' . scn01_h($association_slug) . '">
+                            Return to ' . $assoc_name . '
+                        </a>
+                    </div>
+                </div>';
+    }
+
+    $out  = '<div class="alert alert-danger">
+                Submission failed. Please try again or contact the operator.
+                <br><small>' . scn01_h($result) . '</small>
+            </div>';
+    $out .= scn01_render_landing($association_slug, $access);
+    return $out;
+}
+
+// ---------------------------------------------------------------------------
+// SPOOL ENVELOPE
+// ---------------------------------------------------------------------------
+
+function scn01_build_spool_envelope($narrative, $pinned_scenario_ids, $association_slug, $channel_id, $standing) {
+    return [
+        'addon'                   => 'scn01',
+        'contract_version'        => '1.0',
+        'association_slug'        => $association_slug,
+        'association_channel_id'  => (string) $channel_id,
+        'submitted_at'            => date('c'),
+        'standing'                => $standing,
+        'pinned_scenario_ids'     => $pinned_scenario_ids,
+        'narrative'               => $narrative,
+    ];
+}
+
+// ---------------------------------------------------------------------------
+// ORCHESTRATOR POST
+// ---------------------------------------------------------------------------
+
+function scn01_post_to_orchestrator($envelope) {
+    $config       = scn01_load_config();
+    $receiver_url = $config['receiver_url'] ?? '';
+    $node_token   = $config['node_token'] ?? '';
+
+    if (!$receiver_url) {
+        logger('scn01_spool: receiver_url not configured');
+        return 'Orchestrator receiver URL not configured.';
+    }
+
+    $payload = json_encode($envelope);
+    if ($payload === false) {
+        logger('scn01_spool: failed to encode envelope');
+        return 'Failed to encode submission.';
+    }
+
+    $ch = curl_init($receiver_url);
+    curl_setopt_array($ch, [
+        CURLOPT_POST           => true,
+        CURLOPT_POSTFIELDS     => $payload,
+        CURLOPT_RETURNTRANSFER => true,
+        CURLOPT_TIMEOUT        => 10,
+        CURLOPT_HTTPHEADER     => [
+            'Content-Type: application/json',
+            'X-Node-Token: ' . $node_token,
+        ],
+    ]);
+
+    $response   = curl_exec($ch);
+    $http_code  = curl_getinfo($ch, CURLINFO_HTTP_CODE);
+    $curl_error = curl_error($ch);
+    curl_close($ch);
+
+    if ($curl_error) {
+        logger('scn01_spool: curl error: ' . $curl_error);
+        return 'Network error: ' . $curl_error;
+    }
+
+    if ($http_code === 200 || $http_code === 201) {
+        return true;
+    }
+
+    logger('scn01_spool: orchestrator returned HTTP ' . $http_code . ': ' . $response);
+    return 'Orchestrator error (HTTP ' . $http_code . ').';
+}
+
+// ---------------------------------------------------------------------------
+// CONFIG
+// ---------------------------------------------------------------------------
+
+function scn01_load_config() {
+    $path = 'addon/scn01/config.json';
+    $raw  = @file_get_contents($path);
+    if ($raw === false) return [];
+    $data = json_decode($raw, true);
+    return (json_last_error() === JSON_ERROR_NONE) ? $data : [];
+}