@ectplsm/relic 0.3.2 → 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/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";