From c92676194fadf8edaef6cbdda63f4472bb05e4b8 Mon Sep 17 00:00:00 2001
From: Joshua <vsg@Joshuas-Mac-Studio.local>
Date: Wed, 18 Feb 2026 20:31:12 -0800
Subject: [PATCH] Capture explicit operation mode in launcher install flow

---
 README.md                    | 2 +-
 app/app.js                   | 5 +++++
 app/index.html               | 7 +++++++
 docs/integration-contract.md | 5 +++++
 4 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 1ec71d2..55518ac 100644
--- a/README.md
+++ b/README.md
@@ -44,7 +44,7 @@ Advanced integration controls (collapsible):
 3. Membership quote + confirm primitives
 4. Marketplace offer list + checkout quote/send/confirm primitives
 5. Member channel register/poll primitives
-6. Governance install + lease primitives
+6. Governance install + lease primitives (with explicit `operation_mode`)
 7. Raw response log for deterministic troubleshooting
 
 Wallet automation helpers remain available in advanced controls:
diff --git a/app/app.js b/app/app.js
index c292e33..d645059 100644
--- a/app/app.js
+++ b/app/app.js
@@ -198,6 +198,10 @@ function principalRole() {
   return $("principalRole").value.trim();
 }
 
+function operationMode() {
+  return $("operationMode").value.trim() || "human_manual";
+}
+
 function renderEvents(events) {
   const list = $("eventList");
   list.innerHTML = "";
@@ -693,6 +697,7 @@ async function onInstallConfirm() {
     entitlement_id: $("entitlementId").value.trim(),
     package_hash: $("packageHash").value.trim(),
     runtime_version: $("runtimeVersion").value.trim(),
+    operation_mode: operationMode(),
     installed_at: nowISO(),
     launcher_receipt_hash: `receipt-${Date.now()}`,
   });
diff --git a/app/index.html b/app/index.html
index 53b85f8..f01916f 100644
--- a/app/index.html
+++ b/app/index.html
@@ -314,6 +314,13 @@
                 <input id="runtimeVersion" />
               </label>
             </div>
+            <label>
+              Operation mode
+              <select id="operationMode">
+                <option value="human_manual">human_manual</option>
+                <option value="worker_auto">worker_auto</option>
+              </select>
+            </label>
             <label>
               Package hash
               <input id="packageHash" />
diff --git a/docs/integration-contract.md b/docs/integration-contract.md
index 01fa9ef..ac3d69b 100644
--- a/docs/integration-contract.md
+++ b/docs/integration-contract.md
@@ -31,6 +31,11 @@ Launcher integrates with EDUT web/backend contracts as follows:
    - `wallet_session_expired`
    - `wallet_session_mismatch`
 
+## Runtime Mode Signal
+
+1. Launcher install-confirm payload carries `operation_mode` (`human_manual` or `worker_auto`).
+2. Mode signal is deterministic evidence input for governance activation policy and receipt hashing.
+
 ## Deterministic Requirements
 
 1. No runtime activation without entitlement proof.