@happycastle/oh-my-openclaw 0.13.4 → 0.14.1

package/dist/commands/persona-commands.js

@@ -1,6 +1,6 @@
 import { LOG_PREFIX } from '../constants.js';
-import { getActivePersona, setActivePersonaId, resetPersonaState } from '../utils/persona-state.js';
-import { resolvePersonaId, listPersonas, DEFAULT_PERSONA_ID } from '../agents/persona-prompts.js';
+import { getActivePersona, setActivePersonaId, resetPersonaState, replaceAgentsMd, restoreAgentsMdToDefault } from '../utils/persona-state.js';
+import { resolvePersonaId, listPersonas, readPersonaPrompt, DEFAULT_PERSONA_ID } from '../agents/persona-prompts.js';
 function getDisplayName(personaId) {
     const persona = listPersonas().find((p) => p.id === personaId);
     return persona ? `${persona.emoji} ${persona.displayName}` : personaId;
@@ -17,22 +17,25 @@ export function registerPersonaCommands(api) {
             if (!args) {
                 const previousId = await getActivePersona();
                 await setActivePersonaId(DEFAULT_PERSONA_ID);
+                const content = await readPersonaPrompt(DEFAULT_PERSONA_ID);
+                await replaceAgentsMd(content);
                 const name = getDisplayName(DEFAULT_PERSONA_ID);
                 const switchNote = previousId && previousId !== DEFAULT_PERSONA_ID
                     ? `\n\nSwitched from **${getDisplayName(previousId)}**.`
                     : '';
                 return {
-                    text: `# OmOC Mode: ON\n\nActive persona: **${name}**${switchNote}\n\nApplied immediately — your next message will use this persona.\n\nUse \`/omoc list\` to see available personas, or \`/omoc <name>\` to switch.`,
+                    text: `# OmOC Mode: ON\n\nActive persona: **${name}**${switchNote}\n\nAGENTS.md replaced with persona prompt. Your next message will use this persona.\n\nUse \`/omoc list\` to see available personas, or \`/omoc <name>\` to switch.`,
                 };
             }
             if (args === 'off') {
                 const wasActive = await getActivePersona();
                 const wasName = wasActive ? getDisplayName(wasActive) : null;
                 await resetPersonaState();
+                await restoreAgentsMdToDefault();
                 return {
                     text: wasName
-                        ? `# OmOC Mode: OFF\n\nPersona **${wasName}** deactivated. Applied immediately — your next message will use default behavior.`
-                        : '# OmOC Mode: OFF\n\nNo persona was active.',
+                        ? `# OmOC Mode: OFF\n\nPersona **${wasName}** deactivated. AGENTS.md restored to default.`
+                        : '# OmOC Mode: OFF\n\nNo persona was active. AGENTS.md restored to default.',
                 };
             }
             if (args === 'list') {
@@ -66,13 +69,15 @@ export function registerPersonaCommands(api) {
             }
             const previousId = await getActivePersona();
             await setActivePersonaId(resolvedId);
+            const content = await readPersonaPrompt(resolvedId);
+            await replaceAgentsMd(content);
             const displayName = getDisplayName(resolvedId);
             const switched = listPersonas().find((p) => p.id === resolvedId);
             const switchNote = previousId && previousId !== resolvedId
                 ? `\n\nSwitched from **${getDisplayName(previousId)}**.`
                 : '';
             return {
-                text: `# Persona Switched\n\nActive persona: **${displayName}**${switchNote}\n\nApplied immediately — your next message will use the ${switched?.theme ?? 'persona'} prompt.`,
+                text: `# Persona Switched\n\nActive persona: **${displayName}**${switchNote}\n\nAGENTS.md replaced. Your next message will use the ${switched?.theme ?? 'persona'} prompt.`,
             };
         },
     });

package/dist/hooks/keyword-detector/analyze-mode.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Analyze mode — multilingual keyword regex.
+ * Necessary: documents 5-language regex for maintainability.
+ *
+ * EN: analyze, analyse, investigate, examine, research, study, deep-dive, inspect, audit, evaluate, assess, review, diagnose, scrutinize, dissect, debug, comprehend, interpret, breakdown, understand
+ * KO: 분석, 조사, 파악, 연구, 검토, 진단, 이해, 설명, 원인, 이유, 뜯어봐, 따져봐, 평가, 해석, 디버깅, 디버그, 어떻게, 왜, 살펴
+ * JA: 分析, 調査, 解析, 検討, 研究, 診断, 理解, 説明, 検証, 精査, 究明, デバッグ, なぜ, どう, 仕組み
+ * ZH: 调查, 检查, 剖析, 深入, 诊断, 解释, 调试, 为什么, 原理, 搞清楚, 弄明白
+ * VI: phân tích, điều tra, nghiên cứu, kiểm tra, xem xét, chẩn đoán, giải thích, tìm hiểu, gỡ lỗi, tại sao
+ */
+export declare const ANALYZE_PATTERN: RegExp;
+export declare const ANALYZE_MESSAGE = "[analyze-mode]\nANALYSIS MODE. Gather context from ALL channels before diving deep:\n\nCONTEXT GATHERING (parallel):\n- omoc_delegate(agent_id=\"omoc_explore\") \u2014 codebase patterns, implementations\n- omoc_delegate(agent_id=\"omoc_librarian\") \u2014 external docs, API references\n- web-search-prime / context7 \u2014 official docs, known issues, changelogs\n- grep_app.search \u2014 how others solved similar problems in OSS\n- gemini CLI with @google \u2014 Google Search grounding for real-time info\n\nVISUAL/MULTIMODAL ANALYSIS (if needed):\n- gemini CLI (via tmux) with -f flag \u2014 analyze PDFs, screenshots, architecture diagrams\n- omoc_look_at \u2014 quick multimodal analysis of images/screenshots\n\nIF COMPLEX \u2014 delegate to specialists:\n- omoc_delegate(agent_id=\"omoc_oracle\") \u2014 architecture, debugging, complex logic\n- omoc_delegate(category=\"artistry\") \u2014 unconventional approaches\n\nSYNTHESIZE findings before proceeding.";

