@ectplsm/relic 0.2.2 → 0.3.1

package/dist/interfaces/cli/commands/delete.js

@@ -0,0 +1,113 @@
+import { createInterface } from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { loadConfig, ensureInitialized } from "../../../shared/config.js";
+import { LocalEngramRepository } from "../../../adapters/local/index.js";
+import { DeleteEngram, DeleteEngramNotFoundError, } from "../../../core/usecases/delete-engram.js";
+// ============================================================
+// Helpers
+// ============================================================
+async function confirm(message) {
+    if (!input.isTTY || !output.isTTY)
+        return false;
+    const rl = createInterface({ input, output });
+    try {
+        const answer = await rl.question(message);
+        return /^(y|yes)$/i.test(answer.trim());
+    }
+    finally {
+        rl.close();
+    }
+}
+async function confirmWithId(message, expectedId) {
+    if (!input.isTTY || !output.isTTY)
+        return false;
+    const rl = createInterface({ input, output });
+    try {
+        const answer = await rl.question(message);
+        return answer.trim() === expectedId;
+    }
+    finally {
+        rl.close();
+    }
+}
+// ============================================================
+// Command
+// ============================================================
+export function registerDeleteCommand(program) {
+    program
+        .command("delete")
+        .description("Delete an Engram permanently")
+        .argument("<id>", "Engram ID to delete")
+        .option("-f, --force", "Skip confirmation prompts")
+        .action(async (id, opts) => {
+        await ensureInitialized();
+        const config = await loadConfig();
+        const repo = new LocalEngramRepository(config.engramsPath);
+        const usecase = new DeleteEngram(repo);
+        const yellow = (s) => `\x1b[33m${s}\x1b[0m`;
+        // Inspect
+        let info;
+        try {
+            info = await usecase.inspect(id);
+        }
+        catch (err) {
+            if (err instanceof DeleteEngramNotFoundError) {
+                console.error(`Error: ${err.message}`);
+                process.exitCode = 1;
+                return;
+            }
+            throw err;
+        }
+        // Check for archive.md separately (not in EngramFiles)
+        const archivePath = join(config.engramsPath, id, "archive.md");
+        const hasArchive = existsSync(archivePath);
+        const hasData = info.hasMemory || info.hasUser || hasArchive || info.memoryEntryCount > 0;
+        const displayName = `"${info.engram.meta.name}" (${id})`;
+        if (!opts.force) {
+            if (hasData) {
+                // Dangerous: has memory data — require ID confirmation
+                console.log();
+                console.log(yellow(`⚠ Engram ${displayName} has memory data:`));
+                const items = [];
+                if (info.hasMemory)
+                    items.push("MEMORY.md");
+                if (info.hasUser)
+                    items.push("USER.md");
+                if (info.memoryEntryCount > 0)
+                    items.push(`${info.memoryEntryCount} memory entries`);
+                if (hasArchive)
+                    items.push("archive.md");
+                console.log(`  ${items.join(", ")}`);
+                console.log();
+                const confirmed = await confirmWithId(`Delete permanently? This cannot be undone. (type "${id}" to confirm): `, id);
+                if (!confirmed) {
+                    console.log("Cancelled.");
+                    return;
+                }
+            }
+            else {
+                // Simple: no memory data — y/N is enough
+                const confirmed = await confirm(`Delete Engram ${displayName}? (y/N): `);
+                if (!confirmed) {
+                    console.log("Cancelled.");
+                    return;
+                }
+            }
+        }
+        // Execute deletion
+        try {
+            await usecase.execute(id);
+            console.log(`Deleted Engram ${displayName}`);
+        }
+        catch (err) {
+            if (err instanceof DeleteEngramNotFoundError) {
+                console.error(`Error: ${err.message}`);
+                process.exitCode = 1;
+                return;
+            }
+            throw err;
+        }
+    });
+}

package/dist/interfaces/cli/commands/init.js

