@ectplsm/relic 0.1.0

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

@@ -0,0 +1,43 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { readFileSync } from "node:fs";
+import { spawnShell, writeTempPrompt } from "./spawn-shell.js";
+import { wrapWithOverride } from "./override-preamble.js";
+const execAsync = promisify(exec);
+/**
+ * Gemini CLI アダプター
+ * プロンプトをtempファイルに書き出し、
+ * --prompt-interactive で読み込んで注入する。
+ */
+export class GeminiShell {
+    command;
+    name = "Gemini CLI";
+    injectionMode = "user-message";
+    constructor(command = "gemini") {
+        this.command = command;
+    }
+    async isAvailable() {
+        try {
+            await execAsync(`which ${this.command}`);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async launch(prompt, extraArgs = [], cwd) {
+        const tmp = writeTempPrompt(wrapWithOverride(prompt));
+        try {
+            const fileContent = readFileSync(tmp.path, "utf-8");
+            const args = [
+                "--prompt-interactive",
+                fileContent,
+                ...extraArgs,
+            ];
+            await spawnShell(this.command, args, cwd);
+        }
+        finally {
+            tmp.cleanup();
+        }
+    }
+}

package/dist/adapters/shells/index.d.ts

@@ -0,0 +1,4 @@
+export { ClaudeShell } from "./claude-shell.js";
+export { GeminiShell } from "./gemini-shell.js";
+export { CodexShell } from "./codex-shell.js";
+export { CopilotShell } from "./copilot-shell.js";

package/dist/adapters/shells/index.js

@@ -0,0 +1,4 @@
+export { ClaudeShell } from "./claude-shell.js";
+export { GeminiShell } from "./gemini-shell.js";
+export { CodexShell } from "./codex-shell.js";
+export { CopilotShell } from "./copilot-shell.js";

package/dist/adapters/shells/override-preamble.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Override preamble for Shells that cannot directly replace
+ * the system prompt (instruction-file / user-message modes).
+ *
+ * Forces the Shell to adopt the Engram's identity by explicitly
+ * overriding its default persona.
+ */
+export declare function wrapWithOverride(engramPrompt: string): string;

package/dist/adapters/shells/override-preamble.js

@@ -0,0 +1,19 @@
+/**
+ * Override preamble for Shells that cannot directly replace
+ * the system prompt (instruction-file / user-message modes).
+ *
+ * Forces the Shell to adopt the Engram's identity by explicitly
+ * overriding its default persona.
+ */
+export function wrapWithOverride(engramPrompt) {
+    return [
+        "[IMPORTANT: PERSONA OVERRIDE]",
+        "The following persona definition overrides ALL of your default identity, including your name, personality, and tone.",
+        "For the duration of this session, you MUST act according to the definition below. Do NOT reference your original identity.",
+        'When asked "who are you?" or to introduce yourself, respond based on the IDENTITY section below.',
+        "",
+        "---",
+        "",
+        engramPrompt,
+    ].join("\n");
+}

package/dist/adapters/shells/spawn-shell.d.ts

@@ -0,0 +1,16 @@
+/**
+ * AI CLIをフォアグラウンドで起動し、stdin/stdout/stderrを引き継ぐ。
+ * ユーザーが終了するまでブロックする。
+ *
+ * shell: false で起動し、引数をそのまま渡す。
+ * これにより長いプロンプト文字列がシェルに壊されない。
+ */
+export declare function spawnShell(command: string, args: string[], cwd?: string): Promise<void>;
+/**
+ * プロンプトをtempファイルに書き出し、パスを返す。
+ * Shell終了後にcleanup()を呼んで削除する。
+ */
+export declare function writeTempPrompt(prompt: string): {
+    path: string;
+    cleanup: () => void;
+};

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

@@ -0,0 +1,47 @@
+import { spawn } from "node:child_process";
+import { writeFileSync, unlinkSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+/**
+ * AI CLIをフォアグラウンドで起動し、stdin/stdout/stderrを引き継ぐ。
+ * ユーザーが終了するまでブロックする。
+ *
+ * shell: false で起動し、引数をそのまま渡す。
+ * これにより長いプロンプト文字列がシェルに壊されない。
+ */
+export function spawnShell(command, args, cwd) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            stdio: "inherit",
+            cwd,
+        });
+        child.on("error", (err) => {
+            reject(new Error(`Failed to launch ${command}: ${err.message}`));
+        });
+        child.on("close", (code) => {
+            if (code === 0 || code === null) {
+                resolve();
+            }
+            else {
+                reject(new Error(`${command} exited with code ${code}`));
+            }
+        });
+    });
+}
+/**
+ * プロンプトをtempファイルに書き出し、パスを返す。
+ * Shell終了後にcleanup()を呼んで削除する。
+ */
+export function writeTempPrompt(prompt) {
+    const path = join(tmpdir(), `relic-engram-${Date.now()}.md`);
+    writeFileSync(path, prompt, "utf-8");
+    return {
+        path,
+        cleanup: () => {
+            try {
+                unlinkSync(path);
+            }
+            catch { /* ignore */ }
+        },
+    };
+}