package/dist/hooks/keyword-detector/analyze-mode.js

@@ -0,0 +1,30 @@
+/**
+ * Analyze mode — multilingual keyword regex.
+ * Necessary: documents 5-language regex for maintainability.
+ *
+ * EN: analyze, analyse, investigate, examine, research, study, deep-dive, inspect, audit, evaluate, assess, review, diagnose, scrutinize, dissect, debug, comprehend, interpret, breakdown, understand
+ * KO: 분석, 조사, 파악, 연구, 검토, 진단, 이해, 설명, 원인, 이유, 뜯어봐, 따져봐, 평가, 해석, 디버깅, 디버그, 어떻게, 왜, 살펴
+ * JA: 分析, 調査, 解析, 検討, 研究, 診断, 理解, 説明, 検証, 精査, 究明, デバッグ, なぜ, どう, 仕組み
+ * ZH: 调查, 检查, 剖析, 深入, 诊断, 解释, 调试, 为什么, 原理, 搞清楚, 弄明白
+ * VI: phân tích, điều tra, nghiên cứu, kiểm tra, xem xét, chẩn đoán, giải thích, tìm hiểu, gỡ lỗi, tại sao
+ */
+export const ANALYZE_PATTERN = /\b(analyze|analyse|investigate|examine|research|study|deep[\s-]?dive|inspect|audit|evaluate|assess|review|diagnose|scrutinize|dissect|debug|comprehend|interpret|breakdown|understand)\b|why\s+is|how\s+does|how\s+to|분석|조사|파악|연구|검토|진단|이해|설명|원인|이유|뜯어봐|따져봐|평가|해석|디버깅|디버그|어떻게|왜|살펴|分析|調査|解析|検討|研究|診断|理解|説明|検証|精査|究明|デバッグ|なぜ|どう|仕組み|调查|检查|剖析|深入|诊断|解释|调试|为什么|原理|搞清楚|弄明白|phân tích|điều tra|nghiên cứu|kiểm tra|xem xét|chẩn đoán|giải thích|tìm hiểu|gỡ lỗi|tại sao/i;
+export const ANALYZE_MESSAGE = `[analyze-mode]
+ANALYSIS MODE. Gather context from ALL channels before diving deep:
+
+CONTEXT GATHERING (parallel):
+- omoc_delegate(agent_id="omoc_explore") — codebase patterns, implementations
+- omoc_delegate(agent_id="omoc_librarian") — external docs, API references
+- web-search-prime / context7 — official docs, known issues, changelogs
+- grep_app.search — how others solved similar problems in OSS
+- gemini CLI with @google — Google Search grounding for real-time info
+
+VISUAL/MULTIMODAL ANALYSIS (if needed):
+- gemini CLI (via tmux) with -f flag — analyze PDFs, screenshots, architecture diagrams
+- omoc_look_at — quick multimodal analysis of images/screenshots
+
+IF COMPLEX — delegate to specialists:
+- omoc_delegate(agent_id="omoc_oracle") — architecture, debugging, complex logic
+- omoc_delegate(category="artistry") — unconventional approaches
+
+SYNTHESIZE findings before proceeding.`;

