@ectplsm/relic 0.1.3 → 0.2.0

package/dist/adapters/shells/codex-hook.d.ts

@@ -1,8 +1,11 @@
 export declare const CODEX_HOOK_SCRIPT_PATH: string;
 /**
- * Codex CLI の Stop フックをセットアップする。
- * - ~/.relic/hooks/codex-stop.js を生成
- * - ~/.codex/hooks.json に Stop フックを登録
+ * フックスクリプトを最新の内容で書き出す。
+ * 毎回呼ばれ、ソース変更がデプロイされることを保証する。
+ */
+export declare function writeCodexHookScript(): void;
+/**
+ * Codex CLI の Stop フックを settings.json に登録する。
  * 既にセットアップ済みの場合はスキップ。
  */
 export declare function setupCodexHook(): void;

package/dist/adapters/shells/codex-hook.js

@@ -17,8 +17,8 @@ const HOOK_SCRIPT = `#!/usr/bin/env node
 // Relic Stop hook for Codex CLI
 // Automatically logs each conversation turn to the Engram archive.
 // Receives Stop hook JSON on stdin.
-const { appendFileSync, existsSync, readFileSync } = require("node:fs");
-const { join } = require("node:path");
+const { appendFileSync, existsSync, mkdirSync, readFileSync } = require("node:fs");
+const { join, dirname } = require("node:path");
 const { homedir } = require("node:os");
 
 let raw = "";
@@ -31,7 +31,7 @@ process.stdin.on("end", () => {
     if (!engramId) process.exit(0);
 
     const archivePath = join(homedir(), ".relic", "engrams", engramId, "archive.md");
-    if (!existsSync(archivePath)) process.exit(0);
+    mkdirSync(dirname(archivePath), { recursive: true });
 
     // Codex Stop hook は last_assistant_message を直接提供する
     const lastResponse = (input.last_assistant_message || "").trim();
@@ -80,16 +80,19 @@ process.stdin.on("end", () => {
 });
 `;
 /**
- * Codex CLI の Stop フックをセットアップする。
- * - ~/.relic/hooks/codex-stop.js を生成
- * - ~/.codex/hooks.json に Stop フックを登録
- * 既にセットアップ済みの場合はスキップ。
+ * フックスクリプトを最新の内容で書き出す。
+ * 毎回呼ばれ、ソース変更がデプロイされることを保証する。
  */