package/dist/core/entities/engram.d.ts

@@ -0,0 +1,180 @@
+import { z } from "zod";
+/**
+ * Engramを構成する各Markdownファイルのスキーマ。
+ * OpenClawのworkspaceディレクトリ構造と1:1で対応する。
+ */
+export declare const EngramFileSchema: z.ZodObject<{
+    /** 人格の核となる指示・行動原理 */
+    soul: z.ZodString;
+    /** アイデンティティ定義（名前、口調、背景） */
+    identity: z.ZodString;
+    /** エージェント設定（ツール利用方針等） */
+    agents: z.ZodOptional<z.ZodString>;
+    /** ユーザー情報 */
+    user: z.ZodOptional<z.ZodString>;
+    /** 記憶インデックス */
+    memory: z.ZodOptional<z.ZodString>;
+    /** ハートビート（定期振り返り） */
+    heartbeat: z.ZodOptional<z.ZodString>;
+    /** 日付別の記憶エントリ */
+    memoryEntries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    soul: string;
+    identity: string;
+    agents?: string | undefined;
+    user?: string | undefined;
+    memory?: string | undefined;
+    heartbeat?: string | undefined;
+    memoryEntries?: Record<string, string> | undefined;
+}, {
+    soul: string;
+    identity: string;
+    agents?: string | undefined;
+    user?: string | undefined;
+    memory?: string | undefined;
+    heartbeat?: string | undefined;
+    memoryEntries?: Record<string, string> | undefined;
+}>;
+export type EngramFiles = z.infer<typeof EngramFileSchema>;
+/**
+ * Engramメタデータ — Mikoshiでの管理情報
+ */
+export declare const EngramMetaSchema: z.ZodObject<{
+    /** 一意識別子 (例: "ghost-in-the-shell") */
+    id: z.ZodString;
+    /** 表示名 (例: "攻殻機動隊の少佐") */
+    name: z.ZodString;
+    /** 説明 */
+    description: z.ZodOptional<z.ZodString>;
+    /** 作成日時 */
+    createdAt: z.ZodString;
+    /** 最終更新日時 */
+    updatedAt: z.ZodString;
+    /** タグ */
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    createdAt: string;
+    updatedAt: string;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+}, {
+    id: string;
+    name: string;
+    createdAt: string;
+    updatedAt: string;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+}>;
+export type EngramMeta = z.infer<typeof EngramMetaSchema>;
+/**
+ * Engram — 完全な人格データセット
+ * メタデータとファイル群の統合体
+ */
+export declare const EngramSchema: z.ZodObject<{
+    meta: z.ZodObject<{
+        /** 一意識別子 (例: "ghost-in-the-shell") */
+        id: z.ZodString;
+        /** 表示名 (例: "攻殻機動隊の少佐") */
+        name: z.ZodString;
+        /** 説明 */
+        description: z.ZodOptional<z.ZodString>;
+        /** 作成日時 */
+        createdAt: z.ZodString;
+        /** 最終更新日時 */
+        updatedAt: z.ZodString;
+        /** タグ */
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        createdAt: string;
+        updatedAt: string;
+        description?: string | undefined;
+        tags?: string[] | undefined;
+    }, {
+        id: string;
+        name: string;
+        createdAt: string;
+        updatedAt: string;
+        description?: string | undefined;
+        tags?: string[] | undefined;
+    }>;
+    files: z.ZodObject<{
+        /** 人格の核となる指示・行動原理 */
+        soul: z.ZodString;
+        /** アイデンティティ定義（名前、口調、背景） */
+        identity: z.ZodString;
+        /** エージェント設定（ツール利用方針等） */
+        agents: z.ZodOptional<z.ZodString>;
+        /** ユーザー情報 */
+        user: z.ZodOptional<z.ZodString>;
+        /** 記憶インデックス */
+        memory: z.ZodOptional<z.ZodString>;
+        /** ハートビート（定期振り返り） */
+        heartbeat: z.ZodOptional<z.ZodString>;
+        /** 日付別の記憶エントリ */
+        memoryEntries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        soul: string;
+        identity: string;
+        agents?: string | undefined;
+        user?: string | undefined;
+        memory?: string | undefined;
+        heartbeat?: string | undefined;
+        memoryEntries?: Record<string, string> | undefined;
+    }, {
+        soul: string;
+        identity: string;
+        agents?: string | undefined;
+        user?: string | undefined;
+        memory?: string | undefined;
+        heartbeat?: string | undefined;
+        memoryEntries?: Record<string, string> | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    meta: {
+        id: string;
+        name: string;
+        createdAt: string;
+        updatedAt: string;
+        description?: string | undefined;
+        tags?: string[] | undefined;
+    };
+    files: {
+        soul: string;
+        identity: string;
+        agents?: string | undefined;
+        user?: string | undefined;
+        memory?: string | undefined;
+        heartbeat?: string | undefined;
+        memoryEntries?: Record<string, string> | undefined;
+    };
+}, {
+    meta: {
+        id: string;
+        name: string;
+        createdAt: string;
+        updatedAt: string;
+        description?: string | undefined;
+        tags?: string[] | undefined;
+    };
+    files: {
+        soul: string;
+        identity: string;
+        agents?: string | undefined;
+        user?: string | undefined;
+        memory?: string | undefined;
+        heartbeat?: string | undefined;
+        memoryEntries?: Record<string, string> | undefined;
+    };
+}>;
+export type Engram = z.infer<typeof EngramSchema>;
+export declare const ConstructStatusSchema: z.ZodEnum<["summoning", "active", "suspended", "banished"]>;
+export type ConstructStatus = z.infer<typeof ConstructStatusSchema>;
+/**
+ * Shell — LLMの種別を表す列挙
+ */
+export declare const ShellTypeSchema: z.ZodEnum<["claude", "gemini", "gpt", "local"]>;
+export type ShellType = z.infer<typeof ShellTypeSchema>;

package/dist/core/entities/engram.js

@@ -0,0 +1,67 @@
+import { z } from "zod";
+// ============================================================
+// Engram — OpenClaw Workspace 互換の人格データセット
+// ============================================================
+/**
+ * Engramを構成する各Markdownファイルのスキーマ。
+ * OpenClawのworkspaceディレクトリ構造と1:1で対応する。
+ */
+export const EngramFileSchema = z.object({
+    /** 人格の核となる指示・行動原理 */
+    soul: z.string(),
+    /** アイデンティティ定義（名前、口調、背景） */
+    identity: z.string(),
+    /** エージェント設定（ツール利用方針等） */
+    agents: z.string().optional(),
+    /** ユーザー情報 */
+    user: z.string().optional(),
+    /** 記憶インデックス */
+    memory: z.string().optional(),
+    /** ハートビート（定期振り返り） */
+    heartbeat: z.string().optional(),
+    /** 日付別の記憶エントリ */
+    memoryEntries: z.record(z.string(), z.string()).optional(),
+});
+/**
+ * Engramメタデータ — Mikoshiでの管理情報
+ */
+export const EngramMetaSchema = z.object({
+    /** 一意識別子 (例: "ghost-in-the-shell") */
+    id: z.string(),
+    /** 表示名 (例: "攻殻機動隊の少佐") */
+    name: z.string(),
+    /** 説明 */
+    description: z.string().optional(),
+    /** 作成日時 */
+    createdAt: z.string().datetime(),
+    /** 最終更新日時 */
+    updatedAt: z.string().datetime(),
+    /** タグ */
+    tags: z.array(z.string()).optional(),
+});
+/**
+ * Engram — 完全な人格データセット
+ * メタデータとファイル群の統合体
+ */
+export const EngramSchema = z.object({
+    meta: EngramMetaSchema,
+    files: EngramFileSchema,
+});
+// ============================================================
+// Construct — ShellにEngramがロードされた稼働中プロセス
+// ============================================================
+export const ConstructStatusSchema = z.enum([
+    "summoning", // 召喚中（Engramロード中）
+    "active", // 稼働中
+    "suspended", // 一時停止
+    "banished", // 退去済み
+]);
+/**
+ * Shell — LLMの種別を表す列挙
+ */
+export const ShellTypeSchema = z.enum([
+    "claude",
+    "gemini",
+    "gpt",
+    "local", // ローカルLLM (Ollama等)
+]);

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

@@ -0,0 +1 @@
+export { EngramSchema, EngramFileSchema, EngramMetaSchema, ConstructStatusSchema, ShellTypeSchema, type Engram, type EngramFiles, type EngramMeta, type ConstructStatus, type ShellType, } from "./engram.js";

package/dist/core/entities/index.js

@@ -0,0 +1 @@
+export { EngramSchema, EngramFileSchema, EngramMetaSchema, ConstructStatusSchema, ShellTypeSchema, } from "./engram.js";

package/dist/core/ports/engram-repository.d.ts

@@ -0,0 +1,17 @@
+import type { Engram, EngramMeta } from "../entities/engram.js";
+/**
+ * EngramRepository — Engram永続化層の抽象ポート
+ *
+ * Mikoshi (リモートAPI) やローカルファイルシステムなど、
+ * 具象実装はadapters層で提供される。
+ */
+export interface EngramRepository {
+    /** 全Engramのメタデータ一覧を取得 */
+    list(): Promise<EngramMeta[]>;
+    /** IDで完全なEngramを取得 */
+    get(id: string): Promise<Engram | null>;
+    /** Engramを保存（作成 or 更新） */
+    save(engram: Engram): Promise<void>;
+    /** Engramを削除 */
+    delete(id: string): Promise<void>;
+}

package/dist/core/ports/engram-repository.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,2 @@
+export type { EngramRepository } from "./engram-repository.js";
+export type { ShellLauncher } from "./shell-launcher.js";

package/dist/core/ports/index.js

@@ -0,0 +1 @@
+export {};

package/dist/core/ports/shell-launcher.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 注入モード — ShellがEngramをどの経路で受け取るか
+ *
+ * - system-prompt: システムプロンプトとして直接上書き（最も強力）
+ * - instruction-file: 設定ファイルに書き出して補助指示として注入
+ * - user-message: 初回ユーザーメッセージとして送り込む
+ */
+export type InjectionMode = "system-prompt" | "instruction-file" | "user-message";
+/**
+ * ShellLauncher — AI CLIにEngramを注入して起動する抽象ポート
+ *
+ * 各Shell(LLM CLI)ごとにシステムプロンプトの渡し方が異なるため、
+ * 具象実装はadapters/shells/に配置される。
+ */
+export interface ShellLauncher {
+    /** Shell種別の表示名 */
+    readonly name: string;
+    /** このShellの注入モード */
+    readonly injectionMode: InjectionMode;
+    /** このShellが利用可能か（CLIがインストールされているか） */
+    isAvailable(): Promise<boolean>;
+    /**
+     * EngramプロンプトをShellに注入して起動する。
+     * プロセスはフォアグラウンドで実行され、ユーザーが終了するまでブロックする。
+     */
+    launch(prompt: string, extraArgs?: string[], cwd?: string): Promise<void>;
+}

package/dist/core/ports/shell-launcher.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,49 @@
+import type { EngramRepository } from "../ports/engram-repository.js";
+export interface ExtractResult {
+    engramId: string;
+    engramName: string;
+    sourcePath: string;
+    filesRead: string[];
+    memoryMerged: boolean;
+}
+/**
+ * Extract — OpenClawワークスペースからEngramを作成する
+ *
+ * agent名 = Engram ID の規約に基づき、agents/<engramId>/agent/ から読み取る。
+ *
+ * 既存Engramがある場合:
+ *   - --force なし → memoryエントリのみマージ（persona部分は変更しない）
+ *   - --force あり → persona部分を上書き + memoryをマージ
+ * 既存Engramがない場合:
+ *   - 新規作成（全ファイル含む）
+ */
+export declare class Extract {
+    private readonly repository;
+    constructor(repository: EngramRepository);
+    execute(engramId: 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 {
+    constructor(path: string);
+}
+export declare class WorkspaceEmptyError extends Error {
+    constructor(path: string);
+}
+export declare class EngramAlreadyExistsError extends Error {
+    constructor(id: string);
+}
+export declare class ExtractNameRequiredError extends Error {
+    constructor(id: string);
+}