EDITION Intelligence Platform

The missing infrastructure for AI agents operating in Japan.

Memory API + Regulation Check API + Procedural Knowledge + MCP Server — purpose-built for Japanese business context.

The Problem

AI agents working with Japanese businesses hit walls that generic tools can't solve:

Keigo (敬語): A sentence like "ワインをお持ちすれば喜ばれるかと存じます" hides the subject, uses layered honorifics, and expresses uncertainty — generic NLP treats this as noise
Implicit agreements: Japanese business communication rarely states things directly
Regulatory maze: 10+ industries with overlapping national/prefectural regulations, most documentation only in Japanese
No persistent context: Agents forget everything between sessions

What This Does

1. Memory API — Japanese-aware persistent memory

Store episodes, auto-extract structured facts with keigo analysis, social hierarchy detection, and confidence scoring.

Input:  "佐藤部長にはワインをお持ちすれば喜ばれるかと存じます"

Output:
  Subject:    佐藤 (役職: 部長)
  Predicate:  好む
  Object:     ワイン
  Keigo:      Level 2 (尊敬語)
  Hierarchy:  superior
  Confidence: 0.7 (推測 — not stated as fact)
  Tense:      present

Three-layer architecture:

Episodes — raw conversation logs
Facts — structured knowledge (auto-extracted via LLM)
Context — summarized state per entity/topic

2. Regulation API — 10 industries + tourist rules

Pre-built regulatory database covering:

EC sites, Real estate, Staffing, Food service, Construction
Healthcare, Finance, Transport, Education, Accommodation
Tourist categories: Visa, Tax-free, Transit, Medical, Manners

All 10 industries include step-by-step procedural guides (65 total steps) — covering what to do, how, where, required documents, costs, timelines, and common pitfalls.

curl -X POST /api/v1/regulation/check \
  -d '{"industry": "food_service", "query": "What licenses do I need to open a restaurant in Tokyo?"}'

3. MCP Server — 8 tools for Claude, Cursor, etc.

Tool	Description
`memory_store`	Store episode + auto-extract facts
`memory_recall`	Semantic search across episodes
`memory_facts`	List structured facts
`memory_context`	Get context summary
`memory_extract`	Extract facts from text
`regulation_check`	Check regulations by industry
`regulation_industries`	List covered industries
`regulation_tourist`	Tourist regulation lookup

Quick Start

Backend

git clone https://github.com/hiroshic9-png/edition.git
cd edition
python3 -m venv venv && source venv/bin/activate
pip install fastapi 'uvicorn[standard]' pydantic sqlalchemy aiosqlite chromadb python-dotenv google-genai

# Set your LLM key (any one of these)
echo 'GEMINI_API_KEY=your_key' > .env
# or ANTHROPIC_API_KEY or OPENAI_API_KEY

python -m uvicorn backend.api.main:app --reload
# → http://localhost:8000/docs

MCP Server (for Claude Desktop / Cursor)

cd mcp-server && npm install && npm run build && npm start

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "edition": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "EDITION_API_URL": "http://localhost:8000",
        "EDITION_API_KEY": "your_api_key"
      }
    }
  }
}

API Endpoints

Memory

Method	Endpoint	Description
POST	`/api/v1/memory/episodes`	Store episode (set `auto_extract=true` for auto fact extraction)
POST	`/api/v1/memory/episodes/search`	Semantic search
POST	`/api/v1/memory/facts`	Add fact
GET	`/api/v1/memory/facts`	List facts
GET	`/api/v1/memory/context`	Context summary
POST	`/api/v1/memory/extract`	Extract facts from text

Regulation

Method	Endpoint	Description
POST	`/api/v1/regulation/check`	Check regulations (10 industries + LLM RAG)
GET	`/api/v1/regulation/industries`	List industries
GET	`/api/v1/regulation/tourist`	Tourist categories

Tech Stack

Layer	Technology
API	FastAPI (Python)
Memory Store	SQLite + ChromaDB (vector search)
MCP	TypeScript SDK v1.29
LLM	Gemini / Claude / GPT (fact extraction + RAG)

Why Not Mem0 / Letta / Zep?

Those are excellent general-purpose memory tools. But they don't:

Parse Japanese keigo levels (丁寧語 / 尊敬語 / 謙譲語)
Detect implicit social hierarchy from honorific patterns
Score confidence based on Japanese speech patterns (断定 vs 推測 vs 伝聞)
Include a Japanese regulatory database

This project exists because Japanese business context is structurally different, and agents need purpose-built infrastructure to navigate it.

License

MIT

edition-api

Quick Install