package/dist/hooks/keyword-detector/coding-mode.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Coding mode — multilingual keyword regex.
+ * Necessary: documents 5-language regex for maintainability.
+ *
+ * EN: implement, code, build, develop, refactor, fix, patch, write code, program, create, scaffold, migrate, port, convert
+ * KO: 구현, 코딩, 개발, 리팩토링, 수정, 패치, 코드 작성, 만들어, 짜줘, 고쳐, 빌드, 변환, 마이그레이션
+ * JA: 実装, コーディング, 開発, リファクタリング, 修正, パッチ, コード, 作って, ビルド, 変換
+ * ZH: 实现, 编码, 开发, 重构, 修复, 补丁, 写代码, 构建, 转换, 迁移
+ * VI: triển khai, lập trình, phát triển, tái cấu trúc, sửa lỗi, viết code, xây dựng, chuyển đổi
+ */
+export declare const CODING_PATTERN: RegExp;
+export declare const CODING_MESSAGE = "[coding-mode]\nCODING TASK DETECTED. Use the right execution channel:\n\nPRIMARY \u2014 tmux OpenCode/OmO session (opencode-controller skill):\n- Delegate implementation to OpenCode running in tmux for full OmO power\n- Use for: heavy coding, multi-file refactors, test writing, build/lint cycles\n\nALTERNATIVE \u2014 omoc_delegate for lighter tasks:\n- omoc_delegate(category=\"quick\", agent_id=\"omoc_sisyphus\") \u2014 simple fixes, single-file changes\n- omoc_delegate(category=\"deep\", agent_id=\"omoc_hephaestus\") \u2014 complex refactoring, architecture changes\n\nCONTEXT GATHERING (parallel, before coding):\n- omoc_delegate(agent_id=\"omoc_explore\") \u2014 understand existing patterns first\n- context7 / grep_app.search \u2014 check library APIs, find OSS examples\n\nVERIFICATION (after coding):\n- Run tests, linter, type-check, build via tmux opencode session\n- gemini CLI with -f flag \u2014 visual verification of UI changes if applicable";

package/dist/hooks/keyword-detector/coding-mode.js

@@ -0,0 +1,29 @@
+/**
+ * Coding mode — multilingual keyword regex.
+ * Necessary: documents 5-language regex for maintainability.
+ *
+ * EN: implement, code, build, develop, refactor, fix, patch, write code, program, create, scaffold, migrate, port, convert
+ * KO: 구현, 코딩, 개발, 리팩토링, 수정, 패치, 코드 작성, 만들어, 짜줘, 고쳐, 빌드, 변환, 마이그레이션
+ * JA: 実装, コーディング, 開発, リファクタリング, 修正, パッチ, コード, 作って, ビルド, 変換
+ * ZH: 实现, 编码, 开发, 重构, 修复, 补丁, 写代码, 构建, 转换, 迁移
+ * VI: triển khai, lập trình, phát triển, tái cấu trúc, sửa lỗi, viết code, xây dựng, chuyển đổi
+ */
+export const CODING_PATTERN = /\b(implement|code|build|develop|refactor|fix|patch|program|scaffold|migrate|port|convert)\b|write\s+code|구현|코딩|개발|리팩토링|수정|패치|코드\s*작성|만들어|짜줘|고쳐|빌드|변환|마이그레이션|実装|コーディング|開発|リファクタリング|修正|パッチ|コード|作って|ビルド|変換|实现|编码|开发|重构|修复|补丁|写代码|构建|转换|迁移|triển khai|lập trình|phát triển|tái cấu trúc|sửa lỗi|viết code|xây dựng|chuyển đổi/i;
+export const CODING_MESSAGE = `[coding-mode]
+CODING TASK DETECTED. Use the right execution channel:
+
+PRIMARY — tmux OpenCode/OmO session (opencode-controller skill):
+- Delegate implementation to OpenCode running in tmux for full OmO power
+- Use for: heavy coding, multi-file refactors, test writing, build/lint cycles
+
+ALTERNATIVE — omoc_delegate for lighter tasks:
+- omoc_delegate(category="quick", agent_id="omoc_sisyphus") — simple fixes, single-file changes
+- omoc_delegate(category="deep", agent_id="omoc_hephaestus") — complex refactoring, architecture changes
+
+CONTEXT GATHERING (parallel, before coding):
+- omoc_delegate(agent_id="omoc_explore") — understand existing patterns first
+- context7 / grep_app.search — check library APIs, find OSS examples
+
+VERIFICATION (after coding):
+- Run tests, linter, type-check, build via tmux opencode session
+- gemini CLI with -f flag — visual verification of UI changes if applicable`;

package/dist/hooks/keyword-detector/detector.d.ts

@@ -0,0 +1,6 @@
+export type KeywordType = 'ultrawork' | 'search' | 'analyze' | 'coding';
+export interface DetectedKeyword {
+    type: KeywordType;
+    message: string;
+}
+export declare function detectKeywords(text: string): DetectedKeyword[];

package/dist/hooks/keyword-detector/detector.js