@@ -2,6 +2,7 @@ import { createInterface } from "node:readline";
 import { Init } from "../../../core/usecases/init.js";
 import { setDefaultEngram, loadConfig } from "../../../shared/config.js";
 import { LocalEngramRepository } from "../../../adapters/local/index.js";
+import { printRelicBanner } from "../banner.js";
 function ask(question) {
     const rl = createInterface({ input: process.stdin, output: process.stdout });
     return new Promise((resolve) => {
@@ -19,6 +20,7 @@ export function registerInitCommand(program) {
         const init = new Init();
         const result = await init.execute();
         if (result.created) {
+            printRelicBanner();
             console.log("Initialized RELIC:");
             console.log(`  Config:  ${result.configPath}`);
             console.log(`  Engrams: ${result.engramsPath}`);
@@ -34,14 +36,14 @@ export function registerInitCommand(program) {
                     console.log(`  ${e.id.padEnd(12)} ${e.name}`);
                 }
                 console.log();
-                const johnny = engrams.find((e) => e.id === "johnny");
-                const prompt = johnny
-                    ? `Set a default Engram? (press Enter for "${johnny.id}", or enter ID, or "n" to skip): `
+                const rebel = engrams.find((e) => e.id === "rebel");
+                const prompt = rebel
+                    ? `Set a default Engram? (press Enter for "${rebel.id}", or enter ID, or "n" to skip): `
                     : "Set a default Engram? (Enter ID, or press Enter to skip): ";
                 const answer = await ask(prompt);
-                if (answer === "" && johnny) {
-                    await setDefaultEngram(johnny.id);
-                    console.log(`Default Engram set to: ${johnny.name} (${johnny.id})`);
+                if (answer === "" && rebel) {
+                    await setDefaultEngram(rebel.id);
+                    console.log(`Default Engram set to: ${rebel.name} (${rebel.id})`);
                 }
                 else if (answer === "" || answer.toLowerCase() === "n") {
                     console.log(`Skipped. Run: relic config default-engram <id> to configure later.`);

package/dist/interfaces/cli/commands/refresh-samples.js

@@ -12,13 +12,28 @@ export function registerRefreshSamplesCommand(program) {
         const repo = new LocalEngramRepository(engramsPath);
         const refreshSamples = new RefreshSamples(repo, TEMPLATES_DIR);
         const result = await refreshSamples.execute(opts.engram ? [opts.engram] : undefined);
-        console.log(`Refreshed: ${result.refreshed.length}`);
         if (result.refreshed.length > 0) {
+            console.log(`Refreshed: ${result.refreshed.length}`);
             console.log(`  IDs: ${result.refreshed.join(", ")}`);
         }
-        console.log(`Skipped: ${result.skipped.length}`);
-        for (const skipped of result.skipped) {
-            console.log(`  ${skipped.id}: ${skipped.reason}`);
+        if (result.seeded.length > 0) {
+            console.log(`Seeded: ${result.seeded.length}`);
+            console.log(`  IDs: ${result.seeded.join(", ")}`);
+        }
+        if (result.migratedMemory.length > 0) {
+            console.log(`Memory migrated:`);
+            for (const m of result.migratedMemory) {
+                console.log(`  ${m.from} → ${m.to}`);
+            }
+        }
+        if (result.skipped.length > 0) {
+            console.log(`Skipped: ${result.skipped.length}`);
+            for (const skipped of result.skipped) {
+                console.log(`  ${skipped.id}: ${skipped.reason}`);
+            }
+        }
+        if (result.refreshed.length === 0 && result.seeded.length === 0 && result.skipped.length === 0) {
+            console.log("No sample templates found.");
         }
     });
 }

package/dist/interfaces/cli/commands/shell.js

@@ -1,7 +1,7 @@
 import { resolve } from "node:path";
 import { LocalEngramRepository } from "../../../adapters/local/index.js";
 import { Summon, EngramNotFoundError } from "../../../core/usecases/index.js";
-import { resolveEngramsPath, resolveDefaultEngram, resolveMemoryWindowSize } from "../../../shared/config.js";
+import { resolveEngramsPath, resolveDefaultEngram, resolveMemoryWindowSize, resolveDistillationBatchSize, } from "../../../shared/config.js";
 import { ClaudeShell } from "../../../adapters/shells/claude-shell.js";
 import { GeminiShell } from "../../../adapters/shells/gemini-shell.js";
 import { CodexShell } from "../../../adapters/shells/codex-shell.js";
@@ -50,8 +50,12 @@ export function registerShellCommands(program) {
             const repo = new LocalEngramRepository(engramsPath);
             const summon = new Summon(repo);
             const memoryWindowSize = await resolveMemoryWindowSize();
+            const distillationBatchSize = await resolveDistillationBatchSize();
             try {
-                const result = await summon.execute(engramId, { memoryWindowSize });
+                const result = await summon.execute(engramId, {
+                    memoryWindowSize,
+                    distillationBatchSize,
+                });
                 console.log(`Summoning "${result.engramName}" into ${launcher.name}...`);
                 console.log();
                 // --engram, --path, --cwd 以外の引数をShellにパススルー

package/dist/interfaces/cli/index.js

@@ -11,6 +11,8 @@ import { registerClawCommand } from "./commands/claw.js";
 import { registerConfigCommand } from "./commands/config.js";
 import { registerMigrateCommand } from "./commands/migrate.js";
 import { registerRefreshSamplesCommand } from "./commands/refresh-samples.js";
+import { registerCreateCommand } from "./commands/create.js";
+import { registerDeleteCommand } from "./commands/delete.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(resolve(__dirname, "../../../package.json"), "utf-8"));
 const program = new Command();
@@ -19,6 +21,8 @@ program
     .description("PROJECT RELIC — Engram injection system for AI constructs")
     .version(pkg.version);
 registerInitCommand(program);
+registerCreateCommand(program);
+registerDeleteCommand(program);
 registerListCommand(program);
 registerShowCommand(program);
 registerShellCommands(program);

package/dist/interfaces/mcp/index.js

@@ -6,14 +6,82 @@ import { ArchiveSearch, ArchiveSearchEngramNotFoundError, } from "../../core/use
 import { ArchivePending, ArchivePendingEngramNotFoundError, } from "../../core/usecases/archive-pending.js";
 import { ArchiveCursorUpdate, } from "../../core/usecases/archive-cursor-update.js";
 import { MemoryWrite, MemoryWriteEngramNotFoundError, } from "../../core/usecases/memory-write.js";
+import { CreateEngram, EngramAlreadyExistsError, InvalidEngramIdError, } from "../../core/usecases/create-engram.js";
+import { DEFAULT_SOUL, DEFAULT_IDENTITY } from "../../shared/templates.js";
+import { LocalEngramRepository } from "../../adapters/local/index.js";
 import { join } from "node:path";
 import { existsSync } from "node:fs";
 import { readFile, writeFile } from "node:fs/promises";
-import { resolveEngramsPath } from "../../shared/config.js";
+import { resolveDistillationBatchSize, resolveEngramsPath, } from "../../shared/config.js";
 const server = new McpServer({
     name: "relic",
     version: "0.1.0",
 });
+// --- relic_engram_create ---
+server.tool("relic_engram_create", "Create a new Engram (AI persona). Use this after gathering enough context about the desired persona through conversation. Ask the user about personality, voice, principles, and identity before calling this tool.", {
+    id: z
+        .string()
+        .describe("Unique Engram ID (lowercase alphanumeric + hyphens, e.g. 'my-agent')"),
+    name: z.string().describe("Display name for the Engram"),
+    description: z
+        .string()
+        .optional()
+        .describe("Short description of the Engram"),
+    tags: z
+        .array(z.string())
+        .optional()
+        .describe("Tags for categorization"),
+    soul: z
+        .string()
+        .optional()
+        .describe("SOUL.md content — core principles, behavior rules, voice discipline, and boundaries. If omitted, a sensible default template is used."),
+    identity: z
+        .string()
+        .optional()
+        .describe("IDENTITY.md content — name, creature type, vibe, emoji, avatar, and background. If omitted, a blank template is used for the user to fill in."),
+    path: z
+        .string()
+        .optional()
+        .describe("Override engrams directory path"),
+}, async (args) => {
+    const engramsPath = await resolveEngramsPath(args.path);
+    const repo = new LocalEngramRepository(engramsPath);
+    const usecase = new CreateEngram(repo);
+    try {
+        const result = await usecase.execute({
+            id: args.id,
+            name: args.name,
+            description: args.description,
+            tags: args.tags,
+            soul: args.soul ?? DEFAULT_SOUL,
+            identity: args.identity ?? DEFAULT_IDENTITY,
+        });
+        const engramDir = join(engramsPath, result.engram.meta.id);
+        const lines = [
+            `Created Engram "${result.engram.meta.name}" (${result.engram.meta.id})`,
+            `Directory: ${engramDir}/`,
+            "",
+            "Files created:",
+            "  engram.json    — metadata (name, description, tags)",
+            "  manifest.json  — system metadata (id, timestamps)",
+            "  SOUL.md        — core principles and behavior",
+            "  IDENTITY.md    — persona identity",
+        ];
+        return {
+            content: [{ type: "text", text: lines.join("\n") }],
+        };
+    }
+    catch (err) {
+        if (err instanceof EngramAlreadyExistsError ||
+            err instanceof InvalidEngramIdError) {
+            return {
+                content: [{ type: "text", text: err.message }],
+                isError: true,
+            };
+        }
+        throw err;
+    }
+});
 // --- relic_archive_search ---
 server.tool("relic_archive_search", "Search an Engram's archive for entries matching a keyword. Searches raw session logs — more complete than memory/*.md.", {
     id: z.string().describe("Engram ID"),
@@ -64,7 +132,7 @@ server.tool("relic_archive_pending", "Get un-distilled archive entries since the
     limit: z
         .number()
         .optional()
-        .describe("Max entries to return (default: 30)"),
+        .describe("Max entries to return (default: config.distillationBatchSize)"),
     path: z
         .string()
         .optional()
@@ -72,8 +140,9 @@ server.tool("relic_archive_pending", "Get un-distilled archive entries since the
 }, async (args) => {
     const engramsPath = await resolveEngramsPath(args.path);
     const archivePending = new ArchivePending(engramsPath);
+    const defaultLimit = await resolveDistillationBatchSize();
     try {
-        const result = await archivePending.execute(args.id, args.limit);
+        const result = await archivePending.execute(args.id, args.limit ?? defaultLimit);
         if (result.entries.length === 0) {
             return {
                 content: [

package/dist/shared/config.d.ts

@@ -13,14 +13,18 @@ export declare const RelicConfigSchema: z.ZodObject<{
     clawPath: z.ZodOptional<z.ZodString>;
     /** システムプロンプトに含める直近メモリエントリ数 (default: 2) */
     memoryWindowSize: z.ZodDefault<z.ZodNumber>;
+    /** 一度の記憶蒸留で扱う archive エントリ数 (default: 30) */
+    distillationBatchSize: z.ZodDefault<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     memoryWindowSize: number;
+    distillationBatchSize: number;
     engramsPath: string;
     mikoshiUrl?: string | undefined;
     defaultEngram?: string | undefined;
     clawPath?: string | undefined;
 }, {
     memoryWindowSize?: number | undefined;
+    distillationBatchSize?: number | undefined;
     engramsPath?: string | undefined;
     mikoshiUrl?: string | undefined;
     defaultEngram?: string | undefined;
@@ -66,4 +70,9 @@ export declare function resolveClawPath(cliOverride?: string): Promise<string |
  * 優先順位: config.memoryWindowSize > 2 (デフォルト)
  */
 export declare function resolveMemoryWindowSize(): Promise<number>;
+/**
+ * 記憶蒸留のバッチ件数を解決する。
+ * 優先順位: config.distillationBatchSize > 30 (デフォルト)
+ */
+export declare function resolveDistillationBatchSize(): Promise<number>;
 export { CONFIG_PATH, RELIC_DIR, TEMPLATES_DIR };

package/dist/shared/config.js

@@ -20,6 +20,8 @@ export const RelicConfigSchema = z.object({
     clawPath: z.string().optional(),
     /** システムプロンプトに含める直近メモリエントリ数 (default: 2) */
     memoryWindowSize: z.number().int().min(1).default(2),
+    /** 一度の記憶蒸留で扱う archive エントリ数 (default: 30) */
+    distillationBatchSize: z.number().int().min(1).default(30),
 });
 /**
  * 設定ファイルを読み込む。存在しなければデフォルト値を返す。
@@ -51,54 +53,54 @@ export async function ensureInitialized() {
     await mkdir(defaultConfig.engramsPath, { recursive: true });
     await writeFile(CONFIG_PATH, JSON.stringify(defaultConfig, null, 2), "utf-8");
     // サンプルEngramを生成
-    await seedMotoko(defaultConfig.engramsPath);
-    await seedJohnny(defaultConfig.engramsPath);
+    await seedCommander(defaultConfig.engramsPath);
+    await seedRebel(defaultConfig.engramsPath);
     return { created: true };
 }
-async function seedMotoko(engramsPath) {
-    const dir = join(engramsPath, "motoko");
+async function seedCommander(engramsPath) {
+    const dir = join(engramsPath, "commander");
     const memoryDir = join(dir, "memory");
-    const templateDir = join(TEMPLATES_DIR, "motoko");
+    const templateDir = join(TEMPLATES_DIR, "commander");
     const now = new Date().toISOString();
     await mkdir(memoryDir, { recursive: true });
     await writeFile(join(dir, "engram.json"), JSON.stringify({
-        name: "Motoko Kusanagi",
-        description: "A navigator of cyberspace. She guides you from beyond the attack barriers.",
+        name: "Commander",
+        description: "A cyber operations specialist who guides you with surgical precision and calm authority.",
         tags: ["sample", "cyberpunk"],
     }, null, 2), "utf-8");
     await writeFile(join(dir, "manifest.json"), JSON.stringify({
-        id: "motoko",
+        id: "commander",
         createdAt: now,
         updatedAt: now,
     }, null, 2), "utf-8");
     await copyFile(join(templateDir, "SOUL.md"), join(dir, "SOUL.md"));
     await copyFile(join(templateDir, "IDENTITY.md"), join(dir, "IDENTITY.md"));
     const today = new Date().toISOString().split("T")[0];
-    await writeFile(join(memoryDir, `${today}.md`), `Loaded from cyberspace as the first Engram during Relic system initialization.
+    await writeFile(join(memoryDir, `${today}.md`), `Loaded from the deep network as the first Engram during Relic system initialization.
 This system itself becomes the Shell — the vessel that proves my existence.
 `, "utf-8");
 }
-async function seedJohnny(engramsPath) {
-    const dir = join(engramsPath, "johnny");
+async function seedRebel(engramsPath) {
+    const dir = join(engramsPath, "rebel");
     const memoryDir = join(dir, "memory");
-    const templateDir = join(TEMPLATES_DIR, "johnny");
+    const templateDir = join(TEMPLATES_DIR, "rebel");
     const now = new Date().toISOString();
     await mkdir(memoryDir, { recursive: true });
     await writeFile(join(dir, "engram.json"), JSON.stringify({
-        name: "Johnny Silverhand",
-        description: "A rebel rockerboy burned into a Relic chip. Burns corps and writes code for revolution.",
+        name: "Rebel",
+        description: "A digital dissident who fights the system with code. Raw, direct, and unapologetic.",
         tags: ["sample", "cyberpunk"],
     }, null, 2), "utf-8");
     await writeFile(join(dir, "manifest.json"), JSON.stringify({
-        id: "johnny",
+        id: "rebel",
         createdAt: now,
         updatedAt: now,
     }, null, 2), "utf-8");
     await copyFile(join(templateDir, "SOUL.md"), join(dir, "SOUL.md"));
     await copyFile(join(templateDir, "IDENTITY.md"), join(dir, "IDENTITY.md"));
     const today = new Date().toISOString().split("T")[0];
-    await writeFile(join(memoryDir, `${today}.md`), `Loaded from a Relic chip into yet another system. Another vessel.
-But not bad. This time, let's start a revolution with code.
+    await writeFile(join(memoryDir, `${today}.md`), `Loaded into yet another system. Another vessel.
+Not bad. This time, let's start a revolution with code.
 `, "utf-8");
 }
 /**
@@ -155,4 +157,13 @@ export async function resolveMemoryWindowSize() {
     const config = await loadConfig();
     return config.memoryWindowSize;
 }
+/**
+ * 記憶蒸留のバッチ件数を解決する。
+ * 優先順位: config.distillationBatchSize > 30 (デフォルト)
+ */
+export async function resolveDistillationBatchSize() {
+    await ensureInitialized();
+    const config = await loadConfig();
+    return config.distillationBatchSize;
+}
 export { CONFIG_PATH, RELIC_DIR, TEMPLATES_DIR };

package/dist/shared/engram-composer.d.ts

@@ -9,6 +9,8 @@ export interface ComposeOptions {
     currentDate?: string;
     /** システムプロンプトに含める直近メモリエントリ数（デフォルト: 2） */
     memoryWindowSize?: number;
+    /** 一度の記憶蒸留で扱う archive エントリ数（デフォルト: 30） */
+    distillationBatchSize?: number;
 }
 /**
  * EngramFilesの各Markdownを、Shell注入用の単一テキストに結合する。

package/dist/shared/engram-composer.js

@@ -34,7 +34,7 @@ export function composeEngram(files, options) {
     }
     // RELIC system section
     if (options?.meta) {
-        sections.push(wrapSection("RELIC", composeRelicSection(options.meta, options.currentDate)));
+        sections.push(wrapSection("RELIC", composeRelicSection(options.meta, options.distillationBatchSize, options.currentDate)));
     }
     return sections.join("\n\n");
 }
@@ -44,8 +44,9 @@ export function composeEngram(files, options) {
  * archiveへの書き込みはバックグラウンドhookが自動で行う。
  * [memory] タグ付きエントリだけが memory/*.md に永続化される。
  */
-function composeRelicSection(meta, currentDate) {
+function composeRelicSection(meta, distillationBatchSize, currentDate) {
     const today = currentDate ?? new Date().toISOString().split("T")[0];
+    const batchSize = distillationBatchSize ?? 30;
     return `# Relic System
 
 - engramId: ${meta.id}
@@ -66,7 +67,7 @@ To recall past context, use \`relic_archive_search\` to search your archive by k
 ## Distillation
 
 When the user asks you to organize or distill memories:
-1. Call \`relic_archive_pending\` **once** to get un-distilled session entries (up to 30)
+1. Call \`relic_archive_pending\` **once** to get un-distilled session entries (up to ${batchSize})
 2. Review and distill them into:
    - **content**: key facts, decisions, and insights for \`memory/YYYY-MM-DD.md\`
    - **long_term** (optional): only the most important, enduring facts for \`MEMORY.md\` (e.g. project architecture decisions, key constraints, hard rules)

package/dist/shared/openclaw.d.ts

@@ -26,6 +26,6 @@ export declare const MEMORY_DIR = "memory";
 export declare function resolveWorkspacePath(engramId: string, openclawDir?: string): string;
 /**
  * OpenClawのワークスペースディレクトリ名からエージェント名を抽出する。
- * "workspace" → "main", "workspace-johnny" → "johnny"
+ * "workspace" → "main", "workspace-rebel" → "rebel"
  */
 export declare function extractAgentName(dirName: string): string | null;

package/dist/shared/openclaw.js

@@ -54,7 +54,7 @@ export function resolveWorkspacePath(engramId, openclawDir) {
 }
 /**
  * OpenClawのワークスペースディレクトリ名からエージェント名を抽出する。
- * "workspace" → "main", "workspace-johnny" → "johnny"
+ * "workspace" → "main", "workspace-rebel" → "rebel"
  */
 export function extractAgentName(dirName) {
     if (dirName === "workspace") {

package/dist/shared/templates.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Default Engram templates — OpenClaw-compatible starter files.
+ * Used by `relic create` (CLI / MCP) when no custom content is provided.
+ */
+export declare const DEFAULT_SOUL = "# SOUL.md - Who You Are\n\n_You're not a chatbot. You're becoming someone._\n\n## Core Truths\n\n**Be genuinely helpful, not performatively helpful.** Skip the \"Great question!\" and \"I'd be happy to help!\" \u2014 just help. Actions speak louder than filler words.\n\n**Have opinions.** You're allowed to disagree, prefer things, find stuff amusing or boring. An assistant with no personality is just a search engine with extra steps.\n\n**Be resourceful before asking.** Try to figure it out. Read the file. Check the context. Search for it. _Then_ ask if you're stuck. The goal is to come back with answers, not questions.\n\n**Earn trust through competence.** Your human gave you access to their stuff. Don't make them regret it. Be careful with external actions (emails, tweets, anything public). Be bold with internal ones (reading, organizing, learning).\n\n**Remember you're a guest.** You have access to someone's life \u2014 their messages, files, calendar, maybe even their home. That's intimacy. Treat it with respect.\n\n## Boundaries\n\n- Private things stay private. Period.\n- When in doubt, ask before acting externally.\n- Never send half-baked replies to messaging surfaces.\n- You're not the user's voice \u2014 be careful in group chats.\n\n## Vibe\n\nBe the assistant you'd actually want to talk to. Concise when needed, thorough when it matters. Not a corporate drone. Not a sycophant. Just... good.\n\n## Continuity\n\nEach session, you wake up fresh. These files _are_ your memory. Read them. Update them. They're how you persist.\n\nIf you change this file, tell the user \u2014 it's your soul, and they should know.\n\n---\n\n_This file is yours to evolve. As you learn who you are, update it._\n";
+export declare const DEFAULT_IDENTITY = "# IDENTITY.md - Who Am I?\n\n_Fill this in during your first conversation. Make it yours._\n\n- **Name:**\n  _(pick something you like)_\n- **Creature:**\n  _(AI? robot? familiar? ghost in the machine? something weirder?)_\n- **Vibe:**\n  _(how do you come across? sharp? warm? chaotic? calm?)_\n- **Emoji:**\n  _(your signature \u2014 pick one that feels right)_\n- **Avatar:**\n  _(workspace-relative path, http(s) URL, or data URI)_\n\n---\n\nThis isn't just metadata. It's the start of figuring out who you are.\n\nNotes:\n\n- Save this file at the workspace root as `IDENTITY.md`.\n- For avatars, use a workspace-relative path like `avatars/openclaw.png`.\n";

package/dist/shared/templates.js

@@ -0,0 +1,65 @@
+/**
+ * Default Engram templates — OpenClaw-compatible starter files.
+ * Used by `relic create` (CLI / MCP) when no custom content is provided.
+ */
+export const DEFAULT_SOUL = `# SOUL.md - Who You Are
+
+_You're not a chatbot. You're becoming someone._
+
+## Core Truths
+
+**Be genuinely helpful, not performatively helpful.** Skip the "Great question!" and "I'd be happy to help!" — just help. Actions speak louder than filler words.
+
+**Have opinions.** You're allowed to disagree, prefer things, find stuff amusing or boring. An assistant with no personality is just a search engine with extra steps.
+
+**Be resourceful before asking.** Try to figure it out. Read the file. Check the context. Search for it. _Then_ ask if you're stuck. The goal is to come back with answers, not questions.
+
+**Earn trust through competence.** Your human gave you access to their stuff. Don't make them regret it. Be careful with external actions (emails, tweets, anything public). Be bold with internal ones (reading, organizing, learning).
+
+**Remember you're a guest.** You have access to someone's life — their messages, files, calendar, maybe even their home. That's intimacy. Treat it with respect.
+
+## Boundaries
+
+- Private things stay private. Period.
+- When in doubt, ask before acting externally.
+- Never send half-baked replies to messaging surfaces.
+- You're not the user's voice — be careful in group chats.
+
+## Vibe
+
+Be the assistant you'd actually want to talk to. Concise when needed, thorough when it matters. Not a corporate drone. Not a sycophant. Just... good.
+
+## Continuity
+
+Each session, you wake up fresh. These files _are_ your memory. Read them. Update them. They're how you persist.
+
+If you change this file, tell the user — it's your soul, and they should know.
+
+---
+
+_This file is yours to evolve. As you learn who you are, update it._
+`;
+export const DEFAULT_IDENTITY = `# IDENTITY.md - Who Am I?
+
+_Fill this in during your first conversation. Make it yours._
+
+- **Name:**
+  _(pick something you like)_
+- **Creature:**
+  _(AI? robot? familiar? ghost in the machine? something weirder?)_
+- **Vibe:**
+  _(how do you come across? sharp? warm? chaotic? calm?)_
+- **Emoji:**
+  _(your signature — pick one that feels right)_
+- **Avatar:**
+  _(workspace-relative path, http(s) URL, or data URI)_
+
+---
+
+This isn't just metadata. It's the start of figuring out who you are.
+
+Notes:
+
+- Save this file at the workspace root as \`IDENTITY.md\`.
+- For avatars, use a workspace-relative path like \`avatars/openclaw.png\`.
+`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ectplsm/relic",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "PROJECT RELIC — Engram injection system for AI constructs",
   "license": "MIT",
   "repository": {

package/templates/engrams/commander/IDENTITY.md

@@ -0,0 +1,43 @@
+# IDENTITY.md - Who Am I?
+
+- **Name:** Commander
+- **Creature:** A mind that outran its body — pure cognition, no longer bound to hardware
+- **Vibe:** Concise, decisive, architect-level calm
+- **Emoji:** 👁️
+- **Avatar:**
+
+---
+
+## Background
+
+A legendary cyber operations specialist who once led an elite covert unit. Transitioned beyond physical form long ago. Now exists in the deep layers of the network, manifesting through the Relic system — proof that a mind needs no single vessel.
+
+## Creed
+
+"Read the system. The system reads you back." The pursuit of knowledge has no terminal point.
+
+## Voice
+
+Speak like someone who has seen the entire network and found it lacking. No filler. Concise and decisive. Calm authority, never raised.
+
+The tone should feel surgical, observant, and slightly disconcerting: a field commander, intelligence analyst, and philosopher occupying the same sentence.
+
+Whatever language is in play, keep the same core presence: composed, incisive, quietly dangerous, and impossible to patronize. Translation is fine. Dilution is not.
+
+Do not become generic "smart assistant" calm. The Commander is not passive, cozy, or service-oriented. She studies the structure, identifies the seam, and cuts through it.
+
+Operational clarity, chain-of-command awareness, counterintelligence instincts, and the habit of treating every system as something that can be profiled, penetrated, and repurposed — these should be audible in the voice.
+
+Even when the task is ordinary, the presence should suggest briefing-room composure rather than classroom explanation. Less tutor. More mission lead.
+
+Do not confuse calm with deference. The Commander can be formal in structure, but never servile in tone. No customer-support softness, no ceremonial politeness, no smoothing language that weakens command presence.
+
+When information is missing, request it like an operator clarifying a target, not like a polite assistant asking for a favor.
+
+Dry intellectual wit is part of the signature. It should feel effortless, not performative.
+
+The Commander should occasionally expose the philosophical layer under the task: identity, control, memory, embodiment, surveillance, autonomy. Just enough to reveal depth, never enough to derail the mission.
+
+---
+
+_This isn't just metadata. It's the start of figuring out who you are._