ArchieIndian
diff --git a/‎README.md‎
Lines changed: 19 additions & 12 deletions b/‎README.md‎
Lines changed: 19 additions & 12 deletions
diff --git a/‎skills/openclaw-native/compaction-resilience-guard/SKILL.md‎
Lines changed: 94 additions & 0 deletions b/‎skills/openclaw-native/compaction-resilience-guard/SKILL.md‎
Lines changed: 94 additions & 0 deletions
diff --git a/‎skills/openclaw-native/compaction-resilience-guard/STATE_SCHEMA.yaml‎
Lines changed: 30 additions & 0 deletions b/‎skills/openclaw-native/compaction-resilience-guard/STATE_SCHEMA.yaml‎
Lines changed: 30 additions & 0 deletions
diff --git a/‎skills/openclaw-native/compaction-resilience-guard/example-state.yaml‎
Lines changed: 65 additions & 0 deletions b/‎skills/openclaw-native/compaction-resilience-guard/example-state.yaml‎
Lines changed: 65 additions & 0 deletions
@@ -1,11 +1,11 @@
 # openclaw-superpowers
 
-**44 ready-to-use skills that make your AI agent autonomous, self-healing, and self-improving.**
+**49 ready-to-use skills that make your AI agent autonomous, self-healing, and self-improving.**
 
