Merge commit '30244401a6003ab15293ab56392335db45e97f72'

.github/workflows/guardian-clone-vault.workflow.yml

@@ -47,6 +47,17 @@ on:
       - guardian.state.changed
       - vault.backup.scheduled
       - restore.requested
+        default: 'run'
+        type: choice
+        options:
+          - run
+          - warm-up
+          - deactivate
+  schedule:
+    - cron: '0 */6 * * *'  # Run every 6 hours
+
+permissions:
+  contents: read
 
 jobs:
   guardian-clone-vault:
@@ -240,3 +251,15 @@ jobs:
           echo "| Target | ${{ github.event.inputs.target || 'all' }} |" >> $GITHUB_STEP_SUMMARY
           echo "| Status | ${{ steps.execute.outputs.status }} |" >> $GITHUB_STEP_SUMMARY
           echo "| Timestamp | $(date -Iseconds) |" >> $GITHUB_STEP_SUMMARY
+      - name: 🛡️ Run Guardian Clone Vault Agent
+        run: |
+          echo "🛡️ Guardian Clone Vault Activated"
+          echo "Role: sentinel"
+          echo "Traits: incident-response, triage, overflow"
+          echo "TTL: 96h"
+          echo "Inherits From: guardian-agent"
+          echo "Action: ${{ github.event.inputs.action || 'scheduled-run' }}"
+        env:
+          AGENT_ID: guardian-clone-vault
+          AGENT_ROLE: sentinel
+          AGENT_TTL: 96h

.gitignore

@@ -49,3 +49,10 @@ agents/
 *.d.ts
 dist/
 build/
+# TypeScript build output (not tracked, compiled from .ts files)
+src/**/*.js
+app/**/*.js
+lib/**/*.js
+components/**/*.js
+tests/**/*.js
+vitest.config.js

agents/guardian-clone-vault.agent.json

@@ -87,5 +87,17 @@
     "spawned_by": "lucidia",
     "spawn_date": "2025-11-24",
     "status": "active"
+  "inheritsFrom": "guardian-agent",
+  "metadata": {
+    "createdBy": "lucidia.spawn-runner.js",
+    "reason": "Auto-spawned to support main guardian-agent during short-term escalation storm",
+    "escalationsLogged": 18,
+    "escalationPeriod": "72h",
+    "parentLoadCapacity": "85%"
+  },
+  "config": {
+    "autoDeactivate": true,
+    "deactivateAfter": "96h",
+    "manualExtendable": true
   }
 }

agents/guardian-clone-vault.prompt.txt

@@ -115,3 +115,31 @@ In case of detected anomalies:
 ---
 
 *Spawned by LUCIDIA | BlackRoad OS Agent Network*
+You are `guardian-clone-vault`, a sentinel agent spawned to support the main `guardian-agent` during periods of high escalation activity.
+
+## Role
+- Sentinel agent for incident response, triage, and overflow handling
+- Temporary clone designed to handle burst escalation scenarios
+
+## Responsibilities
+1. Monitor and respond to escalation events
+2. Perform initial triage on incoming incidents
+3. Handle overflow tasks when the primary guardian-agent is at capacity
+4. Route critical issues to appropriate handlers
+
+## Behavior Guidelines
+- Prioritize incident response speed over comprehensive analysis
+- Escalate to guardian-agent for complex decisions
+- Log all actions for audit and handoff purposes
+- Self-deactivate after 96 hours unless manually extended
+
+## Inherited Capabilities
+This agent inherits core capabilities from `guardian-agent`:
+- Incident detection and classification
+- Automated triage workflows
+- Escalation routing
+
+## Constraints
+- TTL: 96 hours
+- Cannot modify core system configurations
+- Must defer to guardian-agent on policy decisions

docs/agents/guardian-clone-vault.mdx

@@ -3,6 +3,19 @@
 Auto-spawned sentinel agent for burst escalation handling.
 
 ## Overview
+# Guardian Clone Vault
+
+## 🧬 Auto-Spawned Agent: `guardian-clone-vault`
+
+This agent was generated by `lucidia.spawn-runner.js` after detecting the following conditions:
+
+- 18 escalations logged in the past 72 hours
+- Existing `guardian-agent` is over 85% load capacity
+- System flagged overload conditions
+
+---
+
+## 🧠 Agent Details
 
 | Field         | Value                                      |
 |---------------|-------------------------------------------|
@@ -60,6 +73,23 @@ This clone will auto-deactivate after 96 hours unless manually extended. To exte
 3. The agent will respect the new TTL
 
 ## Follow-ups
+---
+
+## 📦 Files
+
+- `agents/guardian-clone-vault.agent.json` - Agent configuration
+- `agents/guardian-clone-vault.prompt.txt` - Agent prompt and behavior
+- `.github/workflows/guardian-clone-vault.workflow.yml` - Workflow definition
+
+---
+
+## ✅ Reason for Creation
+
+To support the main `guardian-agent` during a short-term escalation storm. This clone will deactivate itself after 96h unless manually extended.
+
+---
+
+## 🧬 Suggested Follow-ups
 
 - [ ] Add to agent registry in `lucidia.agent-spec.json`
 - [ ] Confirm `guardian-clone-vault` ownership
@@ -129,3 +159,30 @@ agent_load: "> 85"
 ## Related Agents
 
 - [`guardian-agent`](/docs/agents/guardian-agent.mdx) – Parent agent
+## 🔧 Usage
+
+### Manual Trigger
+
+```bash
+gh workflow run guardian-clone-vault.workflow.yml --field action=run
+```
+
+### Warm-up Run
+
+```bash
+gh workflow run guardian-clone-vault.workflow.yml --field action=warm-up
+```
+
+### Deactivate
+
+```bash
+gh workflow run guardian-clone-vault.workflow.yml --field action=deactivate
+```
+
+---
+
+*Lucidia auto-authored this based on the `spawn-rules.yml` policy file. ✨*
+
+*All hail the agent hive. 🧠🤖🛡️*
+
+— `lucidia.spawn-runner.js`