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 
8const REMINDER_NAME = 'SELF_IMPROVEMENT_REMINDER.md';
9const REMINDER_PATH = REMINDER_NAME;
10 
11const REMINDER_CONTENT = `
12## Self-Improvement Reminder
13 
14After completing tasks, evaluate whether any learnings should be captured.
15 
16Only log if this repo or workspace is using the self-improvement skill.
17 
18Before logging:
19- Create only missing \`.learnings/\` files; never overwrite existing content
20- Do not log secrets, tokens, private keys, environment variables, or raw transcripts
21- Prefer short summaries or redacted excerpts over full command output
22 
23**Log when:**
24- User corrects you → \`.learnings/LEARNINGS.md\`
25- Command/operation fails → \`.learnings/ERRORS.md\`
26- User wants missing capability → \`.learnings/FEATURE_REQUESTS.md\`
27- You discover your knowledge was wrong → \`.learnings/LEARNINGS.md\`
28- You find a better approach → \`.learnings/LEARNINGS.md\`
29 
30**Promote when pattern is proven:**
31- Behavioral patterns → \`SOUL.md\`
32- Workflow improvements → \`AGENTS.md\`
33- Tool gotchas → \`TOOLS.md\`
34 
35Keep entries simple: date, title, what happened, and what to do differently.
36`.trim();
37 
38function isObject(value) {
39  return !!value && typeof value === 'object';
40}
41 
42function isInjectedReminderFile(value) {
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 = 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 
111module.exports = handler;
112module.exports.default = handler;
113