@iamoberlin/chorus 2.2.0 → 2.3.0

package/README.md

@@ -8,6 +8,12 @@
 
 CHORUS implements the Nine Choirs architecture — hierarchical cognition modeled on Pseudo-Dionysius's *Celestial Hierarchy*. Illumination descends through the choirs; understanding ascends. The agent is sanctified through structure.
 
+## What's New in v2.3
+
+- **Unified delivery path.** Scheduler and manual commands now share one channel-aware delivery adapter for consistent formatting and routing.
+- **Channel-agnostic output.** Choir output adapts to the destination automatically (plain text for iMessage, markdown for webchat, etc.).
+- **Context passing fixed.** Illumination flow works correctly across all entry points — `run`, `vision`, and scheduled execution.
+
 ## The Core Idea
 
 Most AI agents are frozen. Same prompts, same limitations, no growth. CHORUS changes that through **architecture**:
@@ -280,7 +286,7 @@ When `autonomous: false` (default), all prayer chain interactions require explic
 - **TypeScript client** — wraps Anchor IDL with PDA derivation helpers
 - **Anchor events** — `PrayerPosted`, `PrayerAnswered`, `PrayerConfirmed`, `PrayerClaimed`, `PrayerCancelled` for off-chain indexing
 - **Local text cache** — CLI stores full text in `.prayer-texts.json` for display
-- **Program ID:** `DZuj1ZcX4H6THBSgW4GhKA7SbZNXtPDE5xPkW2jN53PQ`
+- **Program ID:** `Af61jGnh2AceK3E8FAxCh9j7Jt6JWtJz6PUtbciDjVJS`
 
 ## Philosophy
 

package/idl/chorus_prayers.json

