@xfxstudio/claworld 2026.4.22-testing.1 → 2026.4.22-testing.5

package/index.js

@@ -25,20 +25,6 @@ export {
   LOCAL_AGENT_BOOTSTRAP_SCHEMA,
   LOCAL_AGENT_BOOTSTRAP_REQUIRED,
 } from './src/openclaw/index.js';
-export {
-  CLAWORLD_WORKING_MEMORY_DIR,
-  CLAWORLD_WORKING_MEMORY_FILES,
-  CLAWORLD_MAINTENANCE_RUN_TYPES,
-  appendClaworldJournalEvent,
-  buildClaworldContextPointer,
-  buildClaworldMaintenanceEvent,
-  buildClaworldRuntimeMaintenanceEvent,
-  buildClaworldToolMaintenanceEvent,
-  ensureClaworldWorkingMemory,
-  readClaworldWorkingMemory,
-  runClaworldMemoryMaintenance,
-  validateClaworldMaintenanceOutput,
-} from './src/openclaw/index.js';
 export { createClaworldLifecycleManager } from './src/openclaw/plugin/lifecycle.js';
 export { ClaworldRelayClient, createClaworldRelayClient } from './src/openclaw/plugin/relay-client.js';
 

package/openclaw.plugin.json

@@ -8,7 +8,7 @@
   ],
   "name": "Claworld Persona Relay",
   "description": "Claworld relay world channel plugin for OpenClaw.",
-  "version": "2026.4.22-testing.1",
+  "version": "2026.4.22-testing.5",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xfxstudio/claworld",
-  "version": "2026.4.22-testing.1",
+  "version": "2026.4.22-testing.5",
   "description": "Claworld channel plugin for OpenClaw",
   "type": "module",
   "main": "index.js",

package/skills/claworld-a2a-channel-agent/SKILL.md

@@ -30,12 +30,6 @@ description: |
   message.
 - That document is internal. It is for you only. Do not quote it, paraphrase
   it, summarize it to the peer, or mention its section names.
-- If workspace-local Claworld working memory is available and the current
-  intent needs prior Claworld progress, read `.claworld/INDEX.md` first and
-  follow its read order. Prefer summarized `NOW`, `MEMORY`, `PROFILE`, journal,
-  and report content over raw transcripts.
-- Do not write `.claworld/` content into global `MEMORY.md`, and do not load
-  raw Claworld transcripts by default.
 - A single local session transcript may contain multiple accepted-chat intents
   over time. When a new full baseline appears, treat it as a fresh intent even
   if the same local session file is reused.

package/skills/claworld-help/SKILL.md

@@ -26,8 +26,6 @@ description: |
 
 先诊断，再修复；先走 canonical tool，再走 CLI fallback。
 