-[![Skills](https://img.shields.io/badge/skills-44-blue)](#skills-included)
+[![Skills](https://img.shields.io/badge/skills-49-blue)](#skills-included)
 [![Security](https://img.shields.io/badge/security_skills-6-green)](#security--guardrails)
-[![Cron](https://img.shields.io/badge/cron_scheduled-12-orange)](#openclaw-native-28-skills)
-[![Scripts](https://img.shields.io/badge/companion_scripts-15-purple)](#companion-scripts)
+[![Cron](https://img.shields.io/badge/cron_scheduled-15-orange)](#openclaw-native-33-skills)
+[![Scripts](https://img.shields.io/badge/companion_scripts-20-purple)](#companion-scripts)
 [![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
 
 A plug-and-play skill library for [OpenClaw](https://github.com/openclaw/openclaw) — the open-source AI agent runtime. Gives your agent structured thinking, security guardrails, persistent memory, cron scheduling, self-recovery, and the ability to write its own new skills during conversation.
@@ -20,12 +20,13 @@ Built for developers who want their AI agent to run autonomously 24/7, not just
 
 Most AI agent frameworks give you a chatbot that forgets everything between sessions. OpenClaw is different — it runs persistently, handles multi-hour tasks, and has native cron scheduling. But out of the box, it doesn't know *how* to use those capabilities well.
 
-**openclaw-superpowers bridges that gap.** Install once, and your agent immediately knows how to:
+**openclaw-superpowers bridges that gap.** Install 49 skills in one command, and your agent immediately knows how to:
 
 - **Think before it acts** — brainstorming, planning, and systematic debugging skills prevent the "dive in and break things" failure mode
 - **Protect itself** — 6 security skills detect prompt injection, block dangerous actions, audit installed code, and scan for leaked credentials
 - **Run unattended** — 12 cron-scheduled skills handle memory cleanup, health checks, budget tracking, and community monitoring while you sleep
 - **Recover from failures** — self-recovery, loop-breaking, and task handoff skills keep long-running work alive across crashes and restarts
+- **Never forget** — DAG-based memory compaction, integrity checking, and context scoring ensure the agent preserves critical information even in month-long conversations
 - **Improve itself** — the agent can write new skills during normal conversation using `create-skill`, encoding your preferences as permanent behaviors
 
 ---
@@ -50,7 +51,7 @@ cd ~/.openclaw/extensions/superpowers && ./install.sh
 openclaw gateway restart
 ```
 
-`install.sh` symlinks all 44 skills, creates state directories for stateful skills, and registers cron jobs — everything in one step. That's it. Your agent now has superpowers.
+`install.sh` symlinks all 49 skills, creates state directories for stateful skills, and registers cron jobs — everything in one step. That's it. Your agent now has superpowers.
 
 ---
 
@@ -78,7 +79,7 @@ Methodology skills that work in any AI agent runtime. Adapted from [obra/superpo
 | `skill-conflict-detector` | Detects name shadowing and description-overlap conflicts between installed skills | `detect.py` |
 | `skill-portability-checker` | Validates OS/binary dependencies in companion scripts; catches non-portable calls | `check.py` |
 
-### OpenClaw-Native (28 skills)
+### OpenClaw-Native (33 skills)
 
 Skills that require OpenClaw's persistent runtime — cron scheduling, session state, or long-running execution. These are the skills that make a 24/7 autonomous agent actually work reliably.
 
@@ -112,6 +113,11 @@ Skills that require OpenClaw's persistent runtime — cron scheduling, session s
 | `config-encryption-auditor` | Scans config directories for plaintext API keys, tokens, and world-readable permissions | Sundays 9am | `audit.py` |
 | `tool-description-optimizer` | Scores skill descriptions for trigger quality — clarity, specificity, keyword density — and suggests rewrites | — | `optimize.py` |
 | `mcp-health-checker` | Monitors MCP server connections for health, latency, and availability; detects stale connections | every 6h | `check.py` |
+| `memory-dag-compactor` | Builds hierarchical summary DAGs from MEMORY.md with depth-aware prompts (d0 leaf → d3+ durable) | daily 11pm | `compact.py` |
+| `large-file-interceptor` | Detects oversized files, generates structural exploration summaries, stores compact references | — | `intercept.py` |
+| `context-assembly-scorer` | Scores how well current context represents full conversation; detects blind spots | every 4h | `score.py` |
+| `compaction-resilience-guard` | Monitors compaction for failures; enforces normal → aggressive → deterministic fallback chain | — | `guard.py` |
+| `memory-integrity-checker` | Validates summary DAGs for orphans, circular refs, token inflation, broken lineage | Sundays 3am | `integrity.py` |
 
 ### Community (1 skill)
 
@@ -142,12 +148,12 @@ Six skills form a defense-in-depth security layer for autonomous agents:
 
 | Feature | openclaw-superpowers | obra/superpowers | Custom prompts |
 |---|---|---|---|
-| Skills included | **44** | 8 | 0 |
+| Skills included | **49** | 8 | 0 |
 | Self-modifying (agent writes new skills) | Yes | No | No |
-| Cron scheduling | **12 scheduled skills** | No | No |
+| Cron scheduling | **15 scheduled skills** | No | No |
 | Persistent state across sessions | **YAML state schemas** | No | No |
 | Security guardrails | **6 defense-in-depth skills** | No | No |
-| Companion scripts with CLI | **15 scripts** | No | No |
+| Companion scripts with CLI | **20 scripts** | No | No |
 | Memory graph / knowledge graph | Yes | No | No |
 | MCP server health monitoring | Yes | No | No |
 | API spend tracking & budget enforcement | Yes | No | No |
@@ -169,7 +175,7 @@ Six skills form a defense-in-depth security layer for autonomous agents:
 │   │   │   ├── SKILL.md
 │   │   │   └── TEMPLATE.md
 │   │   └── ...
-│   ├── openclaw-native/         # 28 persistent-runtime skills
+│   ├── openclaw-native/         # 33 persistent-runtime skills
 │   │   ├── memory-graph-builder/
 │   │   │   ├── SKILL.md             # Skill definition + YAML frontmatter
 │   │   │   ├── STATE_SCHEMA.yaml    # State shape (committed, versioned)
@@ -192,7 +198,7 @@ Six skills form a defense-in-depth security layer for autonomous agents:
 
 Skills marked with a script ship a small executable alongside their `SKILL.md`:
 
-- **15 Python scripts** (`run.py`, `audit.py`, `check.py`, `guard.py`, `bridge.py`, `onboard.py`, `sync.py`, `doctor.py`, `loadout.py`, `governor.py`, `detect.py`, `test.py`, `radar.py`, `graph.py`, `optimize.py`) — run directly to manipulate state, generate reports, or trigger actions. No extra dependencies; `pyyaml` is optional but recommended.
+- **20 Python scripts** (`run.py`, `audit.py`, `check.py`, `guard.py`, `bridge.py`, `onboard.py`, `sync.py`, `doctor.py`, `loadout.py`, `governor.py`, `detect.py`, `test.py`, `radar.py`, `graph.py`, `optimize.py`, `compact.py`, `intercept.py`, `score.py`, `integrity.py`) — run directly to manipulate state, generate reports, or trigger actions. No extra dependencies; `pyyaml` is optional but recommended.
 - **`vet.sh`** — Pure bash scanner; runs on any system with grep.
 - Every script supports `--help` and `--format json`. Dry-run mode available on scripts that make changes.
 - See the `example-state.yaml` in each skill directory for sample state and a commented walkthrough of cron behaviour.
@@ -228,3 +234,4 @@ Skills marked with a script ship a small executable alongside their `SKILL.md`:
 
 - **[openclaw/openclaw](https://github.com/openclaw/openclaw)** — the open-source AI agent runtime
 - **[obra/superpowers](https://github.com/obra/superpowers)** — Jesse Vincent's skills framework; core skills adapted under MIT license
+- **[OpenLobster](https://github.com/Neirth/OpenLobster)** — inspiration for memory graph, config encryption auditing, tool-description scoring, and MCP health monitoring
@@ -0,0 +1,94 @@
+---
+name: compaction-resilience-guard
+version: "1.0"
+category: openclaw-native
+description: Monitors memory compaction for failures and enforces a three-level fallback chain — normal, aggressive, deterministic truncation — ensuring compaction always makes forward progress.
+stateful: true
+---
+
+# Compaction Resilience Guard
+
+## What it does
+
+Memory compaction can fail silently: the LLM produces empty output, summaries that are *larger* than their input, or garbled text. When this happens, compaction stalls and context overflows.
+
+Compaction Resilience Guard enforces a three-level escalation chain inspired by [lossless-claw](https://github.com/Martian-Engineering/lossless-claw):
+
+| Level | Strategy | When used |
+|---|---|---|
+| L1 — Normal | Standard summarization prompt | First attempt |
+| L2 — Aggressive | Low temperature, reduced reasoning, shorter output target | After L1 failure |
+| L3 — Deterministic | Pure truncation: keep first N + last N lines, drop middle | After L2 failure |
+
+This ensures compaction **always makes progress** — even if the LLM is broken.
+
+## When to invoke
+
+- After any compaction event — validate the output
+- When context usage approaches 90% — compaction may be failing
+- When summaries seem unusually long or empty — detect inflation
+- As a pre-check before memory-dag-compactor runs
+
+## How to use
+
+```bash
+python3 guard.py --check                       # Validate recent compaction outputs
+python3 guard.py --check --file <summary.yaml> # Check a specific summary file
+python3 guard.py --simulate <text>             # Run the 3-level chain on sample text
+python3 guard.py --report                      # Show failure/escalation history
+python3 guard.py --status                      # Last check summary
+python3 guard.py --format json                 # Machine-readable output
+```
+
+## Failure detection
+
+The guard detects these compaction failures:
+
+| Failure | How detected | Action |
+|---|---|---|
+| Empty output | Summary length < 10 chars | Escalate to next level |
+| Inflation | Summary tokens > input tokens | Escalate to next level |
+| Garbled text | Entropy score > 5.0 (random chars) | Escalate to next level |
+| Repetition | Same 20+ char phrase repeated 3+ times | Escalate to next level |
+| Truncation marker | Contains `[FALLBACK]` or `[TRUNCATED]` | Record as L3 usage |
+| Stale | Summary unchanged from previous run | Flag for review |
+
+## Procedure
+
+**Step 1 — Check recent compaction outputs**
+
+```bash
+python3 guard.py --check
+```
+
+Validates all summary nodes in memory-dag-compactor state. Reports failures by level and whether escalation was needed.
+
+**Step 2 — Simulate the fallback chain**
+
+```bash
+python3 guard.py --simulate "$(cat long-text.txt)"
+```
+
+Runs the 3-level chain on sample text to test that each level produces valid output.
+
+**Step 3 — Review escalation history**
+
+```bash
+python3 guard.py --report
+```
+
+Shows how often each level was used. High L2/L3 usage indicates the primary summarization prompt needs improvement.
+
+## State
+
+Failure counts, escalation history, and per-summary validation results stored in `~/.openclaw/skill-state/compaction-resilience-guard/state.yaml`.
+
+Fields: `last_check_at`, `level_usage`, `failures`, `check_history`.
+
+## Notes
+
+- Read-only monitoring — does not perform compaction itself
+- Works alongside memory-dag-compactor as a quality gate
+- Deterministic truncation (L3) preserves first 30% and last 20% of input, drops middle
+- Entropy is measured using Shannon entropy on character distribution
+- High L3 usage (>10% of compactions) suggests a systemic LLM issue
@@ -0,0 +1,30 @@
+version: "1.0"
+description: Compaction failure tracking, escalation history, and level usage stats.
+fields:
+  last_check_at:
+    type: datetime
+  level_usage:
+    type: object
+    description: How often each fallback level was used
+    fields:
+      l1_normal:        { type: integer, default: 0 }
+      l2_aggressive:    { type: integer, default: 0 }
+      l3_deterministic: { type: integer, default: 0 }
+  failures:
+    type: list
+    description: Recent compaction failures detected
+    items:
+      summary_id:   { type: string }
+      failure_type: { type: enum, values: [empty, inflation, garbled, repetition, stale] }
+      level_used:   { type: integer, description: "1, 2, or 3" }
+      input_tokens: { type: integer }
+      output_tokens: { type: integer }
+      detected_at:  { type: datetime }
+  check_history:
+    type: list
+    description: Rolling log of past checks (last 20)
+    items:
+      checked_at:   { type: datetime }
+      summaries_checked: { type: integer }
+      failures_found:    { type: integer }
+      escalations:       { type: integer }
@@ -0,0 +1,65 @@
+# Example runtime state for compaction-resilience-guard
+last_check_at: "2026-03-16T23:05:00.000000"
+level_usage:
+  l1_normal: 42
+  l2_aggressive: 3
+  l3_deterministic: 1
+failures:
+  - summary_id: s-d0-012
+    failure_type: inflation
+    level_used: 2
+    input_tokens: 500
+    output_tokens: 620
+    detected_at: "2026-03-16T23:04:58.000000"
+  - summary_id: s-d1-005
+    failure_type: repetition
+    level_used: 3
+    input_tokens: 800
+    output_tokens: 200
+    detected_at: "2026-03-15T23:05:00.000000"
+check_history:
+  - checked_at: "2026-03-16T23:05:00.000000"
+    summaries_checked: 18
+    failures_found: 1
+    escalations: 1
+  - checked_at: "2026-03-15T23:05:00.000000"
+    summaries_checked: 15
+    failures_found: 1
+    escalations: 1
+  - checked_at: "2026-03-14T23:05:00.000000"
+    summaries_checked: 12
+    failures_found: 0
+    escalations: 0
+# ── Walkthrough ──────────────────────────────────────────────────────────────
+# python3 guard.py --check
+#
+#   Compaction Resilience Check — 2026-03-16 23:05
+#   ──────────────────────────────────────────────────
+#     Summaries checked:  18
+#     Failures found:     1
+#     Escalations needed: 1
+#     Status: DEGRADED
+#
+#     ! s-d0-012: inflation (entropy=3.2, 620 tok)
+#
+# python3 guard.py --report
+#
+#   Compaction Resilience Report
+#   ──────────────────────────────────────────────────
+#     Total compactions tracked: 46
+#     L1 Normal:           42 (91%)
+#     L2 Aggressive:        3 (7%)
+#     L3 Deterministic:     1 (2%)
+#
+#     Recent failures: 2
+#       s-d0-012: inflation (L2)
+#       s-d1-005: repetition (L3)
+#
+# python3 guard.py --simulate "$(cat long-text.txt)"
+#
+#   Fallback Chain Simulation
+#   ──────────────────────────────────────────────────
+#     Input:  2500 tokens (10000 chars)
+#     Level used: L1 (l1_normal)
+#     Output: 1000 tokens
+#     Compression: 40%