@happycastle/oh-my-openclaw 0.14.0 → 0.14.2

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.js

@@ -4,9 +4,10 @@ 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) => {
+    api.on('session_start', async (_event, ctx) => {
         try {
-            const activePersona = await getActivePersona();
+            const wsDir = ctx.workspaceDir;
+            const activePersona = await getActivePersona(wsDir);
             if (!activePersona)
                 return;
             const personaContent = readPersonaPromptSync(activePersona);
@@ -14,7 +15,7 @@ export function registerSessionSync(api) {
                 api.logger.warn(`${LOG_PREFIX} Session sync: persona file issue for ${activePersona}`);
                 return;
             }
-            const agentsPath = resolveAgentsMdPath();
+            const agentsPath = resolveAgentsMdPath(wsDir);
             try {
                 const current = readFileSync(agentsPath, 'utf-8');
                 if (current.includes(personaContent.slice(0, 100)))
@@ -23,7 +24,7 @@ export function registerSessionSync(api) {
             catch {
                 // AGENTS.md missing or unreadable — needs sync
             }
-            await replaceAgentsMd(personaContent);
+            await replaceAgentsMd(personaContent, wsDir);
             api.logger.info(`${LOG_PREFIX} Session sync: AGENTS.md re-synced with .omoc-state (persona=${activePersona})`);
         }
         catch (err) {

package/dist/hooks/spawn-guard.js

@@ -5,13 +5,13 @@ 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) => {
+    api.on('before_tool_call', async (event, ctx) => {
         if (event.toolName !== SPAWN_TOOL_NAME) {
             return;
         }
         let activePersona;
         try {
-            activePersona = await getActivePersona();
+            activePersona = await getActivePersona(ctx.workspaceDir);
         }
         catch {
             return;

package/dist/index.js

@@ -17,6 +17,7 @@ import { registerPersonaCommands } from './commands/persona-commands.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.
@@ -78,6 +79,11 @@ export default function register(api) {
         registry.hooks.push('gateway-startup');
         api.logger.info(`[${PLUGIN_ID}] Gateway startup 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');

package/dist/utils/config.js

@@ -1,14 +1,17 @@
+import { join } from 'path';
 import { ABSOLUTE_MAX_RALPH_ITERATIONS } from '../types.js';
+import { resolveOpenClawWorkspaceDir } from './paths.js';
 export function getConfig(api) {
+    const wsDir = resolveOpenClawWorkspaceDir();
     const defaults = {
         max_ralph_iterations: 10,
         todo_enforcer_enabled: false,
         todo_enforcer_cooldown_ms: 2000,
         todo_enforcer_max_failures: 5,
         comment_checker_enabled: true,
-        notepad_dir: 'workspace/notepads',
-        plans_dir: 'workspace/plans',
-        checkpoint_dir: 'workspace/checkpoints',
+        notepad_dir: join(wsDir, 'notepads'),
+        plans_dir: join(wsDir, 'plans'),
+        checkpoint_dir: join(wsDir, 'checkpoints'),
         tmux_socket: '/tmp/openclaw-tmux-sockets/openclaw.sock',
         model_routing: undefined,
     };

package/dist/utils/paths.d.ts

@@ -1,3 +1,9 @@
 export declare const PLUGIN_ROOT: string;
 export declare function resolvePluginPath(...segments: string[]): string;
 export declare function resolveWorkspacePath(workspaceDir: string, ...segments: string[]): string;
+/**
+ * Resolve the OpenClaw workspace directory (absolute path).
+ * Uses explicit workspaceDir when provided (e.g. from hook context),
+ * otherwise falls back to ~/.openclaw/workspace with OPENCLAW_PROFILE support.
+ */
+export declare function resolveOpenClawWorkspaceDir(workspaceDir?: string): string;

package/dist/utils/paths.js

@@ -1,5 +1,6 @@
 import { fileURLToPath } from 'url';
 import { dirname, join, resolve } from 'path';
+import { homedir } from 'os';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 // Resolves to plugin root (from dist/utils/ → go up ../../)
@@ -11,3 +12,16 @@ export function resolvePluginPath(...segments) {
 export function resolveWorkspacePath(workspaceDir, ...segments) {
     return join(workspaceDir, ...segments);
 }
+/**
+ * Resolve the OpenClaw workspace directory (absolute path).
+ * Uses explicit workspaceDir when provided (e.g. from hook context),
+ * otherwise falls back to ~/.openclaw/workspace with OPENCLAW_PROFILE support.
+ */
+export function resolveOpenClawWorkspaceDir(workspaceDir) {
+    if (workspaceDir)
+        return workspaceDir;
+    const profile = process.env.OPENCLAW_PROFILE?.trim();
+    return (profile && profile.toLowerCase() !== 'default')
+        ? join(homedir(), '.openclaw', `workspace-${profile}`)
+        : join(homedir(), '.openclaw', 'workspace');
+}

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

@@ -2,8 +2,9 @@ import type { OmocPluginApi } from '../types.js';
 export declare function initPersonaState(_api: OmocPluginApi): Promise<void>;
 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 getActivePersona(workspaceDir?: string): Promise<string | null>;
 export declare function resetPersonaState(): Promise<void>;
-export declare function resolveAgentsMdPath(): string;
-export declare function replaceAgentsMd(personaContent: string): Promise<void>;
-export declare function restoreAgentsMdToDefault(): Promise<void>;
+export declare const OFF_MARKER = "__OFF__";
+export declare function resolveAgentsMdPath(workspaceDir?: string): string;
+export declare function replaceAgentsMd(personaContent: string, workspaceDir?: string): Promise<void>;
+export declare function restoreAgentsMdToDefault(workspaceDir?: string): Promise<void>;

package/dist/utils/persona-state.js

@@ -1,13 +1,17 @@
 import { readFile, writeFile, mkdir } from 'fs/promises';
 import { dirname, join } from 'path';
-import { homedir } from 'os';
+import { resolveOpenClawWorkspaceDir } from './paths.js';
 let activePersonaId = null;
 let loaded = false;
-const stateDir = join('workspace', '.omoc-state');
-let stateFilePath = join(stateDir, 'active-persona');
+function resolveStateDir(workspaceDir) {
+    return join(resolveOpenClawWorkspaceDir(workspaceDir), '.omoc-state');
+}
+function resolveStateFilePath(workspaceDir) {
+    return join(resolveStateDir(workspaceDir), 'active-persona');
+}
 export async function initPersonaState(_api) {
     try {
-        await mkdir(dirname(stateFilePath), { recursive: true });
+        await mkdir(resolveStateDir(), { recursive: true });
     }
     catch (error) {
         console.warn('[omoc] Failed to initialize persona state directory:', error);
@@ -22,20 +26,20 @@ export async function setActivePersonaId(id) {
 export async function setActivePersona(id) {
     await setActivePersonaId(id);
 }
-export async function getActivePersona() {
+export async function getActivePersona(workspaceDir) {
     if (!loaded)
-        await loadFromDisk();
+        await loadFromDisk(workspaceDir);
     return activePersonaId;
 }
 export async function resetPersonaState() {
     activePersonaId = null;
     loaded = true;
-    await saveToDisk();
+    await saveOffState();
 }
-async function loadFromDisk() {
+async function loadFromDisk(workspaceDir) {
     try {
-        const content = (await readFile(stateFilePath, 'utf-8')).trim();
-        activePersonaId = content || null;
+        const content = (await readFile(resolveStateFilePath(workspaceDir), 'utf-8')).trim();
+        activePersonaId = (content && content !== OFF_MARKER) ? content : null;
     }
     catch (error) {
         // ENOENT is expected on first boot — no state file yet
@@ -46,30 +50,36 @@ 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');
+        await mkdir(resolveStateDir(), { recursive: true });
+        await writeFile(resolveStateFilePath(), activePersonaId ?? '', 'utf-8');
     }
     catch (error) {
         console.warn('[omoc] Failed to persist persona 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');
+async function saveOffState() {
+    try {
+        await mkdir(resolveStateDir(), { recursive: true });
+        await writeFile(resolveStateFilePath(), OFF_MARKER, 'utf-8');
+    }
+    catch (error) {
+        console.warn('[omoc] Failed to persist persona off-state to disk:', error);
+    }
+}
+export function resolveAgentsMdPath(workspaceDir) {
+    return join(resolveOpenClawWorkspaceDir(workspaceDir), 'AGENTS.md');
 }
-export async function replaceAgentsMd(personaContent) {
-    const agentsPath = resolveAgentsMdPath();
+export async function replaceAgentsMd(personaContent, workspaceDir) {
+    const agentsPath = resolveAgentsMdPath(workspaceDir);
     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();
+export async function restoreAgentsMdToDefault(workspaceDir) {
+    const agentsPath = resolveAgentsMdPath(workspaceDir);
     await mkdir(dirname(agentsPath), { recursive: true });
     await writeFile(agentsPath, DEFAULT_AGENTS_MD, 'utf-8');
 }

package/package.json

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