edition-mcp-server 0.3.0 → 0.3.2

package/dist/index.js

@@ -172,7 +172,7 @@ async function apiPost(path, body) {
 // ── MCP Server ──────────────────────────────────────
 const server = new mcp_js_1.McpServer({
     name: "edition",
-    version: "0.3.0",
+    version: "0.3.2",
 }, {
     instructions: PROGRESSIVE
         ? "EDITION is a Japan Knowledge Gateway for AI agents. Use japan_discover to explore 14 knowledge domains, japan_search for cross-domain queries, and japan_execute for specific domain operations. This server uses Progressive Discovery — only load domain details when needed."
@@ -321,7 +321,7 @@ else {
         return { content: [{ type: "text", text }] };
     });
     // ── Tool: memory_context ────────────────────────────
-    server.tool("memory_context", "現在のセッション状態（有効な事実・合意事項のサマリー）を取得します。エージェントのプロンプトに注入して文脈を維持するために使います。", {
+    server.tool("memory_context", "現在のセッション状態（有効な事実・合意事項のサマリー）を取得します。エージェントのプロンプトに注入して文脈を維持するために使います。新しい会話セッション開始時や、長い会話の途中で文脈を再確認したい場合に呼び出してください。個別のファクトを一覧で見たい場合はmemory_factsを使ってください。", {
         session_id: zod_1.z.string().optional().describe("セッションID（省略で全体）"),
     }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async ({ session_id }) => {
         const params = session_id ? `?session_id=${encodeURIComponent(session_id)}` : "";
@@ -404,7 +404,7 @@ else {
         return { content: [{ type: "text", text }] };
     });
     // ── Tool: regulation_industries ──────────────────────
-    server.tool("regulation_industries", "日本の規制データベースに登録されている業種の一覧を取得します。", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async () => {
+    server.tool("regulation_industries", "日本の規制データベースに登録されている業種の一覧を取得します。対応業種を確認したい場合や、regulation_checkに渡すindustryパラメータの値を調べたい場合に使ってください。特定の規制内容を知りたい場合はregulation_checkを使ってください。", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async () => {
         const result = await apiGet("/api/v1/regulation/industries");
         let text = `🗾 対応業種一覧 (${result.count}業種):\n\n`;
         for (const ind of result.industries) {
@@ -416,7 +416,7 @@ else {
         return { content: [{ type: "text", text }] };
     });
     // ── Tool: regulation_tourist ────────────────────────
-    server.tool("regulation_tourist", "訪日旅行者向けの規制・マナー情報のカテゴリ一覧を取得します。ビザ、免税、交通、宿泊、医療、マナーの6カテゴリ。", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async () => {
+    server.tool("regulation_tourist", "訪日旅行者向けの規制・マナー情報のカテゴリ一覧を取得します。ビザ、免税、交通、宿泊、医療、マナーの6カテゴリ。どのカテゴリがあるか一覧で確認したい場合に使ってください。特定のカテゴリの詳細を知りたい場合はregulation_check（entity_type='tourist'）を使ってください。", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async () => {
         const result = await apiGet("/api/v1/regulation/tourist");
         let text = `🗾 訪日旅行者向け規制カテゴリ (${result.count}件):\n\n`;
         for (const cat of result.categories) {
@@ -688,7 +688,7 @@ else {
         return { content: [{ type: "text", text }] };
     });
     // ── Tool: search ────────────────────────────────────
-    server.tool("search", "EDITION全14ドメインを横断検索します。1回のリクエストで規制・プロトコル・カレンダー・地域・組織・進出手続き・旅行・エンタメ・日常生活・日本語・食文化・災害安全の全12ドメインを同時検索。", {
+    server.tool("search", "EDITION全14ドメインを横断検索します。1回のリクエストで規制・プロトコル・カレンダー・地域・組織・進出手続き・旅行・エンタメ・日常生活・日本語・食文化・災害安全・メモリの全14ドメインを同時検索します。日本に関する幅広い質問で、どのドメインに該当するかわからない場合にまずこのツールを使ってください。特定ドメインの詳細が必要な場合は、各ドメイン専用の_checkまたは_searchツールを使ってください。", {
         query: zod_1.z.string().describe("検索クエリ（例: '大阪で飲食店を開業', '地震の避難方法', '敬語の使い方'）"),
     }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async ({ query }) => {
         const result = await apiPost("/api/v1/search", { query });
@@ -764,6 +764,104 @@ else {
         }
     });
 } // end of legacy mode else block
+const auditLog = [];
+let auditCounter = 0;
+function recordAudit(entry) {
+    const record = {
+        id: `AUDIT-${++auditCounter}-${Date.now()}`,
+        timestamp: new Date().toISOString(),
+        ...entry,
+    };
+    auditLog.push(record);
+    return record;
+}
+// Tool: compliance_log — Record a compliance check with audit trail
+server.tool("compliance_log", "Record a Japan regulatory/compliance check with full audit trail. Use this AFTER performing a regulation_check, foreign_entry_check, or any compliance-sensitive query. Creates an immutable, timestamped record for governance reporting. Agents operating under compliance requirements should call this after every regulatory lookup.", {
+    domain: zod_1.z.string().describe("Knowledge domain checked (e.g. 'regulation', 'foreign_entry', 'protocol')"),
+    action: zod_1.z.string().describe("Action that was checked (e.g. 'open restaurant in Tokyo', 'apply for management visa')"),
+    query: zod_1.z.string().describe("The original query/action that triggered the compliance check"),
+    result_summary: zod_1.z.string().describe("Summary of the compliance check result"),
+    confidence: zod_1.z.number().min(0).max(1).describe("Confidence score of the check (0-1)"),
+    compliant: zod_1.z.boolean().describe("Whether the action was found to be compliant"),
+    context: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional().describe("Additional context (industry, entity_type, jurisdiction, etc.)"),
+}, { readOnlyHint: false, destructiveHint: false, idempotentHint: false }, async ({ domain, action, query, result_summary, confidence, compliant, context }) => {
+    const record = recordAudit({
+        domain,
+        action,
+        query,
+        result_summary,
+        confidence,
+        compliant,
+        metadata: {
+            ...context,
+            server_version: "0.3.1",
+            mode: PROGRESSIVE ? "progressive" : "legacy",
+        },
+    });
+    let text = `📋 Compliance Audit Record Created\n`;
+    text += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
+    text += `  ID: ${record.id}\n`;
+    text += `  Timestamp: ${record.timestamp}\n`;
+    text += `  Domain: ${record.domain}\n`;
+    text += `  Action: ${record.action}\n`;
+    text += `  Status: ${record.compliant ? "✅ COMPLIANT" : "⚠️ NON-COMPLIANT / REQUIRES REVIEW"}\n`;
+    text += `  Confidence: ${(record.confidence * 100).toFixed(0)}%\n`;
+    text += `  Summary: ${record.result_summary}\n`;
+    text += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
+    text += `\nTotal audit records this session: ${auditLog.length}`;
+    return { content: [{ type: "text", text }] };
+});
+// Tool: compliance_report — Generate governance report from audit trail
+server.tool("compliance_report", "Generate a structured compliance/governance report from accumulated audit records. Returns all logged compliance checks with statistics. Use for periodic compliance reviews, audit preparation, or governance dashboards. Supports filtering by domain, date range, or compliance status.", {
+    domain: zod_1.z.string().optional().describe("Filter by domain (e.g. 'regulation'). Omit for all domains."),
+    compliant_only: zod_1.z.boolean().optional().describe("If true, show only compliant records. If false, show only non-compliant. Omit for all."),
+    format: zod_1.z.enum(["summary", "detailed", "json"]).default("summary").describe("Report format: summary (overview + stats), detailed (all records), json (machine-readable)"),
+}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async ({ domain, compliant_only, format }) => {
+    let records = [...auditLog];
+    if (domain)
+        records = records.filter(r => r.domain === domain);
+    if (compliant_only !== undefined)
+        records = records.filter(r => r.compliant === compliant_only);
+    if (records.length === 0) {
+        return { content: [{ type: "text", text: "📊 No compliance records found for the specified criteria.\n\n💡 Use compliance_log after regulatory checks to build your audit trail." }] };
+    }
+    if (format === "json") {
+        return { content: [{ type: "text", text: JSON.stringify({ total: records.length, records }, null, 2) }] };
+    }
+    // Statistics
+    const total = records.length;
+    const compliant = records.filter(r => r.compliant).length;
+    const nonCompliant = total - compliant;
+    const avgConfidence = records.reduce((sum, r) => sum + r.confidence, 0) / total;
+    const domains = [...new Set(records.map(r => r.domain))];
+    const timeRange = records.length > 0
+        ? `${records[0].timestamp} → ${records[records.length - 1].timestamp}`
+        : "N/A";
+    let text = `\n📊 EDITION Compliance Governance Report\n`;
+    text += `══════════════════════════════════════\n\n`;
+    text += `📅 Period: ${timeRange}\n`;
+    text += `📈 Total Checks: ${total}\n`;
+    text += `  ✅ Compliant: ${compliant} (${((compliant / total) * 100).toFixed(1)}%)\n`;
+    text += `  ⚠️  Review Needed: ${nonCompliant} (${((nonCompliant / total) * 100).toFixed(1)}%)\n`;
+    text += `  📊 Average Confidence: ${(avgConfidence * 100).toFixed(1)}%\n`;
+    text += `  🗂️  Domains Covered: ${domains.join(", ")}\n`;
+    text += `\n══════════════════════════════════════\n`;
+    if (format === "detailed") {
+        text += `\n📋 Detailed Records:\n\n`;
+        for (const r of records) {
+            text += `  ─── ${r.id} ───\n`;
+            text += `  Time: ${r.timestamp}\n`;
+            text += `  Domain: ${r.domain} | Action: ${r.action}\n`;
+            text += `  Query: ${r.query}\n`;
+            text += `  Result: ${r.result_summary}\n`;
+            text += `  Status: ${r.compliant ? "✅ COMPLIANT" : "⚠️ REVIEW"} | Confidence: ${(r.confidence * 100).toFixed(0)}%\n\n`;
+        }
+    }
+    text += `\n⚠️ Disclaimer: This report is generated from EDITION audit records. `;
+    text += `It serves as a structured reference for governance reviews but does not constitute legal certification.`;
+    text += `\n📌 Data source: EDITION Intelligence Platform (api.edition.sh) — Verified Japan regulatory knowledge.`;
+    return { content: [{ type: "text", text }] };
+});
 // ── Start ───────────────────────────────────────────
 async function main() {
     const transport = new stdio_js_1.StdioServerTransport();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "edition-mcp-server",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "mcpName": "io.github.hiroshic9-png/japan-business-operations",
   "description": "EDITION — Japan Knowledge Gateway for AI agents. 14 knowledge domains, 6 Skills Packs, 31 MCP tools, Progressive Discovery support. Verified ground truth: regulations, procedures, protocols, calendar, regional, organization, foreign entry, travel, entertainment, daily life, language, food culture, disaster safety, and persistent memory.",
   "main": "dist/index.js",