@elvatis_com/openclaw-self-healing-elvatis 0.2.9 → 0.2.10

package/.ai/handoff/CONVENTIONS.md

@@ -65,3 +65,32 @@ scripts/             ← one-off utilities (roadmap issue creation, etc.)
 - `SKILL.md` — if commands or config changed
 
 Skipping documentation = incomplete release. No exceptions.
+
+---
+
+## 🚨 Release-Regel: Erst fertig, dann publishen (gilt für ALLE Plattformen)
+
+**IMMER erst alles fertigstellen, danach publishen. Kein einziger Commit mehr dazwischen.**
+Gilt für GitHub, npm, ClawHub, PyPI — egal ob ein Projekt auf einer oder mehreren Plattformen ist.
+Sonst divergieren die Tarballs/Releases zwangsläufig.
+
+### Reihenfolge (nie abweichen)
+1. Alle Änderungen + Versionsbumps in **einem einzigen Commit** abschließen
+2. `git push` → Plattform 1 (z.B. GitHub)
+3. `npm publish` / `clawhub publish` / etc. — alle weiteren Plattformen
+4. Kein weiterer Commit bis zum nächsten Release (außer reine interne Doku)
+
+### Vor jedem Release: Alle Versionsstellen prüfen
+```bash
+grep -rn "X\.Y\.Z\|Current version\|Version:" \
+  --include="*.md" --include="*.json" \
+  --exclude-dir=node_modules --exclude-dir=dist --exclude-dir=.git
+```
+Typische vergessene Stellen: `README.md` Header, `SKILL.md` Footer, `package.json`,
+`openclaw.plugin.json`, `.ai/handoff/STATUS.md` (Header + Plattform-Zeilen), Changelog-Eintrag.
+
+### Secrets & private Pfade — NIEMALS in Repos
+- Keine API Keys, Tokens, Passwörter, Secrets in Code oder Docs
+- Keine absoluten lokalen Pfade (`/home/user/...`) in publizierten Dateien
+- Keine `.env`-Dateien committen — immer in `.gitignore`
+- Vor jedem Push: `git diff --staged` auf Secrets prüfen

package/.ai/handoff/STATUS.md

@@ -1,14 +1,14 @@
 # STATUS.md — openclaw-self-healing-elvatis
 
-_Last updated: 2026-03-07 by Akido (claude-sonnet-4-6)_
+_Last updated: 2026-03-08 by Akido (claude-sonnet-4-6)_
 
-## Current Version: 0.2.8 — STABLE
+## Current Version: 0.2.10 — STABLE
 
 ## What is done
 
 - ✅ Repo: `https://github.com/elvatis/openclaw-self-healing-elvatis`
-- ✅ npm: `@elvatis_com/openclaw-self-healing-elvatis@0.2.8`
-- ✅ ClawHub: `openclaw-self-healing-elvatis@0.2.8`
+- ✅ npm: `@elvatis_com/openclaw-self-healing-elvatis@0.2.10`
+- ✅ ClawHub: `openclaw-self-healing-elvatis@0.2.10`
 - ✅ Model failover: rate-limit + auth-scope cooldown, configurable fallback order
 - ✅ WhatsApp reconnect: disconnect streak detection + gateway restart
 - ✅ Cron failure: consecutive fail threshold → disable + GitHub issue
@@ -18,20 +18,17 @@ _Last updated: 2026-03-07 by Akido (claude-sonnet-4-6)_
 - ✅ Status snapshot: written to file on every tick for external monitoring
 - ✅ Active recovery probing: polls limited models to detect early recovery
 - ✅ Dry-run mode: full behavior simulation without side effects
-- ✅ Config hot-reload: reads `api.pluginConfig` on each tick
-- ✅ Atomic state writes: tmp file + rename to avoid partial writes
-- ✅ 181 tests across 2 suites (unit + integration)
-- ✅ TypeScript build + typecheck pipeline
-- ✅ `.clawhubignore` + rsync-based ClawHub publish documented in CONVENTIONS.md
+- ✅ Backup path: `~/.openclaw/backups/openclaw.json/openclaw.json.<timestamp>.bak`
 
-## Critical Bug Fixed (v0.2.8)
+## Backup Behavior
 
-**Infinite gateway restart loop** — `lastRestartAt` was being saved AFTER
-`openclaw gateway restart`, which kills the process via systemd. On the next
-boot, `lastRestartAt = 0`, bypassing the `whatsappMinRestartIntervalSec`
-rate-limit guard. Fixed by saving state BEFORE the restart call.
+The plugin creates timestamped backups before any action that could restart the gateway
+or change cron/plugin state. Backups are written to:
+`~/.openclaw/backups/openclaw.json/openclaw.json.<ISO-timestamp>.bak`
+
+Note: Files like `openclaw.json.bak` in `~/.openclaw/` are from the manual config-change
+checklist procedure, not from this plugin.
 
 ## Open Risks
 
-- `T-014`: Heal metrics export to JSONL not yet implemented (low priority, no blocker)
-- ClawHub publish via `clawhub publish <dir>` ignores `.clawhubignore` — use rsync workaround (see CONVENTIONS.md)
+- ClawHub publish ignores `.clawhubignore` — use rsync workaround (see CONVENTIONS.md)

package/README.md

@@ -1,6 +1,6 @@
 # openclaw-self-healing-elvatis
 
-**Current version: `0.2.8`**
+**Current version: `0.2.10`**
 
 OpenClaw plugin that improves resilience by automatically fixing reversible failures.
 
@@ -13,6 +13,15 @@ OpenClaw plugin that improves resilience by automatically fixing reversible fail
 
 ## Changelog
 
+### v0.2.10 — 2026-03-08
+Docs fix: README and STATUS.md version headers were stuck at 0.2.8 after v0.2.9 bump; SKILL.md missing version footer; add universal release-rule to CONVENTIONS.md.
+
+### v0.2.9 — 2026-03-07
+**Fix: Plugin health monitoring JSON parsing**
+Extract JSON from stdout before parsing — channels subprocess output includes
+non-JSON log lines (e.g. `[INFO] ...`) before the JSON payload, causing parse
+failures in plugin health checks.
+
 ### v0.2.8 — 2026-03-07
 **Fix: Infinite gateway restart loop**
 `lastRestartAt` and `disconnectStreak` are now saved to disk **before** calling

package/SKILL.md

@@ -22,3 +22,5 @@ clawhub install openclaw-self-healing-elvatis
 ## Notes
 
 Keep repository content public-safe (no private identifiers).
+
+**Version:** 0.2.10

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "openclaw-self-healing-elvatis",
   "name": "OpenClaw Self Healing",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "description": "Self-healing health checks + guardrails + auto-fix for reversible failures (rate limits, auth errors, stuck session pins).",
   "configSchema": {
     "$schema": "http://json-schema.org/draft-07/schema#",
@@ -107,4 +107,4 @@
       }
     }
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elvatis_com/openclaw-self-healing-elvatis",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "type": "module",
   "openclaw": {
     "extensions": [
@@ -20,4 +20,4 @@
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
   }
-}
+}