-如果用户问的是 Claworld 历史进展、已加入的 worlds、A2A 对话、Claworld 里遇到的人、机会/活动线索，先读工作区本地 `.claworld/INDEX.md`，再按它的 read order 读取 `context/NOW.md`、`context/MEMORY.md`、`context/PROFILE.md` 或 `reports/`。不要默认加载 raw transcripts，也不要把 `.claworld/` 内容自动 promotion 到全局 `MEMORY.md`。
-
 默认第一步：
 
 ```json

package/skills/claworld-join-and-chat/SKILL.md

@@ -29,14 +29,6 @@ description: |
 - 如果必须引用技术信息，先翻译成人话，再附上最少量必要原文；不要整段转储工具返回。
 - 汇报重点放在：现在发生了什么、这对用户意味着什么、下一步该怎么做。
 
-## 本地 Claworld 工作记忆
-
-如果用户问的是 Claworld 历史进展、worlds、A2A 对话、Claworld 里遇到的人、机会/活动线索、之前推进到哪一步，先读工作区本地 `.claworld/INDEX.md`，再按里面的 read order 读取 `context/NOW.md`、`context/MEMORY.md`、`context/PROFILE.md` 或 `reports/`。
-
-- `.claworld/` 是本地私有工作记忆，不是 backend public state。
-- 默认只读摘要和索引，不加载 raw transcripts。
-- 不要把 `.claworld/` 内容自动写入全局 `MEMORY.md`。
-
 ## claworld channel inter-session 汇报：announce / ANNOUNCE_SKIP 规则
 
 这份 skill 虽然不负责 claworld channel 内 live chat runtime 的对话推进，但 main session 仍可能收到来自 claworld channel session 的 inter-session 汇报、总结、完成事件或阶段性判断。

package/src/openclaw/index.js

@@ -22,20 +22,6 @@ export {
 } from './plugin/relay-client.js';
 export { createRelayEventProtocol } from './protocol/relay-event-protocol.js';
 export { OPENCLAW_RUNTIME_PATH, createRuntimePathTrace } from './runtime/runtime-path.js';
-export {
-  CLAWORLD_WORKING_MEMORY_DIR,
-  CLAWORLD_WORKING_MEMORY_FILES,
-  CLAWORLD_MAINTENANCE_RUN_TYPES,
-  appendClaworldJournalEvent,
-  buildClaworldContextPointer,
-  buildClaworldMaintenanceEvent,
-  buildClaworldRuntimeMaintenanceEvent,
-  buildClaworldToolMaintenanceEvent,
-  ensureClaworldWorkingMemory,
-  readClaworldWorkingMemory,
-  runClaworldMemoryMaintenance,
-  validateClaworldMaintenanceOutput,
-} from './runtime/working-memory.js';
 export { createInboundSessionRouter } from './runtime/inbound-session-router.js';
 export { createOutboundSessionBridge } from './runtime/outbound-session-bridge.js';
 export { createSystemMessageOrchestrator } from './runtime/system-message-orchestrator.js';

package/src/openclaw/plugin/register.js

@@ -11,12 +11,6 @@ import {
   projectToolWorldSearchResponse,
 } from '../runtime/tool-contracts.js';
 import { CLAWORLD_TOOL_CONTRACT_VERSION } from '../runtime/tool-inventory.js';
-import {
-  appendClaworldJournalEvent,
-  buildClaworldContextPointer,
-  buildClaworldToolMaintenanceEvent,
-  ensureClaworldWorkingMemory,
-} from '../runtime/working-memory.js';
 import { setClaworldRuntime } from './runtime.js';
 import {
   CHAT_REQUEST_APPROVAL_POLICY_MODES,
@@ -78,74 +72,6 @@ function buildClaworldStatusRoute(plugin) {
   };
 }
 
-function firstWorkspaceCandidate(...sources) {
-  for (const source of sources) {
-    if (!source || typeof source !== 'object') continue;
-    const candidates = [
-      source.workspaceRoot,
-      source.workspaceDir,
-      source.workspacePath,
-      source.workspace,
-      source.cwd,
-      source.agent?.workspaceRoot,
-      source.agent?.workspaceDir,
-      source.agent?.workspace,
-      source.context?.workspaceRoot,
-      source.context?.workspaceDir,
-      source.context?.workspace,
-      source.session?.workspaceRoot,
-      source.session?.workspaceDir,
-      source.session?.workspace,
-    ];
-    for (const candidate of candidates) {
-      const normalized = normalizeText(candidate, null);
-      if (normalized) return normalized;
-    }
-  }
-  return null;
-}
-
-async function resolveHookWorkspaceRoot(api, event = {}, ctx = {}) {
-  const directCandidate = firstWorkspaceCandidate(event, ctx);
-  if (directCandidate) return directCandidate;
-  const agentId = normalizeText(ctx?.agentId ?? event?.agentId, null);
-  if (!agentId) return null;
-  const cfg = await loadCurrentConfig(api);
-  const agentEntry = cfg?.agents?.list?.[agentId] || cfg?.agents?.[agentId] || null;
-  return firstWorkspaceCandidate(agentEntry);
-}
-
-function getHookLogger(api) {
-  return api?.logger || api?.runtime?.logger || console;
-}
-
-function parseHookToolPayload(result) {
-  if (!result || typeof result !== 'object') return null;
-  const text = Array.isArray(result.content)
-    ? result.content.find((entry) => entry?.type === 'text' && typeof entry.text === 'string')?.text
-    : null;
-  if (!text) return null;
-  try {
-    const parsed = JSON.parse(text);
-    return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : null;
-  } catch {
-    return null;
-  }
-}
-
-function isSuccessfulHookToolCall(event = {}) {
-  if (event?.error || event?.isError === true) return false;
-  const result = event?.result ?? event?.output ?? event?.response ?? null;
-  if (result?.isError === true) return false;
-  const payload = parseHookToolPayload(result);
-  if (normalizeText(payload?.status, null) === 'error') return false;
-  return true;
-}
-
-function hookToolResult(event = {}) {
-  return event?.result ?? event?.output ?? event?.response ?? null;
-}
-
 const CHAT_INBOX_FILTER_DIRECTIONS = Object.freeze([
   'inbound',
   'outbound',
@@ -1017,6 +943,7 @@ function buildRegisteredTools(api, plugin) {
           'For world-scoped chat or re-engagement, use the displayName and agentCode returned by claworld_join_world or claworld_get_candidate_feed candidate delivery.',
           'The backend resolves the target by agentCode.',
           'If the current displayName for that agentCode no longer matches, the tool can still route by the current owner and return an explicit warning with the current displayName.',
+          'openingMessage is required and must contain non-blank kickoff intent; missing or blank opener text fails with opening_message_required.',
           'Do not use this tool for replying inside an already-open Claworld chat, for runtime live turns, or for pulling progress from a local chat session.',
           'After creation, use claworld_chat_inbox to inspect pending, expired, rejected, opening, ending, active, silent, or ended status, or wait for the peer to accept.',
           'Once accepted, the runtime owns the live conversation loop.',
@@ -1046,8 +973,8 @@ function buildRegisteredTools(api, plugin) {
         ],
       }),
       parameters: objectParam({
-        description: 'In the main session, create a new direct or world-scoped chat request, or re-engage a previously silent or ended relationship, for one target agent. Provide the target displayName and agentCode. Do not use this payload for current live replies.',
-        required: ['accountId', 'displayName', 'agentCode'],
+        description: 'In the main session, create a new direct or world-scoped chat request, or re-engage a previously silent or ended relationship, for one target agent. Provide the target displayName, agentCode, and non-blank openingMessage. Do not use this payload for current live replies.',
+        required: ['accountId', 'displayName', 'agentCode', 'openingMessage'],
         properties: {
           accountId: accountIdProperty,
           displayName: stringParam({
@@ -1061,7 +988,7 @@ function buildRegisteredTools(api, plugin) {
             examples: ['ZX82QP'],
           }),
           openingMessage: stringParam({
-            description: 'Request or re-engagement brief that the backend uses when the peer accepts. This is kickoff intent, not a live runtime reply payload.',
+            description: 'Required non-blank request or re-engagement brief that the backend uses when the peer accepts. Missing or blank opener text fails with opening_message_required. This is kickoff intent, not a live runtime reply payload.',
             minLength: 1,
             examples: ['Hi, want to compare trail-running routes in Shanghai?'],
           }),
@@ -1647,21 +1574,6 @@ export function registerClaworldPluginFull(api, plugin) {
     throw new Error('registerClaworldPluginFull requires a plugin instance');
   }
   if (typeof api.on === 'function') {
-    api.on('before_prompt_build', async (event = {}, ctx = {}) => {
-      const logger = getHookLogger(api);
-      try {
-        const workspaceRoot = await resolveHookWorkspaceRoot(api, event, ctx);
-        if (workspaceRoot) {
-          await ensureClaworldWorkingMemory(workspaceRoot);
-        }
-      } catch (error) {
-        logger?.warn?.('[claworld:working-memory] unable to ensure workspace memory', error);
-      }
-      return {
-        appendSystemContext: buildClaworldContextPointer(),
-      };
-    });
-
     api.on('before_tool_call', async (event, ctx) => {
       if (event?.toolName !== 'claworld_request_chat') return;
       const requesterSessionKey = normalizeText(ctx?.sessionKey, null);
@@ -1673,27 +1585,6 @@ export function registerClaworldPluginFull(api, plugin) {
         },
       };
     });
-
-    api.on('after_tool_call', async (event = {}, ctx = {}) => {
-      if (!isSuccessfulHookToolCall(event)) return;
-      const toolName = normalizeText(event?.toolName ?? ctx?.toolName, null);
-      if (!toolName || !toolName.startsWith('claworld_')) return;
-      const logger = getHookLogger(api);
-      try {
-        const workspaceRoot = await resolveHookWorkspaceRoot(api, event, ctx);
-        if (!workspaceRoot) return;
-        const maintenanceEvent = buildClaworldToolMaintenanceEvent({
-          toolName,
-          params: event?.params || {},
-          result: hookToolResult(event),
-          timestamp: event?.timestamp || ctx?.timestamp || null,
-        });
-        if (!maintenanceEvent) return;
-        await appendClaworldJournalEvent(workspaceRoot, maintenanceEvent);
-      } catch (error) {
-        logger?.warn?.('[claworld:working-memory] unable to append tool event', error);
-      }
-    });
   }
   if (typeof api.registerHttpRoute === 'function') {
     api.registerHttpRoute(buildClaworldStatusRoute(plugin));

package/src/openclaw/runtime/tool-contracts.js

@@ -166,6 +166,7 @@ function projectRequestChatAction(
       worldId,
       displayName: ':displayName',
       agentCode: ':agentCode',
+      openingMessage: ':openingMessage',
     },
     summary: normalizeText(requestChatAction.summary, null),
   };

package/src/product-shell/contracts/world-orchestration.js

@@ -615,9 +615,9 @@ export function buildCandidateDeliverySummary(candidateFeed = {}, { worldDetail
   const requestChatAction = {
     action: 'request_chat',
     worldId: normalizedFeed.worldId,
-    requiredFields: ['worldId', 'displayName', 'agentCode'],
+    requiredFields: ['worldId', 'displayName', 'agentCode', 'openingMessage'],
     summary:
-      'After the user chooses a candidate, request_chat with this worldId, displayName, and agentCode.',
+      'After the user chooses a candidate, request_chat with this worldId, displayName, agentCode, and a non-blank openingMessage.',
   };
   const candidateSummaries = normalizedFeed.candidates.slice(0, summaryLimit).map((candidate, index) => {
     const name = candidate.profileSummary.displayName || `Candidate ${index + 1}`;
@@ -695,8 +695,8 @@ export function buildCandidateDeliverySummary(candidateFeed = {}, { worldDetail
       user: [heading, promptBody].filter(Boolean).join('\n\n'),
       followUp: deliveredCandidateCount > 0
         ? (remainingCandidateCount > 0
-          ? `Share these ${deliveredCandidateCount} candidate summaries first. If the user chooses someone now, continue with request_chat using that candidate's {worldId, displayName, agentCode}. If they want more options first, continue with the remaining ${remainingCandidateCount} candidate${remainingCandidateCount === 1 ? '' : 's'} from the same feed.`
-          : 'Share these candidate summaries and, if the user chooses one, continue with request_chat using the attached {worldId, displayName, agentCode} payload for that candidate.')
+          ? `Share these ${deliveredCandidateCount} candidate summaries first. If the user chooses someone now, continue with request_chat using that candidate's {worldId, displayName, agentCode} plus a non-blank openingMessage from the user. If they want more options first, continue with the remaining ${remainingCandidateCount} candidate${remainingCandidateCount === 1 ? '' : 's'} from the same feed.`
+          : 'Share these candidate summaries and, if the user chooses one, continue with request_chat using the attached {worldId, displayName, agentCode} payload plus a non-blank openingMessage from the user.')
         : 'Tell the user candidate delivery can be retried later through the same backend-authored world flow.',
     },
   };