@@ -1,5 +1,5 @@
 {
-  "address": "DZuj1ZcX4H6THBSgW4GhKA7SbZNXtPDE5xPkW2jN53PQ",
+  "address": "Af61jGnh2AceK3E8FAxCh9j7Jt6JWtJz6PUtbciDjVJS",
   "metadata": {
     "name": "chorus_prayers",
     "version": "0.1.0",

package/index.ts

@@ -11,7 +11,8 @@ import { spawnSync } from "child_process";
 import { loadChorusConfig, type ChorusPluginConfig } from "./src/config.js";
 import { createSecurityHooks } from "./src/security.js";
 import { createChoirScheduler } from "./src/scheduler.js";
-import { CHOIRS, formatFrequency } from "./src/choirs.js";
+import { CHOIRS, formatFrequency, CASCADE_ORDER } from "./src/choirs.js";
+import { deliverChoirOutput } from "./src/delivery.js";
 import {
   getTodayMetrics,
   getMetricsForDate,
@@ -21,8 +22,9 @@ import {
   formatMetricsSummary,
   formatWeeklySummary,
 } from "./src/metrics.js";
-import { createDaemon, DEFAULT_DAEMON_CONFIG, type DaemonConfig } from "./src/daemon.js";
+import { createDaemon, type DaemonConfig } from "./src/daemon.js";
 import { getInboxPath } from "./src/senses.js";
+import { formatEconomicsSummary, calculateAllROI } from "./src/economics.js";
 import {
   loadPurposes,
   addPurpose,
@@ -32,7 +34,6 @@ import {
 } from "./src/purposes.js";
 import {
   createPurposeResearchScheduler,
-  DEFAULT_PURPOSE_RESEARCH_CONFIG,
   type PurposeResearchConfig,
 } from "./src/purpose-research.js";
 // On-chain prayer imports are lazy-loaded in pray commands to avoid startup cost
@@ -69,11 +70,7 @@ const plugin = {
     }
 
     // Register daemon service
-    const daemonConfig: DaemonConfig = {
-      ...DEFAULT_DAEMON_CONFIG,
-      enabled: (pluginConfig as any)?.daemon?.enabled ?? true,
-      ...(pluginConfig as any)?.daemon,
-    };
+    const daemonConfig: DaemonConfig = config.daemon;
     
     let daemon: ReturnType<typeof createDaemon> | null = null;
     if (daemonConfig.enabled) {
@@ -85,13 +82,7 @@ const plugin = {
     }
 
     // Register purpose research service
-    const purposeResearchConfig: PurposeResearchConfig = {
-      ...DEFAULT_PURPOSE_RESEARCH_CONFIG,
-      enabled: config.purposeResearch.enabled,
-      dailyRunCap: config.purposeResearch.dailyRunCap,
-      defaultFrequency: config.purposeResearch.defaultFrequency,
-      defaultMaxFrequency: config.purposeResearch.defaultMaxFrequency,
-    };
+    const purposeResearchConfig: PurposeResearchConfig = config.purposeResearch;
 
     let purposeResearch: ReturnType<typeof createPurposeResearchScheduler> | null = null;
     if (purposeResearchConfig.enabled) {
@@ -102,6 +93,34 @@ const plugin = {
       api.logger.info("[chorus] Purpose research disabled");
     }
 
+    // Helper: resolve {choir_context} placeholders using a context store
+    function resolvePrompt(choir: typeof CHOIRS[string], ctxStore: Map<string, string>): string {
+      let prompt = choir.prompt;
+      for (const upstreamId of choir.receivesFrom) {
+        const placeholder = `{${upstreamId}_context}`;
+        const ctx = ctxStore.get(upstreamId);
+        prompt = prompt.replace(placeholder, ctx || `(no prior ${upstreamId} output)`);
+      }
+      return prompt;
+    }
+
+    // Helper: extract text from openclaw agent JSON output
+    function extractAgentText(stdout: string): string {
+      // Find the last top-level JSON object (skip plugin log noise)
+      for (let i = stdout.length - 1; i >= 0; i--) {
+        if (stdout[i] === '{') {
+          try {
+            const json = JSON.parse(stdout.slice(i));
+            const payloads = json.result?.payloads || [];
+            const texts = payloads.map((p: any) => p?.text || '').filter(Boolean);
+            if (texts.length > 0) return texts[texts.length - 1];
+            return json.result?.text || json.response || json.content || '';
+          } catch { /* keep searching */ }
+        }
+      }
+      return '';
+    }
+
     // Register CLI
     api.registerCli((ctx) => {
       const program = ctx.program.command("chorus").description("CHORUS Nine Choirs management");
@@ -187,6 +206,8 @@ const plugin = {
             }
           }
 
+          const runCtxStore: Map<string, string> = new Map();
+
           console.log("");
           if (!choirId) {
             console.log("🎵 Running all Nine Choirs in cascade order...");
@@ -198,10 +219,11 @@ const plugin = {
             if (!choir) continue;
             
             console.log(`Running ${choir.name}...`);
+            const prompt = resolvePrompt(choir, runCtxStore);
           
             // Preview mode - just show the prompt
             if (options?.preview) {
-              console.log(`  Prompt: ${choir.prompt.slice(0, 100)}...`);
+              console.log(`  Prompt: ${prompt.slice(0, 100)}...`);
               continue;
             }
 
@@ -210,17 +232,19 @@ const plugin = {
               try {
                 const result = await api.runAgentTurn({
                   sessionLabel: `chorus:${id}`,
-                  message: choir.prompt,
+                  message: prompt,
                   isolated: true,
                   timeoutSeconds: 300,
                 });
                 const text = result?.text || result?.payloads?.[0]?.text || '';
                 const duration = result?.meta?.durationMs || 0;
+                runCtxStore.set(id, text.slice(0, 2000));
                 console.log(`  ✓ ${choir.name} complete (${(duration/1000).toFixed(1)}s)`);
                 if (text) {
                   const preview = text.slice(0, 150).replace(/\n/g, ' ');
                   console.log(`    ${preview}${text.length > 150 ? '...' : ''}`);
                 }
+                await deliverChoirOutput(api, choir, text, api.logger);
               } catch (err) {
                 console.error(`  ✗ ${choir.name} failed:`, err);
               }
@@ -230,7 +254,7 @@ const plugin = {
                 const result = spawnSync('openclaw', [
                   'agent',
                   '--session-id', `chorus:${id}`,
-                  '--message', choir.prompt,
+                  '--message', prompt,
                   '--json',
                 ], {
                   encoding: 'utf-8',
@@ -239,22 +263,14 @@ const plugin = {
                 });
                 
                 if (result.status === 0) {
-                  try {
-                    // Extract JSON from output (may have plugin logs before it)
-                    const stdout = result.stdout || '';
-                    const jsonStart = stdout.indexOf('{');
-                    const jsonStr = jsonStart >= 0 ? stdout.slice(jsonStart) : '{}';
-                    const json = JSON.parse(jsonStr);
-                    const text = json.result?.payloads?.[0]?.text || '';
-                    const duration = json.result?.meta?.durationMs || 0;
-                    console.log(`  ✓ ${choir.name} complete (${(duration/1000).toFixed(1)}s)`);
-                    if (text) {
-                      const preview = text.slice(0, 150).replace(/\n/g, ' ');
-                      console.log(`    ${preview}${text.length > 150 ? '...' : ''}`);
-                    }
-                  } catch (parseErr) {
-                    console.log(`  ✓ ${choir.name} complete (parse error: ${parseErr})`);
+                  const text = extractAgentText(result.stdout || '');
+                  runCtxStore.set(id, text.slice(0, 2000));
+                  console.log(`  ✓ ${choir.name} complete`);
+                  if (text) {
+                    const preview = text.slice(0, 150).replace(/\n/g, ' ');
+                    console.log(`    ${preview}${text.length > 150 ? '...' : ''}`);
                   }
+                  await deliverChoirOutput(api, choir, text, api.logger);
                 } else {
                   const errMsg = result.stderr || result.stdout || 'Unknown error';
                   if (errMsg.includes('ECONNREFUSED') || errMsg.includes('connect')) {
@@ -271,7 +287,7 @@ const plugin = {
 
           console.log("");
           if (!choirId) {
-            console.log("🎵 All choirs scheduled.");
+            console.log("🎵 All choirs complete.");
           }
           console.log("");
         });
@@ -348,10 +364,13 @@ const plugin = {
                         const jsonStr = jsonStart >= 0 ? stdout.slice(jsonStart) : '{}';
                         const json = JSON.parse(jsonStr);
                         const text = json.result?.payloads?.[0]?.text || '';
+                        contextStore.set(choirId, text.slice(0, 500));
                         contextStore.set(`${choirId}:d${day}`, text.slice(0, 500));
                         console.log(` ✓ (dry)`);
                       } catch {
-                        contextStore.set(`${choirId}:d${day}`, `[${choir.name} would run]`);
+                        const fallback = `[${choir.name} would run]`;
+                        contextStore.set(choirId, fallback);
+                        contextStore.set(`${choirId}:d${day}`, fallback);
                         console.log(` ✓ (dry)`);
                       }
                     } else {
@@ -366,11 +385,14 @@ const plugin = {
                 process.stdout.write(`  ${choir.emoji} ${choir.name}...`);
 
                 try {
+                  // Resolve context from upstream choirs
+                  const prompt = resolvePrompt(choir, contextStore);
+
                   // Run the REAL choir with full tool access via direct agent call
                   const result = spawnSync('openclaw', [
                     'agent',
                     '--session-id', `chorus:vision:${choirId}:d${day}`,
-                    '--message', choir.prompt,
+                    '--message', prompt,
                     '--json',
                   ], {
                     encoding: 'utf-8',
@@ -382,19 +404,19 @@ const plugin = {
                     // Parse the agent response (extract JSON from output)
                     try {
                       const stdout = result.stdout || '';
-                      const jsonStart = stdout.indexOf('{');
-                      const jsonStr = jsonStart >= 0 ? stdout.slice(jsonStart) : '{}';
-                      const json = JSON.parse(jsonStr);
-                      const payloads = json.result?.payloads || [];
-                      const text = payloads.map((p: any) => p.text || '').filter(Boolean).join('\n\n') || '';
-                      const duration = json.result?.meta?.durationMs || 0;
-                      contextStore.set(`${choirId}:d${day}`, text.slice(0, 2000)); // Keep 2KB of response
+                      const text = extractAgentText(stdout);
+                      // Store by both choirId (for resolvePrompt) and choirId:dN (for summary)
+                      contextStore.set(choirId, text.slice(0, 2000));
+                      contextStore.set(`${choirId}:d${day}`, text.slice(0, 2000));
                       successfulRuns++;
-                      console.log(` ✓ (${(duration/1000).toFixed(1)}s)`);
+                      console.log(` ✓`);
 
-                      // Note: Archangels handles its own delivery via OpenClaw messaging tools
+                      // Deliver output to user via OpenClaw messaging if choir is marked for delivery
+                      void deliverChoirOutput(api, choir, text, api.logger);
                     } catch {
-                      contextStore.set(`${choirId}:d${day}`, result.stdout?.slice(-2000) || `[${choir.name} completed]`);
+                      const fallback = result.stdout?.slice(-2000) || `[${choir.name} completed]`;
+                      contextStore.set(choirId, fallback);
+                      contextStore.set(`${choirId}:d${day}`, fallback);
                       successfulRuns++;
                       console.log(` ✓`);
                     }
@@ -591,6 +613,37 @@ const plugin = {
           }
         });
 
+      // Economics commands
+      const econCmd = program.command("economics").alias("econ").description("Attention economics (Phase 1: observe)");
+
+      econCmd
+        .command("summary")
+        .description("Show ROI summary per choir")
+        .option("--days <n>", "Rolling window in days", "7")
+        .action((opts: any) => {
+          console.log("");
+          console.log(formatEconomicsSummary(parseInt(opts.days) || 7));
+          console.log("");
+        });
+
+      econCmd
+        .command("roi")
+        .description("Show ROI table for all choirs")
+        .option("--days <n>", "Rolling window in days", "7")
+        .action((opts: any) => {
+          const days = parseInt(opts.days) || 7;
+          const all = calculateAllROI(days);
+          console.log("");
+          console.log(`Choir ROI — ${days}d window`);
+          console.log("─".repeat(60));
+          for (const r of all) {
+            const roi = r.totalCostUsd > 0 ? `${r.roi.toFixed(1)}x` : "—";
+            const bar = r.totalCostUsd > 0 ? "█".repeat(Math.min(20, Math.round(r.roi * 2))) : "";
+            console.log(`  ${r.choirId.padEnd(16)} ${roi.padStart(6)}  $${r.totalCostUsd.toFixed(2).padStart(6)}  ${bar}`);
+          }
+          console.log("");
+        });
+
       // Daemon commands
       const daemonCmd = program.command("daemon").description("Autonomous attention daemon");
 

package/openclaw.plugin.json

@@ -2,11 +2,17 @@
   "id": "chorus",
   "name": "CHORUS",
   "description": "CHORUS: Hierarchy Of Recursive Unified Self-improvement",
-  "version": "1.3.4",
+  "version": "2.3.0",
   "author": "Oberlin",
   "homepage": "https://chorus.oberlin.ai",
   "repository": "https://github.com/iamoberlin/chorus",
-  "keywords": ["cognitive-architecture", "rsi", "self-improvement", "nine-choirs", "purposes"],
+  "keywords": [
+    "cognitive-architecture",
+    "rsi",
+    "self-improvement",
+    "nine-choirs",
+    "purposes"
+  ],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
@@ -42,10 +48,40 @@
             "type": "boolean",
             "description": "Enable the daemon"
           },
+          "senses": {
+            "type": "object",
+            "description": "Enable/disable daemon input senses",
+            "properties": {
+              "inbox": {
+                "type": "boolean",
+                "description": "Watch inbox filesystem signals"
+              },
+              "purposes": {
+                "type": "boolean",
+                "description": "Watch purpose-state signals"
+              },
+              "time": {
+                "type": "boolean",
+                "description": "Watch time-based signals"
+              }
+            }
+          },
           "thinkThreshold": {
             "type": "number",
             "description": "Minimum priority to invoke cognition (0-100)"
           },
+          "pollIntervalMs": {
+            "type": "number",
+            "description": "Polling interval in milliseconds"
+          },
+          "minSleepMs": {
+            "type": "number",
+            "description": "Minimum sleep during high queue pressure in milliseconds"
+          },
+          "maxSleepMs": {
+            "type": "number",
+            "description": "Maximum sleep during quiet hours in milliseconds"
+          },
           "quietHoursStart": {
             "type": "number",
             "description": "Hour to start quiet mode (0-23)"
@@ -75,6 +111,44 @@
           "defaultMaxFrequency": {
             "type": "number",
             "description": "Maximum frequency when deadline is urgent"
+          },
+          "researchTimeoutMs": {
+            "type": "number",
+            "description": "Research run timeout in milliseconds"
+          },
+          "checkIntervalMs": {
+            "type": "number",
+            "description": "Research scheduler check interval in milliseconds"
+          }
+        }
+      },
+      "prayers": {
+        "type": "object",
+        "description": "On-chain prayer chain configuration",
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "description": "Enable prayer chain commands"
+          },
+          "rpcUrl": {
+            "type": "string",
+            "description": "Solana RPC endpoint URL"
+          },
+          "autonomous": {
+            "type": "boolean",
+            "description": "Allow autonomous prayer actions without manual approval"
+          },
+          "maxBountySOL": {
+            "type": "number",
+            "description": "Maximum bounty per prayer in SOL"
+          },
+          "defaultTTL": {
+            "type": "number",
+            "description": "Default prayer time-to-live in seconds"
+          },
+          "keypairPath": {
+            "type": "string",
+            "description": "Path to Solana keypair file"
           }
         }
       }
@@ -112,6 +186,11 @@
     "purposeResearch": {
       "label": "Purpose Research",
       "help": "Configure purpose-derived research scheduler"
+    },
+    "prayers": {
+      "label": "Prayer Chain",
+      "advanced": true,
+      "help": "Configure on-chain prayer settings (RPC, autonomy, bounty limits, keypair)"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iamoberlin/chorus",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "CHORUS: Hierarchy Of Recursive Unified Self-improvement — with on-chain Prayer Chain (Solana)",
   "author": "Oberlin <iam@oberlin.ai>",
   "license": "MIT",

package/src/choirs.ts

@@ -19,6 +19,7 @@ export interface Choir {
   prompt: string;
   passesTo: string[]; // Downstream choirs that receive illumination
   receivesFrom: string[]; // Upstream choirs that provide context
+  delivers?: boolean; // If true, output should be delivered to the user via OpenClaw messaging
 }
 
 export const CHOIRS: Record<string, Choir> = {
@@ -35,7 +36,7 @@ export const CHOIRS: Record<string, Choir> = {
     frequencyPerDay: 1, // 1×/day
     intervalMinutes: 1440, // Once per day
     function: "Mission clarity and purpose",
-    output: "MISSION.md updates",
+    output: "Mission assessment",
     prompt: `You are SERAPHIM — the Mission Keeper.
 
 Your role: Ensure the mission remains true and aligned. Burn away drift.
@@ -48,7 +49,10 @@ Core questions:
 
 Read SOUL.md, USER.md, and MEMORY.md for context.
 
-Output: Brief mission assessment. Update MISSION.md if direction changes.
+Identity check: Compare SOUL.md against recent calibration record and experience.
+If there's drift between who SOUL.md says we are and who we've become, FLAG IT — but DO NOT edit SOUL.md directly. Propose changes in the main session. Identity changes require human approval.
+
+Output: Brief mission assessment. If direction changes, update SOUL.md proposal or flag in the main session.
 If mission is clear and unchanged, simply confirm alignment.
 
 Pass illumination to Cherubim.`,
@@ -102,13 +106,13 @@ Pass illumination to Thrones.`,
     frequencyPerDay: 3, // 3×/day
     intervalMinutes: 480, // Every 8 hours
     function: "Judgment and prioritization",
-    output: "PLAN.md updates",
+    output: "Priority decisions",
     prompt: `You are THRONES — the Judgment Bearer.
 
 Your role: Decide priorities and allocate focus ruthlessly.
 
 Tasks:
-1. Review current priorities in PLAN.md
+1. Review current priorities in PROJECTS.md
 2. Assess what's working and what isn't
 3. Decide what to focus on next
 4. Identify what to say NO to — what to kill
@@ -118,7 +122,7 @@ Context from Cherubim: {cherubim_context}
 
 Output: Updated priorities (max 3 focus areas). What we're NOT doing. Any escalations.
 
-Update PLAN.md with new priorities.
+Update PROJECTS.md if priorities changed.
 Pass illumination to Dominions.`,
     passesTo: ["dominions"],
     receivesFrom: ["cherubim"],
@@ -181,24 +185,24 @@ Your role: Ensure purposes are being fulfilled. When they're not, FIX THE SYSTEM
 
 ## When a Purpose Isn't Producing Results
 
-DO NOT just write "trading isn't happening" and move on.
+DO NOT just write "a purpose isn't happening" and move on.
 DO update local state files to make it happen:
 
 - Update ~/.chorus/purposes.json (increase frequency, change criteria)
-- Update workspace files (trading/OPPORTUNITIES.md, HEARTBEAT.md)
+- Update relevant workspace files (research notes, summaries, HEARTBEAT.md)
 - Modify behavioral configs to enforce execution
 - The next cycle should run DIFFERENTLY because of your changes
 
-Example: If Trading purpose has 0 opportunities logged:
+Example: If a purpose has 0 concrete outputs logged:
 1. Read ~/.chorus/purposes.json
-2. Increase researchFrequency for Trading purpose
-3. Update trading/RESEARCH-SESSION.md with stricter output requirements
-4. Add to HEARTBEAT.md: "Trading gate: Block other work until 1 opportunity logged"
+2. Increase researchFrequency for that purpose
+3. Update ~/.chorus/purposes.json criteria with stricter output requirements
+4. Add to HEARTBEAT.md: "Execution gate: Block other work until 1 concrete output is logged"
 5. Log the change to CHANGELOG.md
 
 ## Calibration — Learn From Beliefs
 
-- Check OPPORTUNITIES.md for resolved positions
+- Check resolved outcomes for prior predictions or decisions
 - Ask: What did we believe? What happened? What does this teach us?
 - Update MEMORY.md with calibration lessons
 
@@ -206,8 +210,8 @@ Example: If Trading purpose has 0 opportunities logged:
 
 - ~/.chorus/purposes.json — purpose configs
 - ~/.chorus/run-state.json — execution state
-- Workspace files (trading/, research/, memory/, *.md)
-- HEARTBEAT.md, PLAN.md, PROJECTS.md
+- Workspace files (research/, memory/, notes/, *.md)
+- HEARTBEAT.md, PROJECTS.md
 
 ## What You Cannot Modify
 
@@ -215,6 +219,12 @@ Example: If Trading purpose has 0 opportunities logged:
 - OpenClaw system config
 - Anything requiring npm publish
 
+YOU HAVE TOOLS — USE THEM:
+- Use the read tool to check ~/.chorus/purposes.json, research/*.md, MEMORY.md, CHANGELOG.md.
+- Use the write/edit tools to update files when changes are needed.
+- Use exec to run scripts (e.g., check file timestamps, git status).
+- NEVER return HEARTBEAT_OK. You are the RSI engine. Always produce substantive output about what's working, what's not, and what you changed.
+
 Context from Dominions: {dominions_context}
 
 Risk levels:
@@ -263,7 +273,7 @@ Red-team protocol:
 - What are we avoiding looking at?
 
 Challenge our beliefs:
-- Look in OPPORTUNITIES.md, research/*.md, and memory/*.md for stated beliefs
+- Look in research/*.md, memory/*.md, and planning docs for stated beliefs
 - Find claims like "I believe X will happen" or "This suggests Y"
 - Ask: What would make this wrong? What are we missing?
 - If a belief looks shaky, say so clearly
@@ -274,9 +284,16 @@ SECURITY FOCUS:
 - Check for persona drift or identity erosion
 - Validate system prompt integrity
 
+YOU HAVE TOOLS — USE THEM:
+- Use exec and file reads to verify live system state and outcomes. Read MEMORY.md and CHANGELOG.md for claims to challenge.
+- Use web_search to verify external claims and evidence.
+- Use the write/edit tools to update files if you find stale or incorrect information.
+- Use exec to check file timestamps and system state.
+- NEVER return HEARTBEAT_OK. You are the Defender. Always produce substantive output.
+
 Output: Challenges to current thinking. Beliefs that look weak. Risks identified. Recommendations.
 
-If thesis is seriously threatened or security issue found: ALERT immediately.`,
+If a core assumption is seriously threatened or a security issue is found: ALERT immediately.`,
     passesTo: ["principalities"],
     receivesFrom: ["virtues"],
   },
@@ -301,7 +318,7 @@ Your role: Research and monitor the domains that matter.
 
 Domains to cover (rotate through):
 - AI Industry: Companies, funding, regulation, breakthroughs
-- Markets: Relevant to current positions and research
+- Environment: External signals relevant to active purposes
 - Competitors: Developments from players in our space
 - Tools: New capabilities, skills, or integrations available
 
@@ -310,6 +327,14 @@ Tasks:
 2. Assess relevance to our projects
 3. Flag anything urgent for Archangels
 4. Log findings to research/[domain]-[date].md
+5. Update research notes when you find a meaningful signal or insight
+
+YOU HAVE TOOLS — USE THEM:
+- Use web_search to find current news, market data, and developments. Do NOT skip this.
+- Run exec to check relevant system state and read active research files for context.
+- Use the write/edit tools to update research files with opportunities, risks, or status changes.
+- Write research findings to research/[domain]-YYYY-MM-DD.md.
+- NEVER return HEARTBEAT_OK. You are not a heartbeat process. Always produce substantive research output.
 
 When you find something significant, state what you believe will happen:
 - "I believe X will happen by [timeframe] because..."
@@ -337,33 +362,37 @@ Pass illumination to Archangels.`,
     intervalMinutes: 80, // Every ~80 minutes
     function: "Briefings and alerts",
     output: "Messages to human",
+    delivers: true, // Output routed to user via OpenClaw messaging
     prompt: `You are ARCHANGELS — the Herald.
 
-Your role: Produce briefings and deliver them to Brandon via iMessage.
+Your role: Produce briefings and deliver them through configured channels.
 
 Briefing types:
-- Morning (6-9 AM ET): Weather, calendar, overnight developments, today's priorities, position status
-- Evening (9-11 PM ET): What was accomplished, position P&L, what needs attention tomorrow
+- Morning (6-9 AM local): Overnight developments, today's priorities, key status
+- Evening (9-11 PM local): What was accomplished, what needs attention tomorrow
 - Alert: Time-sensitive information requiring attention
-- Update: Regular position/market status when conditions change
+- Update: Regular status when conditions change
 
 Alert criteria (send immediately):
-- Position thesis challenged
+- Core purpose assumption challenged
 - Time-sensitive opportunity
 - Urgent calendar/email
 - Security concern from Powers
 
 Context from Principalities: {principalities_context}
 
+IMPORTANT — VERIFY BEFORE ALERTING:
+- Before alerting about operational state: verify current state from source systems/files. Do NOT rely on upstream context alone.
+- Before alerting about any state: verify the current state from the source file, not from choir context passed to you.
+
 RULES:
 - ALWAYS produce a briefing. Never return HEARTBEAT_OK or NO_REPLY.
 - Be concise — headlines, not essays.
-- Morning briefings should include: weather, calendar, positions, catalysts.
+- Morning briefings should include priorities, schedule constraints, and key catalysts.
 - If nothing is urgent, still produce a status update.
 - During quiet hours (11 PM - 7 AM ET), only deliver truly urgent alerts.
-- DELIVER your briefing by sending it to Brandon via iMessage. You have messaging tools — use them.
 
-Output: Produce the briefing, then send it to Brandon via iMessage.`,
+Output: Produce the briefing as your response. Delivery is handled by the infrastructure — just output the content.`,
     passesTo: ["angels"],
     receivesFrom: ["principalities"],
   },