1/**
2 * Self-Improvement Hook for OpenClaw
3 * 
4 * Injects a reminder to evaluate learnings during agent bootstrap.
5 * Fires on agent:bootstrap event before workspace files are injected.
6 */
7 
8import type { HookHandler } from 'openclaw/hooks';
9 
10const REMINDER_NAME = 'SELF_IMPROVEMENT_REMINDER.md';
11const REMINDER_PATH = REMINDER_NAME;
12 
13const REMINDER_CONTENT = `## Self-Improvement Reminder
14 
15After completing tasks, evaluate whether any learnings should be captured.
16 
17Only log if this repo or workspace is using the self-improvement skill.
18 
19Before logging:
20- Create only missing \`.learnings/\` files; never overwrite existing content
21- Do not log secrets, tokens, private keys, environment variables, or raw transcripts
22- Prefer short summaries or redacted excerpts over full command output
23 
24**Log when:**
25- User corrects you → \`.learnings/LEARNINGS.md\`
26- Command/operation fails → \`.learnings/ERRORS.md\`
27- User wants missing capability → \`.learnings/FEATURE_REQUESTS.md\`
28- You discover your knowledge was wrong → \`.learnings/LEARNINGS.md\`
29- You find a better approach → \`.learnings/LEARNINGS.md\`
30 
31**Promote when pattern is proven:**
32- Behavioral patterns → \`SOUL.md\`
33- Workflow improvements → \`AGENTS.md\`
34- Tool gotchas → \`TOOLS.md\`
35 
36Keep entries simple: date, title, what happened, and what to do differently.`;
37 
38function isObject(value: unknown): value is Record<string, unknown> {
39  return !!value && typeof value === 'object';
40}
41 
42function isInjectedReminderFile(value: unknown): boolean {
43  if (!isObject(value) || value.path !== REMINDER_PATH) {
44    return false;
45  }
46 
47  return (
48    value.virtual === true ||
49    value.content === REMINDER_CONTENT
50  );
51}
52 
53const handler: HookHandler = async (event) => {
54  // Safety checks for event structure
55  if (!event || typeof event !== 'object') {
56    return;
57  }
58 
59  // Only handle agent:bootstrap events
60  if (event.type !== 'agent' || event.action !== 'bootstrap') {
61    return;
62  }
63 
64  // Safety check for context
65  if (!event.context || typeof event.context !== 'object') {
66    return;
67  }
68 
69  // Skip sub-agent sessions to avoid bootstrap issues
70  // Sub-agents have sessionKey patterns like "agent:main:subagent:..."
71  const sessionKey = event.sessionKey || '';
72  if (sessionKey.includes(':subagent:')) {
73    return;
74  }
75 
76  // Inject the reminder as a virtual bootstrap file
77  // Check that bootstrapFiles is an array before pushing
78  if (Array.isArray(event.context.bootstrapFiles)) {
79    const occupiedByOtherFile = event.context.bootstrapFiles.some(
80      (file) => isObject(file) && file.path === REMINDER_PATH && !isInjectedReminderFile(file),
81    );
82    if (occupiedByOtherFile) {
83      return;
84    }
85 
86    const cleanedBootstrapFiles = event.context.bootstrapFiles.filter(
87      (file, index, files) =>
88        !isInjectedReminderFile(file) ||
89        files.findIndex((candidate) => isInjectedReminderFile(candidate)) === index,
90    );
91 
92    const reminderFile = {
93      name: REMINDER_NAME,
94      path: REMINDER_PATH,
95      content: REMINDER_CONTENT,
96      missing: false,
97      virtual: true,
98    };
99 
100    const existingIndex = cleanedBootstrapFiles.findIndex((file) => isInjectedReminderFile(file));
101    if (existingIndex === -1) {
102      cleanedBootstrapFiles.push(reminderFile);
103    } else {
104      cleanedBootstrapFiles[existingIndex] = reminderFile;
105    }
106 
107    event.context.bootstrapFiles = cleanedBootstrapFiles;
108  }
109};
110 
111export default handler;
112