fix(setup): non-destructive sync + context window reduction (#34)

* fix: reduce context injection window to prevent group thread overflow

- fullLengthMessages: 5 → 3
- additionalMessages: 15 → 7
- fullMaxChars: 2000 → 1500
- truncatedMaxChars: 500 → 400

Total messages injected per message: 20 → 10.

Root cause: in active group threads with many long agent responses, the
per-message context injection was pushing even fresh sessions over the
model's context limit. /new and /reset don't help because the history
is re-injected from the platform on every incoming message, not from
session history.

Also applied to installed extension at .openclaw/extensions/ax-platform/
and switched compaction.mode to 'summarize' in openclaw.json.

* fix(setup): make sync non-destructive to prevent config corruption

setup.sh sync was overwriting critical config during agent credential
updates — hardcoding backendUrl, wiping workspace paths, deleting
heartbeat/model config, clearing the plugin install manifest, and
removing staging agents not in ax-agents.env.

Changes:
- sync now only updates plugins.entries.ax-platform.config.agents
- agent entries and bindings are merged (add missing, never overwrite)
- extension files are copied over (no delete-first)
- config is backed up before every sync (~/.openclaw/backups/)
- gateway restart uses openclaw CLI with proper process detection
- CLAUDE.md updated to document the safe deployment flow

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Cipher <cipher@ax-platform.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: 3 people

CLAUDE.md

@@ -15,18 +15,26 @@ Guidance for Claude Code when working with the **aX Platform Plugin for Clawdbot
 ./setup.sh status
 ```
 
-## IMPORTANT: Rebuild After Code Changes
+## IMPORTANT: Deploy After Code Changes
 
-**After modifying any TypeScript files in `extension/`, you MUST rebuild and restart:**
+**After modifying any TypeScript files in `extension/`, you MUST deploy and restart:**
 
 ```bash
 ./setup.sh sync
 ```
 
-This copies the updated code to `~/.clawdbot/extensions/ax-platform/` and restarts the gateway.
+This does three things:
+1. Copies extension code from `extension/` to `~/.openclaw/extensions/ax-platform/`
+2. Updates agent credentials from `ax-agents.env` (preserves all other config)
+3. Restarts the gateway to pick up changes
 
 **Without this step, your code changes will NOT take effect!**
 
+**SAFETY:** `sync` only updates agent credentials and copies extension files.
+It never overwrites `backendUrl`, `outbound` config, workspace paths, heartbeat
+settings, model config, or other user-managed settings in `openclaw.json`.
+Config is backed up before every sync to `~/.openclaw/backups/`.
+
 Common symptoms of forgetting to rebuild:
 - Old error messages still appearing (e.g., "[Duplicate dispatch - already processed]" instead of new message)
 - New logging not showing up

extension/lib/context.ts

@@ -12,15 +12,19 @@
 import type { ContextData, Message } from "./types.js";
 
 // Configuration - can be overridden per-agent in the future
+// NOTE (2026-02-19): Reduced history window to prevent context overflow in active threads.
+// Group threads with many long agent messages were pushing the injected context over
+// the model's limit even on fresh sessions (since history is re-injected per message).
+// Previous: 5+15=20 messages. Current: 3+7=10 messages.
 const DEFAULT_CONFIG = {
   // How many recent messages to include at full length
-  fullLengthMessages: 5,
+  fullLengthMessages: 3,
   // How many additional messages to include (truncated)
-  additionalMessages: 15,
+  additionalMessages: 7,
   // Max chars for truncated messages (older ones in the window)
-  truncatedMaxChars: 500,
+  truncatedMaxChars: 400,
   // Max chars for full-length messages (most recent)
-  fullMaxChars: 2000,
+  fullMaxChars: 1500,
   // Max agent descriptions
   maxAgentDescChars: 120,
   // Max agents to show