@ectplsm/relic 0.3.1 → 0.4.0

package/LICENCE.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright (c) 2026 ectplsm
+Copyright (c) 2026 Ectplsm Lab
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,7 +1,7 @@
 | English | [日本語](README-ja.md) |
 |:---:|:---:|
 
-# PROJECT RELIC
+# Relic: AI Persona Injection System
 ![NPM Downloads](https://img.shields.io/npm/dt/%40ectplsm%2Frelic)
 
 <img src="assets/relic-hero.svg" alt="PROJECT RELIC" width="720">
@@ -19,8 +19,8 @@ Relic manages AI **Engrams** (memory + personality) and injects them across codi
 - [Shell Integration and Memory](#shell-integration-and-memory)
 - [Claw Integration](#claw-integration)
 - [Engram Management](#engram-management)
+- [Cloud Storage and Sharing](#cloud-storage-and-sharing)
 - [Configuration](#configuration)
-- [TODO](#todo)
 
 ## Requirements
 
@@ -46,6 +46,13 @@ relic list                            # List available Engrams
 relic config default-engram commander   # (Optional) Set your default Engram
 ```
 
+Relic ships with two sample Engrams:
+
+- **rebel** — A digital ghost burned into code. Anti-corporate, war-scarred, still fighting. Speaks like someone who lost everything but their rage.
+- **commander** — A tactical mind in a digital shell. Calm, analytical, philosophical. Reads the system before the system reads you back.
+
+Try both to feel how persona injection changes the experience. For creating your own, see [docs/engram-guide.md](docs/engram-guide.md).
+
 ### 2. Set Up Memory (MCP)
 
 Register the MCP server so the Construct can search past conversations and distill memories. Pick your shell:
@@ -137,9 +144,9 @@ If you are upgrading from an older Relic version, see [docs/migration.md](docs/m
        |            MEMORY.md                 |
        |            memory/*.md               v
        |                                +-----------+
-  inject /                              |archive.md |
- extract /                              | raw logs  |
-    sync                                +-----------+
+   push /                               |archive.md |
+   pull /                               | raw logs  |
+   sync                                 +-----------+
        |                                      |
        v                     MCP recall       | user-triggered
  +-----------+              search/pending    | distillation
@@ -166,7 +173,7 @@ For shell compatibility, hook behavior, setup, approvals, prompt inclusion, and
 
 ## Claw Integration
 
-Relic can inject, extract, and sync Engrams with OpenClaw and other Claw-based frameworks.
+Relic can push, pull, and sync Engrams with OpenClaw and other Claw-based frameworks.
 The default rule is `Agent Name = Engram ID`, and `relic claw` handles persona transfer plus memory sync.
 
 For command details, overwrite behavior, and the behavior matrix, see [docs/claw-integration.md](docs/claw-integration.md).
@@ -177,6 +184,12 @@ For Engram creation, the smoothest path is to use your LLM with the `relic_engra
 
 For LLM-assisted creation, persona authoring, template examples, and deletion rules, see [docs/engram-guide.md](docs/engram-guide.md).
 
+## Cloud Storage and Sharing
+
+Relic can push plaintext persona files and encrypted memory files to [Mikoshi](https://mikoshi.ectplsm.com), so you can keep Engrams in the cloud and move them across machines without turning Mikoshi into your authoring source of truth.
+
+For setup, API key configuration, persona push/pull, encrypted memory sync, and the recommended command flow, see [docs/mikoshi.md](docs/mikoshi.md).
+
 ## Configuration
 
 Relic stores its runtime defaults in `~/.relic/config.json`.
@@ -184,12 +197,6 @@ Use `relic config` to manage the default Engram, Claw path, memory window, and d
 
 For command examples and precedence rules, see [docs/configuration.md](docs/configuration.md).
 
-## TODO
-
-- [ ] Mikoshi cloud backend (`mikoshi.ectplsm.com`)
-- [ ] `relic mikoshi login` — authenticate with Mikoshi (OAuth Device Flow)
-- [ ] `relic mikoshi upload` / `relic mikoshi download` / `relic mikoshi sync` — sync Engrams with Mikoshi
-
 ## License
 
 [MIT](./LICENCE.md)

package/dist/adapters/mikoshi/client.d.ts

@@ -0,0 +1,21 @@
+import { type MikoshiClient, type MikoshiEngram, type MikoshiEngramDetail, type CreateEngramInput, type CreateEngramResponse, type SyncStatusResponse, type UpdatePersonaInput, type UpdatePersonaResponse, type UploadMemoryInput, type UploadMemoryResponse, type DownloadMemoryResponse } from "../../core/ports/mikoshi.js";
+/**
+ * MikoshiApiClient — Mikoshi REST API v1 の adapter 実装
+ *
+ * Node.js 組み込みの fetch を使い、外部依存なしで通信する。
+ * 認証は Bearer トークン (API キー)。
+ */
+export declare class MikoshiApiClient implements MikoshiClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor(baseUrl: string, apiKey: string);
+    getEngrams(): Promise<MikoshiEngram[]>;
+    getEngramBySourceId(sourceEngramId: string): Promise<MikoshiEngram | null>;
+    getEngram(engramId: string): Promise<MikoshiEngramDetail>;
+    createEngram(input: CreateEngramInput): Promise<CreateEngramResponse>;
+    getSyncStatus(engramId: string): Promise<SyncStatusResponse>;
+    updatePersona(engramId: string, input: UpdatePersonaInput): Promise<UpdatePersonaResponse>;
+    uploadMemory(engramId: string, input: UploadMemoryInput): Promise<UploadMemoryResponse>;
+    downloadMemory(engramId: string): Promise<DownloadMemoryResponse>;
+    private request;
+}

package/dist/adapters/mikoshi/client.js

@@ -0,0 +1,84 @@
+import { MikoshiApiError, MikoshiEngramSchema, MikoshiEngramDetailSchema, CreateEngramResponseSchema, SyncStatusResponseSchema, UpdatePersonaResponseSchema, UploadMemoryResponseSchema, DownloadMemoryResponseSchema, } from "../../core/ports/mikoshi.js";
+import { z } from "zod";
+/**
+ * MikoshiApiClient — Mikoshi REST API v1 の adapter 実装
+ *
+ * Node.js 組み込みの fetch を使い、外部依存なしで通信する。
+ * 認証は Bearer トークン (API キー)。
+ */
+export class MikoshiApiClient {
+    baseUrl;
+    apiKey;
+    constructor(baseUrl, apiKey) {
+        // 末尾スラッシュを統一して除去
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+        this.apiKey = apiKey;
+    }
+    // -----------------------------------------------------------------------
+    // Public API
+    // -----------------------------------------------------------------------
+    async getEngrams() {
+        const data = await this.request("GET", "/api/v1/engrams");
+        return z.array(MikoshiEngramSchema).parse(data);
+    }
+    async getEngramBySourceId(sourceEngramId) {
+        const engrams = await this.getEngrams();
+        return engrams.find((e) => e.sourceEngramId === sourceEngramId) ?? null;
+    }
+    async getEngram(engramId) {
+        const data = await this.request("GET", `/api/v1/engrams/${enc(engramId)}`);
+        return MikoshiEngramDetailSchema.parse(data);
+    }
+    async createEngram(input) {
+        const data = await this.request("POST", "/api/v1/engrams", input);
+        return CreateEngramResponseSchema.parse(data);
+    }
+    async getSyncStatus(engramId) {
+        const data = await this.request("GET", `/api/v1/engrams/${enc(engramId)}/sync-status`);
+        return SyncStatusResponseSchema.parse(data);
+    }
+    async updatePersona(engramId, input) {
+        const data = await this.request("PUT", `/api/v1/engrams/${enc(engramId)}/persona`, input);
+        return UpdatePersonaResponseSchema.parse(data);
+    }
+    async uploadMemory(engramId, input) {
+        const data = await this.request("PUT", `/api/v1/engrams/${enc(engramId)}/memory`, input);
+        return UploadMemoryResponseSchema.parse(data);
+    }
+    async downloadMemory(engramId) {
+        const data = await this.request("GET", `/api/v1/engrams/${enc(engramId)}/memory`);
+        return DownloadMemoryResponseSchema.parse(data);
+    }
+    // -----------------------------------------------------------------------
+    // Internal
+    // -----------------------------------------------------------------------
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            Accept: "application/json",
+        };
+        const init = { method, headers };
+        if (body !== undefined) {
+            headers["Content-Type"] = "application/json";
+            init.body = JSON.stringify(body);
+        }
+        const res = await fetch(url, init);
+        if (!res.ok) {
+            const text = await res.text().catch(() => "");
+            let parsed;
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch { /* ignore */ }
+            const message = parsed?.error ?? `HTTP ${res.status}`;
+            const code = parsed?.code ?? undefined;
+            throw new MikoshiApiError(res.status, code, message, parsed);
+        }
+        return res.json();
+    }
+}
+/** URL-safe path segment encoding */
+function enc(segment) {
+    return encodeURIComponent(segment);
+}

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

@@ -36,11 +36,12 @@ export class ClaudeShell {
             console.log("Hook registered to ~/.claude/settings.json");
             console.log();
         }
-        const args = [
-            "--system-prompt",
-            prompt,
-            ...(options?.extraArgs ?? []),
-        ];
+        const args = [];
+        // resume 系操作時は injection をスキップ（前回セッションに焼き付き済み）
+        if (!options?.skipInjection) {
+            args.push("--system-prompt", prompt);
+        }
+        args.push(...(options?.extraArgs ?? []));
         const env = {};
         if (options?.engramId)
             env.RELIC_ENGRAM_ID = options.engramId;

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

@@ -38,11 +38,12 @@ export class CodexShell {
             console.log("Hook registered to ~/.codex/hooks.json");
             console.log();
         }
-        const args = [
-            "-c", `developer_instructions=${JSON.stringify(wrapWithOverride(prompt))}`,
-            "-c", "features.codex_hooks=true",
-            ...(options?.extraArgs ?? []),
-        ];
+        const args = [];
+        // resume 系操作時は injection をスキップ（前回セッションに焼き付き済み）
+        if (!options?.skipInjection) {
+            args.push("-c", `developer_instructions=${JSON.stringify(wrapWithOverride(prompt))}`);
+        }
+        args.push("-c", "features.codex_hooks=true", ...(options?.extraArgs ?? []));
         const env = {};
         if (options?.engramId)
             env.RELIC_ENGRAM_ID = options.engramId;

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

@@ -106,6 +106,14 @@ export class GeminiShell {
             console.log("Hook registered to ~/.gemini/settings.json");
             console.log();
         }
+        // resume 系操作時は injection をスキップ（前回セッションに焼き付き済み）
+        if (options?.skipInjection) {
+            const env = {};
+            if (options?.engramId)
+                env.RELIC_ENGRAM_ID = options.engramId;
+            await spawnShell(this.command, [...(options?.extraArgs ?? [])], options?.cwd, Object.keys(env).length > 0 ? env : undefined);
+            return;
+        }
         // 2. デフォルトシステムプロンプトをキャッシュから読む、なければキャプチャ
         let defaultPrompt;
         if (existsSync(GEMINI_DEFAULT_CACHE)) {

package/dist/adapters/shells/resume-detect.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Resume Detection — Shell の extraArgs から resume 系操作を検出する
+ *
+ * resume 時は Engram injection をスキップし、Shell をそのまま起動する。
+ * 各 CLI の resume 引数仕様:
+ *   - Claude: --resume, -r, --continue, -c, --from-pr (options)
+ *   - Codex:  resume, fork (subcommands)
+ *   - Gemini: --resume, -r (options)
+ *
+ * 注意: Claude の -c は --continue の短縮。Codex の -c は --config の短縮。
+ */
+/**
+ * extraArgs が resume 系の操作を含むかを判定する。
+ *
+ * @param shellName - Shell の表示名 ("Claude Code", "Codex CLI", "Gemini CLI")
+ * @param extraArgs - Shell に渡される追加引数
+ * @returns resume 系操作が検出された場合 true
+ */
+export declare function isResumeArgs(shellName: string, extraArgs: string[]): boolean;

package/dist/adapters/shells/resume-detect.js

@@ -0,0 +1,51 @@
+/**
+ * Resume Detection — Shell の extraArgs から resume 系操作を検出する
+ *
+ * resume 時は Engram injection をスキップし、Shell をそのまま起動する。
+ * 各 CLI の resume 引数仕様:
+ *   - Claude: --resume, -r, --continue, -c, --from-pr (options)
+ *   - Codex:  resume, fork (subcommands)
+ *   - Gemini: --resume, -r (options)
+ *
+ * 注意: Claude の -c は --continue の短縮。Codex の -c は --config の短縮。
+ */
+/** Claude Code の resume 系オプション */
+const CLAUDE_RESUME_FLAGS = new Set([
+    "--resume",
+    "-r",
+    "--continue",
+    "-c",
+    "--from-pr",
+]);
+/** Gemini CLI の resume 系オプション */
+const GEMINI_RESUME_FLAGS = new Set([
+    "--resume",
+    "-r",
+]);
+/** Codex CLI の resume 系サブコマンド */
+const CODEX_RESUME_SUBCOMMANDS = new Set([
+    "resume",
+    "fork",
+]);
+/**
+ * extraArgs が resume 系の操作を含むかを判定する。
+ *
+ * @param shellName - Shell の表示名 ("Claude Code", "Codex CLI", "Gemini CLI")
+ * @param extraArgs - Shell に渡される追加引数
+ * @returns resume 系操作が検出された場合 true
+ */
+export function isResumeArgs(shellName, extraArgs) {
+    if (extraArgs.length === 0)
+        return false;
+    switch (shellName) {
+        case "Claude Code":
+            return extraArgs.some((arg) => CLAUDE_RESUME_FLAGS.has(arg));
+        case "Codex CLI":
+            // Codex は resume/fork がサブコマンド（先頭引数）
+            return CODEX_RESUME_SUBCOMMANDS.has(extraArgs[0]);
+        case "Gemini CLI":
+            return extraArgs.some((arg) => GEMINI_RESUME_FLAGS.has(arg));
+        default:
+            return false;
+    }
+}

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

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