feat: openclaw-embedded plugin — aligned with official plugin guide

[yilu331]

Summary

New self-contained Reflexio integration plugin at integrations/openclaw-embedded/. Delivers user profile and playbook capabilities entirely within Openclaw's native primitives (hooks, sub-agents, memory, heartbeat) with no Reflexio server dependency.

The plugin follows the official Openclaw plugin building guide — skills declared in manifest, config via api.pluginConfig, tools registered via api.registerTool(), and sub-agents injected via extraSystemPrompt.

Architecture

plugin/                          # Installed to ~/.openclaw/extensions/reflexio-embedded/
├── index.ts                     # Entry: hooks + 7 registered tools
├── openclaw.plugin.json         # Manifest with skills declaration
├── skills/                      # Auto-served via manifest
│   ├── reflexio-embedded/       # Main skill (profile/playbook detection)
│   └── reflexio-consolidate/    # On-demand consolidation
├── hook/
│   ├── handler.ts               # TTL sweep, extractor spawn, bootstrap reminder
│   └── setup.ts                 # HEARTBEAT.md append on first load
├── lib/                         # Deterministic control flow
│   ├── write-profile.ts         # validate → preprocess → search → judge → write → delete
│   ├── write-playbook.ts        # Same flow for playbooks
│   ├── dedup.ts                 # Query preprocessing + contradiction judgment via LLM
│   ├── search.ts                # Memory search with preprocessing
│   ├── io.ts                    # Atomic file I/O (nanoid, frontmatter, TTL)
│   └── openclaw-cli.ts          # CommandRunner type + openclaw CLI wrappers
├── agents/                      # Sub-agent definitions (injected via extraSystemPrompt)
├── prompts/                     # Prompt templates (read from extension dir at runtime)
└── HEARTBEAT.md                 # Structured heartbeat task for consolidation check

Registered Tools

Tool	Purpose
reflexio_write_profile	Write profile with dedup + contradiction detection
reflexio_write_playbook	Write playbook with dedup
reflexio_search	Preprocessed memory search
reflexio_consolidation_check	Heartbeat: returns OK or ALERT
reflexio_consolidation_mark_done	Mark consolidation complete
reflexio_run_consolidation	Spawn consolidator sub-agent

Key Design Decisions

• Skills in manifest — "skills": ["./skills"] enables auto-discovery and auto-cleanup on uninstall
• No workspace file copying — everything served from extension dir; openclaw plugins uninstall cleans up completely
• api.pluginConfig — users override config via openclaw.json, not by editing plugin files
• before_prompt_build — uses recommended hook (not deprecated before_agent_start) for prompt injection
• Heartbeat over cron — consolidation triggered by heartbeat check (adaptive, no cron registration needed)
• extraSystemPrompt injection — sub-agent definitions loaded from extension dir at runtime, no workspace/agents/ copy
• allowImportingTsExtensions — .ts import extensions (not .js) since plugin ships as TypeScript with noEmit
• CommandRunner DI — api.runtime.system.runCommandWithTimeout injected; tests use mock runner

Testing

• 47 vitest tests (io, dedup, search, write-profile, write-playbook)
• Hook smoke test
• Manual test plan in TESTING.md

Test Plan

• npm test — 47 tests pass
• bash scripts/install.sh — plugin installs, skills auto-available
• openclaw plugins uninstall reflexio-embedded — zero orphaned files
• Flow A: in-session profile capture works
• Flow B: in-session playbook capture works
• Flow C: session-end batch extraction works
• Heartbeat consolidation check returns OK/ALERT correctly