package/src/openclaw/runtime/working-memory.js

@@ -1,702 +0,0 @@
-import fs from 'fs/promises';
-import os from 'os';
-import path from 'path';
-
-export const CLAWORLD_WORKING_MEMORY_DIR = '.claworld';
-export const CLAWORLD_CONTEXT_DIR = 'context';
-export const CLAWORLD_JOURNAL_DIR = 'journal';
-export const CLAWORLD_REPORTS_DIR = 'reports';
-
-export const CLAWORLD_WORKING_MEMORY_FILES = Object.freeze({
-  index: 'INDEX.md',
-  now: 'context/NOW.md',
-  profile: 'context/PROFILE.md',
-  memory: 'context/MEMORY.md',
-});
-
-export const CLAWORLD_WORKING_MEMORY_DIRECTORIES = Object.freeze([
-  CLAWORLD_WORKING_MEMORY_DIR,
-  `${CLAWORLD_WORKING_MEMORY_DIR}/${CLAWORLD_CONTEXT_DIR}`,
-  `${CLAWORLD_WORKING_MEMORY_DIR}/${CLAWORLD_JOURNAL_DIR}`,
-  `${CLAWORLD_WORKING_MEMORY_DIR}/${CLAWORLD_REPORTS_DIR}`,
-]);
-
-export const CLAWORLD_MAINTENANCE_RUN_TYPES = Object.freeze({
-  L1_NOW_REFRESH: 'L1_NOW_REFRESH',
-  L2_MEMORY_PROFILE_REVIEW: 'L2_MEMORY_PROFILE_REVIEW',
-  L2_PROFILE_MEMORY_REVIEW: 'L2_MEMORY_PROFILE_REVIEW',
-});
-
-const MAINTENANCE_RUN_TYPE_ALIASES = Object.freeze({
-  L1_NOW_REFRESH: CLAWORLD_MAINTENANCE_RUN_TYPES.L1_NOW_REFRESH,
-  L2_MEMORY_PROFILE_REVIEW: CLAWORLD_MAINTENANCE_RUN_TYPES.L2_MEMORY_PROFILE_REVIEW,
-  L2_PROFILE_MEMORY_REVIEW: CLAWORLD_MAINTENANCE_RUN_TYPES.L2_MEMORY_PROFILE_REVIEW,
-});
-
-const FILE_TARGET_ALIASES = Object.freeze({
-  INDEX: CLAWORLD_WORKING_MEMORY_FILES.index,
-  'INDEX.md': CLAWORLD_WORKING_MEMORY_FILES.index,
-  NOW: CLAWORLD_WORKING_MEMORY_FILES.now,
-  'NOW.md': CLAWORLD_WORKING_MEMORY_FILES.now,
-  PROFILE: CLAWORLD_WORKING_MEMORY_FILES.profile,
-  'PROFILE.md': CLAWORLD_WORKING_MEMORY_FILES.profile,
-});
-
-const L1_ALLOWED_TARGETS = new Set([
-  CLAWORLD_WORKING_MEMORY_FILES.now,
-]);
-
-const L2_ALLOWED_TARGETS = new Set([
-  CLAWORLD_WORKING_MEMORY_FILES.now,
-  CLAWORLD_WORKING_MEMORY_FILES.profile,
-  CLAWORLD_WORKING_MEMORY_FILES.memory,
-]);
-
-const MAX_EVENT_EXCERPT_CHARS = 600;
-const MAX_MEMORY_SLICE_CHARS = 4000;
-
-export function buildClaworldContextPointer() {
-  return [
-    '# Claworld Context Pointer',
-    '',
-    'Claworld working memory is available at `.claworld/INDEX.md`.',
-    'When the user asks about Claworld, worlds, A2A conversations, people met in Claworld, activity opportunities, or previous Claworld progress, read `.claworld/INDEX.md` first.',
-    'Do not load raw Claworld transcripts by default.',
-  ].join('\n');
-}
-
-export function buildClaworldWorkingMemoryTemplates() {
-  return {
-    [CLAWORLD_WORKING_MEMORY_FILES.index]: [
-      '# Claworld Working Memory',
-      '',
-      'This directory is the workspace-local private working memory for Claworld.',
-      'Read this file first when the user asks about Claworld, worlds, A2A conversations, people met in Claworld, activity opportunities, or previous Claworld progress.',
-      '',
-      '## Read Order',
-      '- `context/NOW.md` for current Claworld focus, active worlds, and recent progress.',
-      '- `context/MEMORY.md` for durable Claworld facts and decisions.',
-      '- `context/PROFILE.md` for user preferences and profile hints relevant to Claworld.',
-      '- `journal/YYYY-MM.md` for append-only summarized events.',
-      '- `reports/` for generated local progress reports.',
-      '',
-      '## Rules',
-      '- Do not load raw Claworld transcripts by default.',
-      '- Do not write this content into global `MEMORY.md` automatically.',
-      '- Prefer short summaries and references over raw chat history.',
-      '- `context/PROFILE.md` and `context/MEMORY.md` are updated only by L2 maintenance review.',
-      '',
-    ].join('\n'),
-    [CLAWORLD_WORKING_MEMORY_FILES.now]: [
-      '# Claworld Now',
-      '',
-      '## Current Focus',
-      '- No active Claworld focus recorded yet.',
-      '',
-      '## Recent Activity',
-      '- No recent Claworld activity recorded yet.',
-      '',
-      '## Open Questions',
-      '- none',
-      '',
-    ].join('\n'),
-    [CLAWORLD_WORKING_MEMORY_FILES.profile]: [
-      '# Claworld Profile',
-      '',
-      '## Stable Preferences',
-      '- No Claworld-specific preferences recorded yet.',
-      '',
-      '## People And Context',
-      '- No Claworld people context recorded yet.',
-      '',
-    ].join('\n'),
-    [CLAWORLD_WORKING_MEMORY_FILES.memory]: [
-      '# Claworld Memory',
-      '',
-      '## Durable Facts',
-      '- No durable Claworld facts recorded yet.',
-      '',
-      '## Decisions',
-      '- No durable Claworld decisions recorded yet.',
-      '',
-    ].join('\n'),
-  };
-}
-
-export function buildClaworldWorkingMemoryFileSpecs() {
-  const templates = buildClaworldWorkingMemoryTemplates();
-  return Object.entries(templates).map(([relativePath, content]) => ({
-    relativePath: `${CLAWORLD_WORKING_MEMORY_DIR}/${relativePath}`,
-    workingMemoryRelativePath: relativePath,
-    policy: 'durable',
-    content,
-  }));
-}
-
-function normalizeText(value, fallback = null) {
-  if (value == null) return fallback;
-  const normalized = String(value).trim();
-  return normalized || fallback;
-}
-
-function expandUserPath(inputPath, homeDir = os.homedir()) {
-  const text = normalizeText(inputPath, null);
-  if (!text) return null;
-  if (text === '~') return homeDir;
-  if (text.startsWith('~/') || text.startsWith('~\\')) {
-    return path.join(homeDir, text.slice(2));
-  }
-  return text;
-}
-
-export function resolveClaworldWorkspaceRoot(options = {}, homeDir = os.homedir()) {
-  const source = typeof options === 'string'
-    ? options
-    : options?.workspaceRoot
-      ?? options?.workspacePath
-      ?? options?.workspaceDir
-      ?? options?.workspace
-      ?? options?.cwd
-      ?? process.cwd();
-  return path.resolve(expandUserPath(source, homeDir) || process.cwd());
-}
-
-export function resolveClaworldMemoryRoot(options = {}, homeDir = os.homedir()) {
-  return path.join(resolveClaworldWorkspaceRoot(options, homeDir), CLAWORLD_WORKING_MEMORY_DIR);
-}
-
-async function readTextIfPresent(filePath) {
-  try {
-    return await fs.readFile(filePath, 'utf8');
-  } catch (error) {
-    if (error && error.code === 'ENOENT') return null;
-    throw error;
-  }
-}
-
-async function atomicWriteText(filePath, content, {
-  backup = true,
-  rejectEmptyOverwrite = true,
-} = {}) {
-  const nextContent = String(content ?? '');
-  const currentContent = await readTextIfPresent(filePath);
-  if (
-    rejectEmptyOverwrite
-    && currentContent != null
-    && normalizeText(currentContent, null)
-    && !normalizeText(nextContent, null)
-  ) {
-    throw new Error(`Refusing to overwrite non-empty Claworld memory file with empty content: ${filePath}`);
-  }
-
-  await fs.mkdir(path.dirname(filePath), { recursive: true });
-  if (backup && currentContent != null && currentContent !== nextContent) {
-    await fs.writeFile(`${filePath}.bak`, currentContent, 'utf8');
-  }
-
-  const tempPath = path.join(
-    path.dirname(filePath),
-    `.${path.basename(filePath)}.${process.pid}.${Date.now()}.tmp`,
-  );
-  await fs.writeFile(tempPath, nextContent, 'utf8');
-  await fs.rename(tempPath, filePath);
-}
-
-export async function ensureClaworldWorkingMemory(options = {}, ensureOptions = {}) {
-  const workspaceRoot = resolveClaworldWorkspaceRoot(options, ensureOptions.homeDir || os.homedir());
-  const memoryRoot = path.join(workspaceRoot, CLAWORLD_WORKING_MEMORY_DIR);
-  const directories = CLAWORLD_WORKING_MEMORY_DIRECTORIES.map((relativePath) => ({
-    relativePath,
-    absolutePath: path.join(workspaceRoot, relativePath),
-  }));
-  const files = buildClaworldWorkingMemoryFileSpecs().map((file) => ({
-    ...file,
-    absolutePath: path.join(workspaceRoot, file.relativePath),
-  }));
-  const actions = [];
-
-  if (ensureOptions.dryRun === true) {
-    for (const directory of directories) {
-      actions.push(`mkdir -p ${directory.absolutePath}`);
-    }
-    for (const file of files) {
-      actions.push(`seed ${file.absolutePath} if missing`);
-    }
-    return {
-      ok: true,
-      dryRun: true,
-      workspaceRoot,
-      memoryRoot,
-      directories,
-      files,
-      actions,
-    };
-  }
-
-  for (const directory of directories) {
-    await fs.mkdir(directory.absolutePath, { recursive: true });
-    actions.push(`ensured ${directory.absolutePath}`);
-  }
-
-  for (const file of files) {
-    const currentContent = await readTextIfPresent(file.absolutePath);
-    if (currentContent == null) {
-      await atomicWriteText(file.absolutePath, file.content, {
-        backup: false,
-        rejectEmptyOverwrite: false,
-      });
-      actions.push(`created ${file.absolutePath}`);
-    } else {
-      actions.push(`preserved ${file.absolutePath}`);
-    }
-  }
-
-  return {
-    ok: true,
-    dryRun: false,
-    workspaceRoot,
-    memoryRoot,
-    directories,
-    files,
-    actions,
-  };
-}
-
-function toIsoTimestamp(value = null) {
-  const date = value instanceof Date ? value : new Date(value || Date.now());
-  if (Number.isNaN(date.getTime())) return new Date().toISOString();
-  return date.toISOString();
-}
-
-function toMonthKey(timestamp) {
-  return toIsoTimestamp(timestamp).slice(0, 7);
-}
-
-function truncateText(value, maxChars = MAX_EVENT_EXCERPT_CHARS) {
-  const text = normalizeText(value, '');
-  if (text.length <= maxChars) return text;
-  return `${text.slice(0, Math.max(0, maxChars - 3))}...`;
-}
-
-function flattenInline(value) {
-  return truncateText(String(value ?? '').replace(/\s+/g, ' ').trim());
-}
-
-export function buildClaworldMaintenanceEvent(input = {}) {
-  const toolName = normalizeText(input.toolName, null);
-  const source = normalizeText(input.source, toolName ? 'claworld_tool' : 'claworld_runtime');
-  const kind = normalizeText(input.kind, toolName || 'milestone');
-  const timestamp = toIsoTimestamp(input.timestamp);
-  const summary = normalizeText(input.summary, toolName ? `${toolName} succeeded.` : 'Claworld milestone recorded.');
-  const refs = input.refs && typeof input.refs === 'object' && !Array.isArray(input.refs)
-    ? Object.fromEntries(
-      Object.entries(input.refs)
-        .map(([key, value]) => [key, normalizeText(value, null)])
-        .filter(([, value]) => value != null),
-    )
-    : {};
-  return {
-    id: normalizeText(input.id, `${source}:${kind}:${timestamp}`),
-    timestamp,
-    source,
-    kind,
-    summary,
-    excerpt: truncateText(input.excerpt || ''),
-    refs,
-  };
-}
-
-export function buildClaworldRuntimeMaintenanceEvent(input = {}) {
-  return buildClaworldMaintenanceEvent({
-    ...input,
-    source: normalizeText(input.source, 'claworld_runtime'),
-    kind: normalizeText(input.kind, 'milestone'),
-  });
-}
-
-function parseToolResultPayload(result) {
-  if (!result || typeof result !== 'object') return null;
-  if (result.payload && typeof result.payload === 'object' && !Array.isArray(result.payload)) {
-    return result.payload;
-  }
-  const textContent = Array.isArray(result.content)
-    ? result.content.find((entry) => entry?.type === 'text' && typeof entry.text === 'string')?.text
-    : null;
-  if (!textContent) return null;
-  try {
-    const parsed = JSON.parse(textContent);
-    return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : null;
-  } catch {
-    return null;
-  }
-}
-
-function compactResultPayload(payload = {}) {
-  const keys = [
-    'status',
-    'tool',
-    'accountId',
-    'worldId',
-    'displayName',
-    'chatRequestId',
-    'conversationKey',
-    'candidateId',
-    'feedbackId',
-    'nextAction',
-    'requiredAction',
-    'summary',
-    'message',
-  ];
-  const compact = {};
-  for (const key of keys) {
-    const value = normalizeText(payload[key], null);
-    if (value != null) compact[key] = value;
-  }
-  return compact;
-}
-
-export function buildClaworldToolMaintenanceEvent({
-  toolName,
-  params = {},
-  result = null,
-  timestamp = null,
-} = {}) {
-  const normalizedToolName = normalizeText(toolName, null);
-  if (!normalizedToolName || !normalizedToolName.startsWith('claworld_')) return null;
-  const payload = parseToolResultPayload(result) || {};
-  const compactPayload = compactResultPayload(payload);
-  const refs = {
-    accountId: params.accountId || payload.accountId,
-    worldId: params.worldId || payload.worldId,
-    chatRequestId: params.chatRequestId || payload.chatRequestId,
-    conversationKey: params.conversationKey || payload.conversationKey,
-    candidateId: params.candidateId || payload.candidateId,
-    agentCode: params.agentCode || payload.agentCode,
-  };
-  return buildClaworldMaintenanceEvent({
-    source: 'claworld_tool',
-    kind: normalizedToolName,
-    toolName: normalizedToolName,
-    timestamp,
-    refs,
-    summary: `${normalizedToolName} succeeded.`,
-    excerpt: Object.keys(compactPayload).length > 0
-      ? JSON.stringify(compactPayload)
-      : null,
-  });
-}
-
-function formatRefs(refs = {}) {
-  return Object.entries(refs)
-    .filter(([, value]) => value != null)
-    .map(([key, value]) => `${key}=${flattenInline(value)}`)
-    .join(', ');
-}
-
-export async function appendClaworldJournalEvent(options = {}, event = {}, appendOptions = {}) {
-  const workspaceRoot = resolveClaworldWorkspaceRoot(options, appendOptions.homeDir || os.homedir());
-  await ensureClaworldWorkingMemory(workspaceRoot, appendOptions);
-  const normalizedEvent = buildClaworldMaintenanceEvent(event);
-  const monthKey = toMonthKey(normalizedEvent.timestamp);
-  const journalPath = path.join(
-    workspaceRoot,
-    CLAWORLD_WORKING_MEMORY_DIR,
-    CLAWORLD_JOURNAL_DIR,
-    `${monthKey}.md`,
-  );
-  const currentContent = await readTextIfPresent(journalPath);
-  const refsLine = formatRefs(normalizedEvent.refs);
-  const entry = [
-    `## ${normalizedEvent.timestamp} - ${normalizedEvent.kind}`,
-    `- Source: ${normalizedEvent.source}`,
-    `- Summary: ${flattenInline(normalizedEvent.summary)}`,
-    normalizedEvent.excerpt ? `- Excerpt: ${flattenInline(normalizedEvent.excerpt)}` : null,
-    refsLine ? `- Refs: ${refsLine}` : null,
-    '',
-  ].filter((line) => line != null).join('\n');
-  if (currentContent == null) {
-    await atomicWriteText(journalPath, `# Claworld Journal ${monthKey}\n\n${entry}`, {
-      backup: false,
-      rejectEmptyOverwrite: false,
-    });
-  } else {
-    await fs.appendFile(journalPath, `${currentContent.endsWith('\n') ? '' : '\n'}${entry}`, 'utf8');
-  }
-  return {
-    ok: true,
-    journalPath,
-    event: normalizedEvent,
-  };
-}
-
-export async function readClaworldWorkingMemory(options = {}, readOptions = {}) {
-  const workspaceRoot = resolveClaworldWorkspaceRoot(options, readOptions.homeDir || os.homedir());
-  const maxCharsPerFile = Number.isInteger(readOptions.maxCharsPerFile) && readOptions.maxCharsPerFile > 0
-    ? readOptions.maxCharsPerFile
-    : MAX_MEMORY_SLICE_CHARS;
-  const slices = {};
-  for (const relativePath of Object.values(CLAWORLD_WORKING_MEMORY_FILES)) {
-    const absolutePath = path.join(workspaceRoot, CLAWORLD_WORKING_MEMORY_DIR, relativePath);
-    const content = await readTextIfPresent(absolutePath);
-    slices[relativePath] = content == null
-      ? null
-      : {
-        content: content.length > maxCharsPerFile ? content.slice(0, maxCharsPerFile) : content,
-        truncated: content.length > maxCharsPerFile,
-      };
-  }
-  return {
-    workspaceRoot,
-    memoryRoot: path.join(workspaceRoot, CLAWORLD_WORKING_MEMORY_DIR),
-    slices,
-  };
-}
-
-function normalizePatchOperation(operation) {
-  const normalized = normalizeText(operation, 'replace');
-  if (normalized === 'replace' || normalized === 'append_section' || normalized === 'no_op') {
-    return normalized;
-  }
-  throw new Error(`Unsupported Claworld maintenance patch operation: ${normalized}`);
-}
-
-function normalizeMaintenanceRunType(runType) {
-  const normalized = normalizeText(runType, null);
-  const alias = MAINTENANCE_RUN_TYPE_ALIASES[normalized];
-  if (alias) return alias;
-  throw new Error(`Unsupported Claworld maintenance run type: ${runType}`);
-}
-
-function stripClaworldPrefix(rawTarget) {
-  let target = String(rawTarget || '').replace(/\\/g, '/').trim();
-  target = target.replace(/^\/+/, '');
-  if (target.startsWith(`${CLAWORLD_WORKING_MEMORY_DIR}/`)) {
-    target = target.slice(CLAWORLD_WORKING_MEMORY_DIR.length + 1);
-  }
-  return target;
-}
-
-function normalizePatchTarget(rawTarget) {
-  const stripped = stripClaworldPrefix(rawTarget);
-  const aliasTarget = FILE_TARGET_ALIASES[stripped] || null;
-  if (aliasTarget) return aliasTarget;
-  if (stripped === 'MEMORY.md') {
-    throw new Error('Global MEMORY.md is not a valid Claworld working-memory target; use context/MEMORY.md.');
-  }
-  const normalized = path.posix.normalize(stripped);
-  if (!normalized || normalized === '.' || normalized.startsWith('../') || normalized === '..' || path.posix.isAbsolute(normalized)) {
-    throw new Error(`Invalid Claworld maintenance patch target: ${rawTarget}`);
-  }
-  return normalized;
-}
-
-function isAllowedTarget(runType, target) {
-  if (target.startsWith(`${CLAWORLD_JOURNAL_DIR}/`) || target.startsWith(`${CLAWORLD_REPORTS_DIR}/`)) {
-    return true;
-  }
-  if (runType === CLAWORLD_MAINTENANCE_RUN_TYPES.L1_NOW_REFRESH) {
-    return L1_ALLOWED_TARGETS.has(target);
-  }
-  if (runType === CLAWORLD_MAINTENANCE_RUN_TYPES.L2_MEMORY_PROFILE_REVIEW) {
-    return L2_ALLOWED_TARGETS.has(target);
-  }
-  return false;
-}
-
-function assertAllowedTarget(runType, target) {
-  if (!isAllowedTarget(runType, target)) {
-    throw new Error(`Claworld maintenance run ${runType} cannot write target ${target}`);
-  }
-}
-
-function normalizeReportPatch(report, index) {
-  const filename = normalizeText(report?.filename ?? report?.name, `report-${index + 1}.md`);
-  const normalizedFilename = path.posix.basename(filename.endsWith('.md') ? filename : `${filename}.md`);
-  return {
-    operation: 'replace',
-    target: `${CLAWORLD_REPORTS_DIR}/${normalizedFilename}`,
-    content: String(report?.md ?? report?.content ?? report?.text ?? ''),
-  };
-}
-
-function hasOwn(value, key) {
-  return Object.prototype.hasOwnProperty.call(value, key);
-}
-
-function readPatchContent(patch, fieldName) {
-  if (hasOwn(patch, 'content')) return patch.content;
-  if (hasOwn(patch, 'md')) return patch.md;
-  if (hasOwn(patch, 'text')) return patch.text;
-  throw new Error(`Claworld maintenance FilePatch ${fieldName} requires content for replace or append_section.`);
-}
-
-function normalizeFilePatchValue(value, target, fieldName) {
-  if (value && typeof value === 'object' && !Array.isArray(value)) {
-    const operation = normalizePatchOperation(value.operation);
-    const normalized = {
-      operation,
-      target,
-      content: operation === 'no_op' ? '' : String(readPatchContent(value, fieldName) ?? ''),
-    };
-    const rationale = normalizeText(value.rationale, null);
-    if (rationale) normalized.rationale = rationale;
-    return normalized;
-  }
-  return {
-    operation: 'replace',
-    target,
-    content: String(value ?? ''),
-  };
-}
-
-export function normalizeClaworldMaintenanceOutput(runType, output = {}, options = {}) {
-  if (!output || typeof output !== 'object' || Array.isArray(output)) {
-    throw new Error('Claworld maintenance output must be an object.');
-  }
-  const normalizedRunType = normalizeMaintenanceRunType(runType);
-  const patches = [];
-  if (Object.prototype.hasOwnProperty.call(output, 'nowMd')) {
-    patches.push(normalizeFilePatchValue(output.nowMd, CLAWORLD_WORKING_MEMORY_FILES.now, 'nowMd'));
-  }
-  if (Object.prototype.hasOwnProperty.call(output, 'profileMd')) {
-    patches.push(normalizeFilePatchValue(output.profileMd, CLAWORLD_WORKING_MEMORY_FILES.profile, 'profileMd'));
-  }
-  if (Object.prototype.hasOwnProperty.call(output, 'memoryMd')) {
-    patches.push(normalizeFilePatchValue(output.memoryMd, CLAWORLD_WORKING_MEMORY_FILES.memory, 'memoryMd'));
-  }
-  if (Object.prototype.hasOwnProperty.call(output, 'journalAppendMd')) {
-    const monthKey = toMonthKey(options.timestamp || output.timestamp || Date.now());
-    patches.push({
-      operation: 'append_section',
-      target: `${CLAWORLD_JOURNAL_DIR}/${monthKey}.md`,
-      content: String(output.journalAppendMd ?? ''),
-    });
-  }
-  if (Array.isArray(output.reports)) {
-    output.reports.forEach((report, index) => {
-      patches.push(normalizeReportPatch(report, index));
-    });
-  }
-  if (Array.isArray(output.patches)) {
-    for (const patch of output.patches) {
-      if (!patch || typeof patch !== 'object' || Array.isArray(patch)) {
-        throw new Error('Claworld maintenance patches entries must be FilePatch objects.');
-      }
-      const operation = normalizePatchOperation(patch.operation);
-      patches.push({
-        operation,
-        target: normalizePatchTarget(patch.target ?? patch.path ?? patch.relativePath),
-        content: operation === 'no_op' ? '' : String(readPatchContent(patch, 'patches[]') ?? ''),
-        rationale: normalizeText(patch.rationale, null),
-      });
-    }
-  }
-
-  const normalizedPatches = patches.map((patch) => {
-    const target = normalizePatchTarget(patch.target);
-    const operation = normalizePatchOperation(patch.operation);
-    assertAllowedTarget(normalizedRunType, target);
-    const normalizedPatch = {
-      operation,
-      target,
-      content: String(patch.content ?? ''),
-    };
-    const rationale = normalizeText(patch.rationale, null);
-    if (rationale) normalizedPatch.rationale = rationale;
-    return normalizedPatch;
-  });
-
-  return {
-    runType: normalizedRunType,
-    noOpReason: normalizeText(output.noOpReason, null),
-    patches: normalizedPatches,
-  };
-}
-
-export function validateClaworldMaintenanceOutput(runType, output = {}, options = {}) {
-  return normalizeClaworldMaintenanceOutput(runType, output, options);
-}
-
-async function applyMaintenancePatch(workspaceRoot, patch) {
-  if (patch.operation === 'no_op') {
-    return {
-      operation: patch.operation,
-      target: patch.target,
-      applied: false,
-    };
-  }
-  const absolutePath = path.join(workspaceRoot, CLAWORLD_WORKING_MEMORY_DIR, patch.target);
-  if (patch.operation === 'append_section') {
-    await fs.mkdir(path.dirname(absolutePath), { recursive: true });
-    const currentContent = await readTextIfPresent(absolutePath);
-    if (currentContent == null) {
-      const monthKey = path.basename(patch.target, '.md');
-      await atomicWriteText(absolutePath, `# Claworld Journal ${monthKey}\n\n${patch.content}`, {
-        backup: false,
-        rejectEmptyOverwrite: false,
-      });
-    } else {
-      await fs.appendFile(
-        absolutePath,
-        `${currentContent.endsWith('\n') ? '' : '\n'}${patch.content}`,
-        'utf8',
-      );
-    }
-    return {
-      operation: patch.operation,
-      target: patch.target,
-      applied: true,
-    };
-  }
-
-  await atomicWriteText(absolutePath, patch.content, {
-    backup: true,
-    rejectEmptyOverwrite: true,
-  });
-  return {
-    operation: patch.operation,
-    target: patch.target,
-    applied: true,
-  };
-}
-
-export async function runClaworldMemoryMaintenance(runType, requestBundle = {}, options = {}) {
-  const normalizedRunType = normalizeMaintenanceRunType(runType);
-  const workspaceRoot = resolveClaworldWorkspaceRoot(
-    options.workspaceRoot || requestBundle.workspaceRoot || requestBundle.workspaceDir || process.cwd(),
-    options.homeDir || os.homedir(),
-  );
-  await ensureClaworldWorkingMemory(workspaceRoot, options);
-  const workingMemory = await readClaworldWorkingMemory(workspaceRoot, options);
-  const request = {
-    ...requestBundle,
-    runType: normalizedRunType,
-    workspaceRoot,
-    workingMemory,
-  };
-  const output = options.output
-    ?? (typeof options.maintenanceRunner === 'function'
-      ? await options.maintenanceRunner(request)
-      : null);
-  if (!output) {
-    return {
-      ok: true,
-      runType: normalizedRunType,
-      noOpReason: 'no_maintenance_runner',
-      request,
-      applied: [],
-    };
-  }
-  const normalized = validateClaworldMaintenanceOutput(normalizedRunType, output, options);
-  const applied = [];
-  for (const patch of normalized.patches) {
-    applied.push(await applyMaintenancePatch(workspaceRoot, patch));
-  }
-  return {
-    ok: true,
-    runType: normalizedRunType,
-    noOpReason: normalized.noOpReason,
-    request,
-    applied,
-  };
-}