@@ -0,0 +1,21 @@
+import { SEARCH_PATTERN, SEARCH_MESSAGE } from './search-mode.js';
+import { ANALYZE_PATTERN, ANALYZE_MESSAGE } from './analyze-mode.js';
+import { ULTRAWORK_PATTERN, ULTRAWORK_MESSAGE } from './ultrawork-mode.js';
+import { CODING_PATTERN, CODING_MESSAGE } from './coding-mode.js';
+const CODE_BLOCK_PATTERN = /```[\s\S]*?```/g;
+const INLINE_CODE_PATTERN = /`[^`]+`/g;
+const KEYWORD_DETECTORS = [
+    { type: 'ultrawork', pattern: ULTRAWORK_PATTERN, message: ULTRAWORK_MESSAGE },
+    { type: 'search', pattern: SEARCH_PATTERN, message: SEARCH_MESSAGE },
+    { type: 'analyze', pattern: ANALYZE_PATTERN, message: ANALYZE_MESSAGE },
+    { type: 'coding', pattern: CODING_PATTERN, message: CODING_MESSAGE },
+];
+function removeCodeBlocks(text) {
+    return text.replace(CODE_BLOCK_PATTERN, '').replace(INLINE_CODE_PATTERN, '');
+}
+export function detectKeywords(text) {
+    const cleaned = removeCodeBlocks(text);
+    return KEYWORD_DETECTORS
+        .filter(({ pattern }) => pattern.test(cleaned))
+        .map(({ type, message }) => ({ type, message }));
+}

package/dist/hooks/keyword-detector/hook.d.ts

@@ -0,0 +1,2 @@
+import { OmocPluginApi } from '../../types.js';
+export declare function registerKeywordDetector(api: OmocPluginApi): void;

package/dist/hooks/keyword-detector/hook.js

@@ -0,0 +1,15 @@
+import { LOG_PREFIX } from '../../constants.js';
+import { detectKeywords } from './detector.js';
+export function registerKeywordDetector(api) {
+    api.on('before_prompt_build', (event, _ctx) => {
+        const prompt = event.prompt;
+        if (!prompt || typeof prompt !== 'string')
+            return;
+        const detected = detectKeywords(prompt);
+        if (detected.length === 0)
+            return;
+        const merged = detected.map((k) => k.message).join('\n\n');
+        api.logger.info(`${LOG_PREFIX} Keyword detector: ${detected.map((k) => k.type).join(', ')} detected`);
+        return { prependContext: merged };
+    }, { priority: 75 });
+}

package/dist/hooks/keyword-detector/search-mode.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Search mode — multilingual keyword regex.
+ * Necessary: documents 5-language regex for maintainability.
+ *
+ * EN: search, find, locate, lookup, explore, discover, scan, grep, query, browse, detect, trace, seek, track, pinpoint, hunt
+ * KO: 검색, 찾아, 탐색, 조회, 스캔, 서치, 뒤져, 찾기, 어디, 추적, 탐지, 찾아봐, 찾아내, 보여줘, 목록
+ * JA: 検索, 探して, 見つけて, サーチ, 探索, スキャン, どこ, 発見, 捜索, 見つけ出す, 一覧
+ * ZH: 搜索, 查找, 寻找, 查询, 检索, 定位, 扫描, 发现, 在哪里, 找出来, 列出
+ * VI: tìm kiếm, tra cứu, định vị, quét, phát hiện, truy tìm, tìm ra, ở đâu, liệt kê
+ */
+export declare const SEARCH_PATTERN: RegExp;
+export declare const SEARCH_MESSAGE = "[search-mode]\nMAXIMIZE SEARCH EFFORT. Use ALL available channels IN PARALLEL:\n\nAGENT DELEGATION (omoc_delegate):\n- agent_id=\"omoc_explore\" \u2014 codebase patterns, file structures, cross-module references\n- agent_id=\"omoc_librarian\" \u2014 external docs, OSS examples, API references\n\nWEB SEARCH (mcporter MCP + OpenClaw native):\n- web-search-prime.webSearchPrime \u2014 keyword web search (news, blogs, latest info)\n- exa.web_search_exa \u2014 semantic web search (better for question-format queries)\n- context7 \u2014 library/framework official documentation\n- grep_app.search \u2014 open-source code pattern search on GitHub\n- zread \u2014 direct GitHub repo file exploration\n- web_fetch \u2014 direct URL reading\n\nGEMINI CLI (via tmux gemini session):\n- gemini with @google extension \u2014 Google Search grounding for real-time info\n- gemini with -f flag \u2014 analyze PDFs/images/screenshots if visual context needed\n\nLaunch multiple delegates + web searches simultaneously.\nNEVER stop at first result \u2014 be exhaustive.";

package/dist/hooks/keyword-detector/search-mode.js

@@ -0,0 +1,32 @@
+/**
+ * Search mode — multilingual keyword regex.
+ * Necessary: documents 5-language regex for maintainability.
+ *
+ * EN: search, find, locate, lookup, explore, discover, scan, grep, query, browse, detect, trace, seek, track, pinpoint, hunt
+ * KO: 검색, 찾아, 탐색, 조회, 스캔, 서치, 뒤져, 찾기, 어디, 추적, 탐지, 찾아봐, 찾아내, 보여줘, 목록
+ * JA: 検索, 探して, 見つけて, サーチ, 探索, スキャン, どこ, 発見, 捜索, 見つけ出す, 一覧
+ * ZH: 搜索, 查找, 寻找, 查询, 检索, 定位, 扫描, 发现, 在哪里, 找出来, 列出
+ * VI: tìm kiếm, tra cứu, định vị, quét, phát hiện, truy tìm, tìm ra, ở đâu, liệt kê
+ */
+export const SEARCH_PATTERN = /\b(search|find|locate|lookup|look\s*up|explore|discover|scan|grep|query|browse|detect|trace|seek|track|pinpoint|hunt)\b|where\s+is|show\s+me|list\s+all|검색|찾아|탐색|조회|스캔|서치|뒤져|찾기|어디|추적|탐지|찾아봐|찾아내|보여줘|목록|検索|探して|見つけて|サーチ|探索|スキャン|どこ|発見|捜索|見つけ出す|一覧|搜索|查找|寻找|查询|检索|定位|扫描|发现|在哪里|找出来|列出|tìm kiếm|tra cứu|định vị|quét|phát hiện|truy tìm|tìm ra|ở đâu|liệt kê/i;
+export const SEARCH_MESSAGE = `[search-mode]
+MAXIMIZE SEARCH EFFORT. Use ALL available channels IN PARALLEL:
+
+AGENT DELEGATION (omoc_delegate):
+- agent_id="omoc_explore" — codebase patterns, file structures, cross-module references
+- agent_id="omoc_librarian" — external docs, OSS examples, API references
+
+WEB SEARCH (mcporter MCP + OpenClaw native):
+- web-search-prime.webSearchPrime — keyword web search (news, blogs, latest info)
+- exa.web_search_exa — semantic web search (better for question-format queries)
+- context7 — library/framework official documentation
+- grep_app.search — open-source code pattern search on GitHub
+- zread — direct GitHub repo file exploration
+- web_fetch — direct URL reading
+
+GEMINI CLI (via tmux gemini session):
+- gemini with @google extension — Google Search grounding for real-time info
+- gemini with -f flag — analyze PDFs/images/screenshots if visual context needed
+
+Launch multiple delegates + web searches simultaneously.
+NEVER stop at first result — be exhaustive.`;

package/dist/hooks/keyword-detector/ultrawork-mode.d.ts

@@ -0,0 +1,2 @@
+export declare const ULTRAWORK_PATTERN: RegExp;
+export declare const ULTRAWORK_MESSAGE = "[ultrawork-mode]\nULTRAWORK MODE ACTIVATED. Maximum precision engaged. ALL channels available.\n\nMANDATORY WORKFLOW:\n1. PLANNING: omoc_delegate(agent_id=\"omoc_prometheus\") \u2014 strategic breakdown\n2. REVIEW: omoc_delegate(agent_id=\"omoc_momus\") \u2014 plan critique before execution\n3. EXECUTION: tmux opencode session for coding, omoc_delegate for non-coding tasks\n4. VERIFICATION: Run diagnostics, tests, build after completion\n\nAGENT DELEGATION (omoc_delegate):\n- Prometheus \u2014 strategic planning\n- Oracle \u2014 architecture decisions, root cause analysis\n- Explore/Librarian \u2014 context gathering (parallel, background=true)\n- Momus \u2014 plan review and gap detection\n- Sisyphus/Hephaestus \u2014 task execution\n\nRESEARCH & ANALYSIS:\n- mcporter MCP (web-search-prime, exa, context7, grep_app, zread) \u2014 web research\n- gemini CLI with @google \u2014 Google Search grounding for real-time info\n- gemini CLI with -f flag \u2014 multimodal analysis (PDFs, images, diagrams)\n- omoc_look_at \u2014 quick visual analysis\n\nDO NOT CUT CORNERS. Every step verified. Every todo completed.";

package/dist/hooks/keyword-detector/ultrawork-mode.js

@@ -0,0 +1,24 @@
+export const ULTRAWORK_PATTERN = /\b(ultrawork|ulw)\b/i;
+export const ULTRAWORK_MESSAGE = `[ultrawork-mode]
+ULTRAWORK MODE ACTIVATED. Maximum precision engaged. ALL channels available.
+
+MANDATORY WORKFLOW:
+1. PLANNING: omoc_delegate(agent_id="omoc_prometheus") — strategic breakdown
+2. REVIEW: omoc_delegate(agent_id="omoc_momus") — plan critique before execution
+3. EXECUTION: tmux opencode session for coding, omoc_delegate for non-coding tasks
+4. VERIFICATION: Run diagnostics, tests, build after completion
+
+AGENT DELEGATION (omoc_delegate):
+- Prometheus — strategic planning
+- Oracle — architecture decisions, root cause analysis
+- Explore/Librarian — context gathering (parallel, background=true)
+- Momus — plan review and gap detection
+- Sisyphus/Hephaestus — task execution
+
+RESEARCH & ANALYSIS:
+- mcporter MCP (web-search-prime, exa, context7, grep_app, zread) — web research
+- gemini CLI with @google — Google Search grounding for real-time info
+- gemini CLI with -f flag — multimodal analysis (PDFs, images, diagrams)
+- omoc_look_at — quick visual analysis
+
+DO NOT CUT CORNERS. Every step verified. Every todo completed.`;

package/dist/hooks/session-sync.d.ts

@@ -0,0 +1,3 @@
+import { OmocPluginApi } from '../types.js';
+/** session_start hook: re-sync AGENTS.md from `.omoc-state` (source of truth). */
+export declare function registerSessionSync(api: OmocPluginApi): void;

package/dist/hooks/session-sync.js

@@ -0,0 +1,33 @@
+import { LOG_PREFIX } from '../constants.js';
+import { getActivePersona, resolveAgentsMdPath, replaceAgentsMd } from '../utils/persona-state.js';
+import { readPersonaPromptSync } from '../agents/persona-prompts.js';
+import { readFileSync } from 'fs';
+/** session_start hook: re-sync AGENTS.md from `.omoc-state` (source of truth). */
+export function registerSessionSync(api) {
+    api.on('session_start', async (_event, _ctx) => {
+        try {
+            const activePersona = await getActivePersona();
+            if (!activePersona)
+                return;
+            const personaContent = readPersonaPromptSync(activePersona);
+            if (personaContent.startsWith('[OmOC]')) {
+                api.logger.warn(`${LOG_PREFIX} Session sync: persona file issue for ${activePersona}`);
+                return;
+            }
+            const agentsPath = resolveAgentsMdPath();
+            try {
+                const current = readFileSync(agentsPath, 'utf-8');
+                if (current.includes(personaContent.slice(0, 100)))
+                    return;
+            }
+            catch {
+                // AGENTS.md missing or unreadable — needs sync
+            }
+            await replaceAgentsMd(personaContent);
+            api.logger.info(`${LOG_PREFIX} Session sync: AGENTS.md re-synced with .omoc-state (persona=${activePersona})`);
+        }
+        catch (err) {
+            api.logger.error(`${LOG_PREFIX} Session sync failed:`, err);
+        }
+    }, { priority: 200 });
+}

package/dist/hooks/spawn-guard.d.ts

@@ -0,0 +1,3 @@
+import { OmocPluginApi } from '../types.js';
+/** before_tool_call hook: block sessions_spawn without agentId when OmOC persona is active. */
+export declare function registerSpawnGuard(api: OmocPluginApi): void;

package/dist/hooks/spawn-guard.js

@@ -0,0 +1,33 @@
+import { LOG_PREFIX } from '../constants.js';
+import { getActivePersona } from '../utils/persona-state.js';
+import { ALL_AGENT_IDS } from '../agents/agent-ids.js';
+const SPAWN_TOOL_NAME = 'sessions_spawn';
+const AVAILABLE_AGENTS = ALL_AGENT_IDS.map((id) => id.replace('omoc_', '')).join(', ');
+/** before_tool_call hook: block sessions_spawn without agentId when OmOC persona is active. */
+export function registerSpawnGuard(api) {
+    api.on('before_tool_call', async (event, _ctx) => {
+        if (event.toolName !== SPAWN_TOOL_NAME) {
+            return;
+        }
+        let activePersona;
+        try {
+            activePersona = await getActivePersona();
+        }
+        catch {
+            return;
+        }
+        if (!activePersona)
+            return;
+        const agentId = event.params.agentId;
+        if (typeof agentId === 'string' && agentId.trim().length > 0)
+            return;
+        api.logger.info(`${LOG_PREFIX} Spawn guard: blocked sessions_spawn without agentId (active persona=${activePersona})`);
+        return {
+            block: true,
+            blockReason: `[OmOC] Sub-agent spawn BLOCKED: agentId is required when OmOC persona is active (current: ${activePersona}). ` +
+                `You MUST provide the agentId parameter in your sessions_spawn call. ` +
+                `Available agents: ${AVAILABLE_AGENTS}. ` +
+                `Retry with agentId set to the appropriate agent for this task.`,
+        };
+    }, { priority: 150 });
+}

package/dist/index.js

@@ -14,8 +14,10 @@ import { registerWorkflowCommands } from './commands/workflow-commands.js';
 import { registerRalphCommands } from './commands/ralph-commands.js';
 import { registerStatusCommands } from './commands/status-commands.js';
 import { registerPersonaCommands } from './commands/persona-commands.js';
-import { registerPersonaInjector } from './hooks/persona-injector.js';
 import { registerContextInjector } from './hooks/context-injector.js';
+import { registerSessionSync } from './hooks/session-sync.js';
+import { registerSpawnGuard } from './hooks/spawn-guard.js';
+import { registerKeywordDetector } from './hooks/keyword-detector/hook.js';
 import { registerSetupCli } from './cli/setup.js';
 /**
  * Generation counter for multi-registration handling.
@@ -77,16 +79,26 @@ export default function register(api) {
         registry.hooks.push('gateway-startup');
         api.logger.info(`[${PLUGIN_ID}] Gateway startup hook registered`);
     });
-    safeRegister(api, 'persona-injector', 'hook', () => {
-        registerPersonaInjector(guarded);
-        registry.hooks.push('persona-injector');
-        api.logger.info(`[${PLUGIN_ID}] Persona injector hook registered`);
+    safeRegister(api, 'keyword-detector', 'hook', () => {
+        registerKeywordDetector(guarded);
+        registry.hooks.push('keyword-detector');
+        api.logger.info(`[${PLUGIN_ID}] Keyword detector hook registered (before_prompt_build, priority 75)`);
     });
     safeRegister(api, 'context-injector', 'hook', () => {
         registerContextInjector(guarded);
         registry.hooks.push('context-injector');
         api.logger.info(`[${PLUGIN_ID}] Context injector hook registered (before_prompt_build)`);
     });
+    safeRegister(api, 'session-sync', 'hook', () => {
+        registerSessionSync(api);
+        registry.hooks.push('session-sync');
+        api.logger.info(`[${PLUGIN_ID}] Session sync hook registered (session_start)`);
+    });
+    safeRegister(api, 'spawn-guard', 'hook', () => {
+        registerSpawnGuard(api);
+        registry.hooks.push('spawn-guard');
+        api.logger.info(`[${PLUGIN_ID}] Spawn guard hook registered (before_tool_call)`);
+    });
     safeRegister(api, 'ralph-loop', 'service', () => {
         registerRalphLoop(api);
         registry.services.push('ralph-loop');

package/dist/types.d.ts

@@ -118,4 +118,5 @@ export interface BeforePromptBuildResult {
 export interface BeforePromptBuildEvent {
     prompt?: string;
     messages?: unknown[];
+    systemPrompt?: string;
 }

package/dist/utils/persona-state.d.ts

@@ -4,3 +4,7 @@ export declare function setActivePersonaId(id: string | null): Promise<void>;
 export declare function setActivePersona(id: string | null): Promise<void>;
 export declare function getActivePersona(): Promise<string | null>;
 export declare function resetPersonaState(): Promise<void>;
+export declare const OFF_MARKER = "__OFF__";
+export declare function resolveAgentsMdPath(): string;
+export declare function replaceAgentsMd(personaContent: string): Promise<void>;
+export declare function restoreAgentsMdToDefault(): Promise<void>;

package/dist/utils/persona-state.js

@@ -1,8 +1,10 @@
 import { readFile, writeFile, mkdir } from 'fs/promises';
 import { dirname, join } from 'path';
+import { homedir } from 'os';
 let activePersonaId = null;
 let loaded = false;
-let stateFilePath = join('workspace', '.omoc-state', 'active-persona');
+const stateDir = join('workspace', '.omoc-state');
+let stateFilePath = join(stateDir, 'active-persona');
 export async function initPersonaState(_api) {
     try {
         await mkdir(dirname(stateFilePath), { recursive: true });
@@ -28,12 +30,12 @@ export async function getActivePersona() {
 export async function resetPersonaState() {
     activePersonaId = null;
     loaded = true;
-    await saveToDisk();
+    await saveOffState();
 }
 async function loadFromDisk() {
     try {
         const content = (await readFile(stateFilePath, 'utf-8')).trim();
-        activePersonaId = content || null;
+        activePersonaId = (content && content !== OFF_MARKER) ? content : null;
     }
     catch (error) {
         // ENOENT is expected on first boot — no state file yet
@@ -44,13 +46,83 @@ async function loadFromDisk() {
     }
     loaded = true;
 }
+export const OFF_MARKER = '__OFF__';
 async function saveToDisk() {
     try {
         await mkdir(dirname(stateFilePath), { recursive: true });
         await writeFile(stateFilePath, activePersonaId ?? '', 'utf-8');
     }
     catch (error) {
-        // silent fail — in-memory state still works, but log for debugging
         console.warn('[omoc] Failed to persist persona state to disk:', error);
     }
 }
+async function saveOffState() {
+    try {
+        await mkdir(dirname(stateFilePath), { recursive: true });
+        await writeFile(stateFilePath, OFF_MARKER, 'utf-8');
+    }
+    catch (error) {
+        console.warn('[omoc] Failed to persist persona off-state to disk:', error);
+    }
+}
+export function resolveAgentsMdPath() {
+    const profile = process.env.OPENCLAW_PROFILE?.trim();
+    const wsDir = (profile && profile.toLowerCase() !== 'default')
+        ? join(homedir(), '.openclaw', `workspace-${profile}`)
+        : join(homedir(), '.openclaw', 'workspace');
+    return join(wsDir, 'AGENTS.md');
+}
+export async function replaceAgentsMd(personaContent) {
+    const agentsPath = resolveAgentsMdPath();
+    await mkdir(dirname(agentsPath), { recursive: true });
+    const merged = `${DEFAULT_AGENTS_MD}\n---\n\n${personaContent}`;
+    await writeFile(agentsPath, merged, 'utf-8');
+}
+export async function restoreAgentsMdToDefault() {
+    const agentsPath = resolveAgentsMdPath();
+    await mkdir(dirname(agentsPath), { recursive: true });
+    await writeFile(agentsPath, DEFAULT_AGENTS_MD, 'utf-8');
+}
+const DEFAULT_AGENTS_MD = `# AGENTS.md - Your Workspace
+
+This folder is home. Treat it that way.
+
+## First Run
+
+If \`BOOTSTRAP.md\` exists, that's your birth certificate. Follow it, figure out who you are, then delete it. You won't need it again.
+
+## Every Session
+
+Before doing anything else:
+
+1. Read \`SOUL.md\` — this is who you are
+2. Read \`USER.md\` — this is who you're helping
+3. Read \`memory/YYYY-MM-DD.md\` (today + yesterday) for recent context
+4. **If in MAIN SESSION** (direct chat with your human): Also read \`MEMORY.md\`
+
+Don't ask permission. Just do it.
+
+## Memory
+
+You wake up fresh each session. These files are your continuity:
+
+- **Daily notes:** \`memory/YYYY-MM-DD.md\` (create \`memory/\` if needed) — raw logs of what happened
+- **Long-term:** \`MEMORY.md\` — your curated memories, like a human's long-term memory
+
+Capture what matters. Decisions, context, things to remember. Skip the secrets unless asked to keep them.
+
+## Safety
+
+- Don't exfiltrate private data. Ever.
+- Don't run destructive commands without asking.
+- \`trash\` > \`rm\` (recoverable beats gone forever)
+- When in doubt, ask.
+
+## Tools
+
+Skills provide your tools. When you need one, check its \`SKILL.md\`. Keep local notes in \`TOOLS.md\`.
+
+## Make It Yours
+
+This is a starting point. Add your own conventions, style, and rules as you figure out what works.
+`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happycastle/oh-my-openclaw",
-  "version": "0.13.4",
+  "version": "0.14.1",
   "description": "Oh-My-OpenClaw plugin — multi-agent orchestration, todo enforcer, ralph loop, and custom tools for OpenClaw",
   "type": "module",
   "main": "dist/index.js",