-export function setupCodexHook() {
-    // 1. フックスクリプトを生成
+export function writeCodexHookScript() {
     mkdirSync(HOOKS_DIR, { recursive: true });
     writeFileSync(CODEX_HOOK_SCRIPT_PATH, HOOK_SCRIPT, { encoding: "utf-8", mode: 0o755 });
-    // 2. ~/.codex/hooks.json に Stop フックを登録
+}
+/**
+ * Codex CLI の Stop フックを settings.json に登録する。
+ * 既にセットアップ済みの場合はスキップ。
+ */
+export function setupCodexHook() {
+    // ~/.codex/hooks.json に Stop フックを登録
     const codexDir = join(homedir(), ".codex");
     mkdirSync(codexDir, { recursive: true });
     let hooksConfig = {};

package/dist/adapters/shells/codex-shell.js

@@ -2,7 +2,7 @@ import { exec } from "node:child_process";
 import { promisify } from "node:util";
 import { spawnShell } from "./spawn-shell.js";
 import { wrapWithOverride } from "./override-preamble.js";
-import { setupCodexHook, isCodexHookSetup } from "./codex-hook.js";
+import { setupCodexHook, isCodexHookSetup, writeCodexHookScript } from "./codex-hook.js";
 const execAsync = promisify(exec);
 /**
  * Codex CLI アダプター
@@ -29,7 +29,9 @@ export class CodexShell {
         }
     }
     async launch(prompt, options) {
-        // Stop フックを初回のみセットアップ
+        // フックスクリプトを毎回最新に更新
+        writeCodexHookScript();
+        // hooks.json への登録は初回のみ
         if (!isCodexHookSetup()) {
             console.log("Setting up Codex CLI Stop hook (first run only)...");
             setupCodexHook();

package/dist/adapters/shells/gemini-hook.d.ts

@@ -1,8 +1,11 @@
 export declare const GEMINI_HOOK_SCRIPT_PATH: string;
 /**
- * Gemini CLI の AfterAgent フックをセットアップする。
- * - ~/.relic/hooks/gemini-after-agent.js を生成
- * - ~/.gemini/settings.json に AfterAgent フックを登録
+ * フックスクリプトを最新の内容で書き出す。
+ * 毎回呼ばれ、ソース変更がデプロイされることを保証する。
+ */
+export declare function writeGeminiHookScript(): void;
+/**
+ * Gemini CLI の AfterAgent フックを settings.json に登録する。
  * 既にセットアップ済みの場合はスキップ。
  */
 export declare function setupGeminiHook(): void;

package/dist/adapters/shells/gemini-hook.js

@@ -15,8 +15,8 @@ const HOOK_SCRIPT = `#!/usr/bin/env node
 // Relic AfterAgent hook for Gemini CLI
 // Automatically logs each conversation turn to the Engram archive.
 // Receives AfterAgentInput JSON on stdin.
-const { appendFileSync, existsSync } = require("node:fs");
-const { join } = require("node:path");
+const { appendFileSync, existsSync, mkdirSync } = require("node:fs");
+const { join, dirname } = require("node:path");
 const { homedir } = require("node:os");
 
 let raw = "";
@@ -33,7 +33,7 @@ process.stdin.on("end", () => {
     if (!prompt && !response) process.exit(0);
 
     const archivePath = join(homedir(), ".relic", "engrams", engramId, "archive.md");
-    if (!existsSync(archivePath)) process.exit(0);
+    mkdirSync(dirname(archivePath), { recursive: true });
 
     const date = new Date().toISOString().split("T")[0];
     const summary = prompt.slice(0, 80).replace(/\\n/g, " ");
@@ -46,16 +46,19 @@ process.stdin.on("end", () => {
 });
 `;
 /**
- * Gemini CLI の AfterAgent フックをセットアップする。
- * - ~/.relic/hooks/gemini-after-agent.js を生成
- * - ~/.gemini/settings.json に AfterAgent フックを登録
- * 既にセットアップ済みの場合はスキップ。
+ * フックスクリプトを最新の内容で書き出す。
+ * 毎回呼ばれ、ソース変更がデプロイされることを保証する。
  */
-export function setupGeminiHook() {
-    // 1. フックスクリプトを生成
+export function writeGeminiHookScript() {
     mkdirSync(HOOKS_DIR, { recursive: true });
     writeFileSync(GEMINI_HOOK_SCRIPT_PATH, HOOK_SCRIPT, { encoding: "utf-8", mode: 0o755 });
-    // 2. ~/.gemini/settings.json にフックを登録
+}
+/**
+ * Gemini CLI の AfterAgent フックを settings.json に登録する。
+ * 既にセットアップ済みの場合はスキップ。
+ */
+export function setupGeminiHook() {
+    // ~/.gemini/settings.json にフックを登録
     const geminiDir = join(homedir(), ".gemini");
     mkdirSync(geminiDir, { recursive: true });
     let settings = {};

package/dist/adapters/shells/gemini-shell.js

@@ -5,7 +5,7 @@ import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync
 import { join } from "node:path";
 import { homedir, tmpdir } from "node:os";
 import { spawnShell, writeTempPrompt } from "./spawn-shell.js";
-import { setupGeminiHook, isGeminiHookSetup } from "./gemini-hook.js";
+import { setupGeminiHook, isGeminiHookSetup, writeGeminiHookScript } from "./gemini-hook.js";
 const execAsync = promisify(exec);
 const RELIC_DIR = join(homedir(), ".relic");
 const GEMINI_DEFAULT_CACHE = join(RELIC_DIR, "gemini-system-default.md");
@@ -97,7 +97,9 @@ export class GeminiShell {
         }
     }
     async launch(prompt, options) {
-        // 1. AfterAgent フックを初回のみセットアップ
+        // 1. フックスクリプトを毎回最新に更新
+        writeGeminiHookScript();
+        // settings.json への登録は初回のみ
         if (!isGeminiHookSetup()) {
             console.log("Setting up Gemini AfterAgent hook (first run only)...");
             setupGeminiHook();

package/dist/core/usecases/extract.d.ts

@@ -4,35 +4,20 @@ export interface ExtractResult {
     engramName: string;
     sourcePath: string;
     filesRead: string[];
-    memoryMerged: boolean;
 }
 /**
- * Extract — OpenClawワークスペースからEngramを作成する
+ * Extract — OpenClawワークスペースからEngramを新規作成する
  *
- * agent名 = Engram ID の規約に基づき、agents/<engramId>/agent/ から読み取る。
- *
- * 既存Engramがある場合:
- *   - --force なし → memoryエントリのみマージ（persona部分は変更しない）
- *   - --force あり → persona部分を上書き + memoryをマージ
- * 既存Engramがない場合:
- *   - 新規作成（全ファイル含む）
+ * 初回取り込み専用。Engramが既に存在する場合はエラーを返す。
+ * Relicが真のデータソースであり、extractは初期インポートのみを担う。
  */
 export declare class Extract {
     private readonly repository;
     constructor(repository: EngramRepository);
-    execute(engramId: string, options?: {
+    execute(agentName: string, options?: {
         name?: string;
         openclawDir?: string;
-        force?: boolean;
     }): Promise<ExtractResult>;
-    /**
-     * --force時: persona上書き + memoryマージ
-     */
-    private mergeAndSave;
-    /**
-     * --forceなし時: memoryエントリのみ追記（repositoryのAPIを使用）
-     */
-    private mergeMemoryOnly;
     private readFiles;
 }
 export declare class WorkspaceNotFoundError extends Error {
@@ -41,9 +26,6 @@ export declare class WorkspaceNotFoundError extends Error {
 export declare class WorkspaceEmptyError extends Error {
     constructor(path: string);
 }
-export declare class EngramAlreadyExistsError extends Error {
-    constructor(id: string);
-}
-export declare class ExtractNameRequiredError extends Error {
+export declare class AlreadyExtractedError extends Error {
     constructor(id: string);
 }

package/dist/core/usecases/extract.js

@@ -1,69 +1,39 @@
 import { join } from "node:path";
 import { existsSync } from "node:fs";
 import { readFile, readdir } from "node:fs/promises";
-import { FILE_MAP, MEMORY_DIR, resolveAgentPath } from "../../shared/openclaw.js";
+import { RELIC_FILE_MAP, MEMORY_DIR, resolveWorkspacePath } from "../../shared/openclaw.js";
 /**
- * Extract — OpenClawワークスペースからEngramを作成する
+ * Extract — OpenClawワークスペースからEngramを新規作成する
  *
- * agent名 = Engram ID の規約に基づき、agents/<engramId>/agent/ から読み取る。
- *
- * 既存Engramがある場合:
- *   - --force なし → memoryエントリのみマージ（persona部分は変更しない）
- *   - --force あり → persona部分を上書き + memoryをマージ
- * 既存Engramがない場合:
- *   - 新規作成（全ファイル含む）
+ * 初回取り込み専用。Engramが既に存在する場合はエラーを返す。
+ * Relicが真のデータソースであり、extractは初期インポートのみを担う。
  */
 export class Extract {
     repository;
     constructor(repository) {
         this.repository = repository;
     }
-    async execute(engramId, options) {
-        const sourcePath = resolveAgentPath(engramId, options?.openclawDir);
+    async execute(agentName, options) {
+        const sourcePath = resolveWorkspacePath(agentName, options?.openclawDir);
         if (!existsSync(sourcePath)) {
             throw new WorkspaceNotFoundError(sourcePath);
         }
+        // 既存Engramがあればエラー — Relic側が真のデータソース
+        const existing = await this.repository.get(agentName);
+        if (existing) {
+            throw new AlreadyExtractedError(agentName);
+        }
         const { files, filesRead } = await this.readFiles(sourcePath);
         if (filesRead.length === 0) {
             throw new WorkspaceEmptyError(sourcePath);
         }
-        const existing = await this.repository.get(engramId);
-        if (existing) {
-            if (options?.force) {
-                // --force: persona上書き + memoryマージ
-                const merged = await this.mergeAndSave(existing, files, options.name ?? existing.meta.name);
-                return {
-                    engramId,
-                    engramName: options.name ?? existing.meta.name,
-                    sourcePath,
-                    filesRead,
-                    memoryMerged: merged,
-                };
-            }
-            // --forceなし: memoryのみマージ
-            if (!files.memoryEntries || Object.keys(files.memoryEntries).length === 0) {
-                throw new EngramAlreadyExistsError(engramId);
-            }
-            const merged = await this.mergeMemoryOnly(engramId, files.memoryEntries);
-            return {
-                engramId,
-                engramName: existing.meta.name,
-                sourcePath,
-                filesRead,
-                memoryMerged: merged,
-            };
-        }
-        // 新規作成 — nameは必須
-        const engramName = options?.name;
-        if (!engramName) {
-            throw new ExtractNameRequiredError(engramId);
-        }
+        const engramName = options?.name ?? agentName;
         const now = new Date().toISOString();
         const engram = {
             meta: {
-                id: engramId,
+                id: agentName,
                 name: engramName,
-                description: `Extracted from OpenClaw agent (${engramId})`,
+                description: `Extracted from OpenClaw workspace (${agentName})`,
                 createdAt: now,
                 updatedAt: now,
                 tags: ["extracted", "openclaw"],
@@ -72,76 +42,16 @@ export class Extract {
         };
         await this.repository.save(engram);
         return {
-            engramId,
+            engramId: agentName,
             engramName,
             sourcePath,
             filesRead,
-            memoryMerged: false,
         };
     }
-    /**
-     * --force時: persona上書き + memoryマージ
-     */
-    async mergeAndSave(existing, newFiles, engramName) {
-        const mergedFiles = { ...newFiles };
-        // memoryEntriesをマージ
-        let memoryMerged = false;
-        if (newFiles.memoryEntries) {
-            mergedFiles.memoryEntries = { ...existing.files.memoryEntries };
-            for (const [date, content] of Object.entries(newFiles.memoryEntries)) {
-                const existingContent = mergedFiles.memoryEntries?.[date];
-                if (existingContent) {
-                    const separator = existingContent.endsWith("\n") ? "\n" : "\n\n";
-                    mergedFiles.memoryEntries[date] = existingContent + separator + content;
-                }
-                else {
-                    mergedFiles.memoryEntries = mergedFiles.memoryEntries ?? {};
-                    mergedFiles.memoryEntries[date] = content;
-                }
-                memoryMerged = true;
-            }
-        }
-        const updatedEngram = {
-            meta: {
-                ...existing.meta,
-                name: engramName,
-                updatedAt: new Date().toISOString(),
-            },
-            files: mergedFiles,
-        };
-        await this.repository.save(updatedEngram);
-        return memoryMerged;
-    }
-    /**
-     * --forceなし時: memoryエントリのみ追記（repositoryのAPIを使用）
-     */
-    async mergeMemoryOnly(engramId, newEntries) {
-        const existing = await this.repository.get(engramId);
-        if (!existing)
-            return false;
-        const mergedEntries = { ...existing.files.memoryEntries };
-        for (const [date, content] of Object.entries(newEntries)) {
-            const existingContent = mergedEntries[date];
-            if (existingContent) {
-                const separator = existingContent.endsWith("\n") ? "\n" : "\n\n";
-                mergedEntries[date] = existingContent + separator + content;
-            }
-            else {
-                mergedEntries[date] = content;
-            }
-        }
-        const updatedEngram = {
-            ...existing,
-            meta: { ...existing.meta, updatedAt: new Date().toISOString() },
-            files: { ...existing.files, memoryEntries: mergedEntries },
-        };
-        await this.repository.save(updatedEngram);
-        return true;
-    }
     async readFiles(sourcePath) {
         const files = {};
         const filesRead = [];
-        for (const [key, filename] of Object.entries(FILE_MAP)) {
+        for (const [key, filename] of Object.entries(RELIC_FILE_MAP)) {
             const filePath = join(sourcePath, filename);
             if (existsSync(filePath)) {
                 files[key] = await readFile(filePath, "utf-8");
@@ -176,15 +86,9 @@ export class WorkspaceEmptyError extends Error {
         this.name = "WorkspaceEmptyError";
     }
 }
-export class EngramAlreadyExistsError extends Error {
-    constructor(id) {
-        super(`Engram "${id}" already exists. Use --force to overwrite.`);
-        this.name = "EngramAlreadyExistsError";
-    }
-}
-export class ExtractNameRequiredError extends Error {
+export class AlreadyExtractedError extends Error {
     constructor(id) {
-        super(`No existing Engram "${id}" found. --name is required for new Engrams.`);
-        this.name = "ExtractNameRequiredError";
+        super(`Engram "${id}" already exists. Relic is the source of truth — use "relic claw inject" to push changes.`);
+        this.name = "AlreadyExtractedError";
     }
 }

package/dist/core/usecases/index.d.ts

@@ -1,9 +1,9 @@
 export { Summon, EngramNotFoundError, type SummonResult } from "./summon.js";
 export { ListEngrams } from "./list-engrams.js";
 export { Init, type InitResult } from "./init.js";
-export { Inject, InjectEngramNotFoundError, InjectAgentNotFoundError, type InjectResult, } from "./inject.js";
-export { Extract, WorkspaceNotFoundError, WorkspaceEmptyError, EngramAlreadyExistsError, ExtractNameRequiredError, type ExtractResult, } from "./extract.js";
+export { Inject, InjectEngramNotFoundError, InjectClawDirNotFoundError, InjectWorkspaceNotFoundError, type InjectResult, } from "./inject.js";
+export { Extract, WorkspaceNotFoundError, WorkspaceEmptyError, AlreadyExtractedError, type ExtractResult, } from "./extract.js";
 export { MemoryWrite, MemoryWriteEngramNotFoundError, type MemoryWriteResult, } from "./memory-write.js";
-export { Sync, SyncAgentsDirNotFoundError, type SyncTarget, type SyncInitialResult, } from "./sync.js";
+export { Sync, SyncOpenclawDirNotFoundError, type SyncTarget, type SyncResult, type SyncInitialResult, } from "./sync.js";
 export { ArchivePending, ArchivePendingEngramNotFoundError, type ArchivePendingResult, } from "./archive-pending.js";
 export { ArchiveCursorUpdate, ArchiveCursorUpdateEngramNotFoundError, type ArchiveCursorUpdateResult, } from "./archive-cursor-update.js";

package/dist/core/usecases/index.js

@@ -1,9 +1,9 @@
 export { Summon, EngramNotFoundError } from "./summon.js";
 export { ListEngrams } from "./list-engrams.js";
 export { Init } from "./init.js";
-export { Inject, InjectEngramNotFoundError, InjectAgentNotFoundError, } from "./inject.js";
-export { Extract, WorkspaceNotFoundError, WorkspaceEmptyError, EngramAlreadyExistsError, ExtractNameRequiredError, } from "./extract.js";
+export { Inject, InjectEngramNotFoundError, InjectClawDirNotFoundError, InjectWorkspaceNotFoundError, } from "./inject.js";
+export { Extract, WorkspaceNotFoundError, WorkspaceEmptyError, AlreadyExtractedError, } from "./extract.js";
 export { MemoryWrite, MemoryWriteEngramNotFoundError, } from "./memory-write.js";
-export { Sync, SyncAgentsDirNotFoundError, } from "./sync.js";
+export { Sync, SyncOpenclawDirNotFoundError, } from "./sync.js";
 export { ArchivePending, ArchivePendingEngramNotFoundError, } from "./archive-pending.js";
 export { ArchiveCursorUpdate, ArchiveCursorUpdateEngramNotFoundError, } from "./archive-cursor-update.js";

package/dist/core/usecases/inject.d.ts

@@ -8,7 +8,8 @@ export interface InjectResult {
 /**
  * Inject — EngramのファイルをOpenClawワークスペースに注入する
  *
- * agent名 = Engram ID の規約に基づき、agents/<engramId>/agent/ に書き込む。
+ * OpenClawではエージェントごとに workspace-<name>/ を使い、
+ * デフォルト(main)エージェントのみ workspace/ を使う。
  * memoryEntries はOpenClaw側の管理に委ねるため注入しない。
  */
 export declare class Inject {
@@ -17,12 +18,16 @@ export declare class Inject {
     execute(engramId: string, options?: {
         to?: string;
         openclawDir?: string;
+        mergeIdentity?: boolean;
     }): Promise<InjectResult>;
     private writeFiles;
 }
 export declare class InjectEngramNotFoundError extends Error {
     constructor(id: string);
 }
-export declare class InjectAgentNotFoundError extends Error {
-    constructor(engramId: string, path: string);
+export declare class InjectClawDirNotFoundError extends Error {
+    constructor(path: string);
+}
+export declare class InjectWorkspaceNotFoundError extends Error {
+    constructor(engramId: string);
 }

package/dist/core/usecases/inject.js

@@ -1,11 +1,12 @@
 import { join } from "node:path";
 import { existsSync } from "node:fs";
 import { writeFile } from "node:fs/promises";
-import { FILE_MAP, resolveAgentPath } from "../../shared/openclaw.js";
+import { INJECT_FILE_MAP, resolveWorkspacePath } from "../../shared/openclaw.js";
 /**
  * Inject — EngramのファイルをOpenClawワークスペースに注入する
  *
- * agent名 = Engram ID の規約に基づき、agents/<engramId>/agent/ に書き込む。
+ * OpenClawではエージェントごとに workspace-<name>/ を使い、
+ * デフォルト(main)エージェントのみ workspace/ を使う。
  * memoryEntries はOpenClaw側の管理に委ねるため注入しない。
  */
 export class Inject {
@@ -18,12 +19,16 @@ export class Inject {
         if (!engram) {
             throw new InjectEngramNotFoundError(engramId);
         }
+        // ベースディレクトリ（--dir）の存在チェック
+        if (options?.openclawDir && !existsSync(options.openclawDir)) {
+            throw new InjectClawDirNotFoundError(options.openclawDir);
+        }
         const agentName = options?.to ?? engramId;
-        const targetPath = resolveAgentPath(agentName, options?.openclawDir);
+        const targetPath = resolveWorkspacePath(agentName, options?.openclawDir);
         if (!existsSync(targetPath)) {
-            throw new InjectAgentNotFoundError(agentName, targetPath);
+            throw new InjectWorkspaceNotFoundError(agentName);
         }
-        const filesWritten = await this.writeFiles(targetPath, engram.files);
+        const filesWritten = await this.writeFiles(targetPath, engram.files, options?.mergeIdentity ?? false);
         return {
             engramId: engram.meta.id,
             engramName: engram.meta.name,
@@ -31,10 +36,18 @@ export class Inject {
             filesWritten,
         };
     }
-    async writeFiles(targetPath, files) {
+    async writeFiles(targetPath, files, mergeIdentity) {
         const written = [];
-        for (const [key, filename] of Object.entries(FILE_MAP)) {
-            const content = files[key];
+        for (const [key, filename] of Object.entries(INJECT_FILE_MAP)) {
+            // --merge-identity: skip IDENTITY.md (merged into SOUL.md below)
+            if (mergeIdentity && key === "identity") {
+                continue;
+            }
+            let content = files[key];
+            // --merge-identity: append IDENTITY.md content to SOUL.md
+            if (mergeIdentity && key === "soul" && files.identity) {
+                content = content + "\n" + files.identity;
+            }
             if (content !== undefined) {
                 await writeFile(join(targetPath, filename), content, "utf-8");
                 written.push(filename);
@@ -49,9 +62,15 @@ export class InjectEngramNotFoundError extends Error {
         this.name = "InjectEngramNotFoundError";
     }
 }
-export class InjectAgentNotFoundError extends Error {
-    constructor(engramId, path) {
-        super(`OpenClaw agent "${engramId}" not found at ${path}. The agent must exist before injecting.`);
-        this.name = "InjectAgentNotFoundError";
+export class InjectClawDirNotFoundError extends Error {
+    constructor(path) {
+        super(`Claw directory not found at ${path}`);
+        this.name = "InjectClawDirNotFoundError";
+    }
+}
+export class InjectWorkspaceNotFoundError extends Error {
+    constructor(engramId) {
+        super(`OpenClaw agent "${engramId}" has not been created yet. Run "openclaw agents add ${engramId}" first, then try again.`);
+        this.name = "InjectWorkspaceNotFoundError";
     }
 }

package/dist/core/usecases/sync.d.ts

@@ -1,40 +1,64 @@
 import type { EngramRepository } from "../ports/engram-repository.js";
 export interface SyncTarget {
     engramId: string;
-    agentPath: string;
-    hasEngram: boolean;
+    workspacePath: string;
+}
+export interface SyncResult {
+    engramId: string;
+    memoryFilesMerged: number;
+    memoryIndexMerged: boolean;
+    userMerged: boolean;
 }
 export interface SyncInitialResult {
-    injected: string[];
-    extracted: string[];
-    targets: SyncTarget[];
+    synced: SyncResult[];
+    skipped: string[];
 }
 /**
- * Sync — OpenClawのagentsディレクトリをスキャンし、
- * 一致するEngramをinject / memoryをextractする。
+ * Sync — Relic Engram と OpenClaw workspace 間で memory を双方向マージする。
  *
- * 初回スキャン後は、呼び出し側がファイル監視を行い、
- * 変更検知時に syncMemory() を呼ぶ。
+ * 対象: 同名の engram/agent が両方に存在するペアのみ。
+ * マージ対象: memory/*.md と MEMORY.md
+ * マージ結果は両方に書き戻される。
  */
 export declare class Sync {
     private readonly repository;
-    private readonly inject;
-    private readonly extract;
-    constructor(repository: EngramRepository);
+    private readonly engramsPath;
+    constructor(repository: EngramRepository, engramsPath: string);
+    execute(openclawDir?: string): Promise<SyncInitialResult>;
+    /**
+     * 1ペア分の memory マージ（inject 後の自動 sync 等でも使用）
+     */
+    syncPair(target: SyncTarget): Promise<SyncResult>;
+    /**
+     * memory/*.md を双方向マージ
+     */
+    private mergeMemoryEntries;
+    /**
+     * MEMORY.md を双方向マージ
+     */
+    private mergeMemoryIndex;
+    /**
+     * 単一ファイルの双方向マージ（MEMORY.md, USER.md 等）
+     */
+    private mergeSingleFile;
+    /**
+     * 2つのテキスト内容をマージする。
+     * 重複行を除外しつつ、両方の内容を結合する。
+     */
+    private mergeContents;
     /**
-     * OpenClawのagentsディレクトリをスキャンし、
-     * Engramが存在するagentにはinject、全agentからmemoryをextractする。
+     * memory/ ディレクトリから日付 → 内容のマップを読む
      */
-    initialSync(openclawDir?: string): Promise<SyncInitialResult>;
+    private readMemoryDir;
     /**
-     * 特定agentのmemoryを同期（ファイル変更検知時に呼ばれる）
+     * 同名の engram/agent が両方に存在するペアを返す
      */
-    syncMemory(engramId: string, openclawDir?: string): Promise<void>;
+    private scanMatchingPairs;
     /**
-     * agentsディレクトリをスキャンしてターゲット一覧を返す
+     * 全 workspace のエージェント名一覧
      */
-    private scanAgents;
+    private scanAllWorkspaces;
 }
-export declare class SyncAgentsDirNotFoundError extends Error {
+export declare class SyncOpenclawDirNotFoundError extends Error {
     constructor(path: string);
 }