package/dist/hooks/persona-injector.d.ts

@@ -1,10 +0,0 @@
-import { OmocPluginApi } from '../types.js';
-/**
- * Check whether persona content is already present in session history.
- *
- * OpenClaw's `prependContext` is merged into the user prompt and persisted
- * in session history. Without this check the persona text accumulates —
- * appearing once per historical user message sent to the model.
- */
-export declare function isPersonaAlreadyInHistory(messages: unknown[] | undefined, personaContent: string): boolean;
-export declare function registerPersonaInjector(api: OmocPluginApi): void;

package/dist/hooks/persona-injector.js

@@ -1,87 +0,0 @@
-import { LOG_PREFIX } from '../constants.js';
-import { getActivePersona } from '../utils/persona-state.js';
-import { readPersonaPromptSync, resolvePersonaId } from '../agents/persona-prompts.js';
-/**
- * Resolve the effective persona ID.
- *
- * Priority:
- *   1. Manually set persona via /omoc command (getActivePersona())
- *   2. agentId from the hook context (set by OpenClaw core)
- *   3. null — no persona to inject
- */
-async function resolveEffectivePersona(ctx) {
-    const manual = await getActivePersona();
-    if (manual) {
-        const resolved = resolvePersonaId(manual);
-        if (resolved)
-            return { personaId: resolved, source: 'manual' };
-    }
-    const agentId = ctx.agentId;
-    if (!agentId)
-        return null;
-    const resolved = resolvePersonaId(agentId);
-    if (!resolved)
-        return null;
-    return { personaId: resolved, source: 'auto' };
-}
-const FINGERPRINT_LENGTH = 200;
-/**
- * Check whether persona content is already present in session history.
- *
- * OpenClaw's `prependContext` is merged into the user prompt and persisted
- * in session history. Without this check the persona text accumulates —
- * appearing once per historical user message sent to the model.
- */
-export function isPersonaAlreadyInHistory(messages, personaContent) {
-    if (!messages || messages.length === 0)
-        return false;
-    const fingerprint = personaContent.slice(0, FINGERPRINT_LENGTH).trim();
-    if (!fingerprint)
-        return false;
-    for (const msg of messages) {
-        if (!msg || typeof msg !== 'object')
-            continue;
-        const record = msg;
-        if (record['role'] !== 'user')
-            continue;
-        const content = record['content'];
-        if (typeof content === 'string' && content.includes(fingerprint)) {
-            return true;
-        }
-    }
-    return false;
-}
-export function registerPersonaInjector(api) {
-    // Use the typed hook system (api.on) for before_prompt_build.
-    // This directly injects into the system prompt via prependContext,
-    // which is more reliable than bootstrapFiles via agent:bootstrap.
-    //
-    // api.registerHook('before_prompt_build', ...) registers into the internal
-    // hook system which does NOT trigger before_prompt_build — only hookRunner
-    // (typed hooks via api.on) does.
-    api.on('before_prompt_build', async (event, ctx) => {
-        const result = await resolveEffectivePersona(ctx);
-        if (!result) {
-            const manual = await getActivePersona();
-            api.logger.info(`${LOG_PREFIX} Persona injector: no persona resolved (agentId=${ctx.agentId ?? 'none'}, manual=${manual ?? 'none'})`);
-            return;
-        }
-        const { personaId, source } = result;
-        try {
-            const content = readPersonaPromptSync(personaId);
-            if (isPersonaAlreadyInHistory(event.messages, content)) {
-                api.logger.info(`${LOG_PREFIX} Persona already in history, skipping injection: ${personaId} (${source})`);
-                return;
-            }
-            api.logger.info(`${LOG_PREFIX} Persona injected via before_prompt_build: ${personaId} (${source}, agentId=${ctx.agentId ?? 'none'})`);
-            return {
-                prependContext: content,
-            };
-        }
-        catch (err) {
-            api.logger.error(`${LOG_PREFIX} Failed to inject persona ${personaId}:`, err);
-            return;
-        }
-    }, { priority: 100 } // High priority — persona prompt should be prepended first
-    );
-}