@echoes-io/mcp-server 2.2.0 → 4.0.0

package/README.md

@@ -229,8 +229,8 @@ npm run lint:format
 ### Tech Stack
 
 - **Language**: TypeScript (strict mode)
-- **Testing**: Vitest (97%+ coverage)
-- **Linting**: Biome
+- **Testing**: Vitest (90.71% coverage, 82 tests)
+- **Linting**: Biome (0 warnings)
 - **Build**: TypeScript compiler
 
 ### Architecture

package/package.json

@@ -1,21 +1,27 @@
 {
   "name": "@echoes-io/mcp-server",
   "type": "module",
-  "version": "2.2.0",
+  "version": "4.0.0",
   "description": "Model Context Protocol server for AI integration with Echoes storytelling platform",
   "scripts": {
     "dev": "tsx cli/index.ts",
-    "start": "node cli/index.js",
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate",
+    "db:studio": "drizzle-kit studio",
+    "prelint": "npm run build",
     "lint": "concurrently npm:lint:* --prefixColors auto",
+    "postlint": "npm run clean",
     "lint:format": "biome check --write",
     "lint:lockfile": "lockfile-lint --path package-lock.json",
     "lint:engines": "ls-engines",
     "lint:publish": "publint --strict",
+    "pretest": "npm run clean",
     "test": "vitest run",
+    "pretest:coverage": "npm run clean",
     "test:coverage": "vitest run --coverage",
-    "check": "npm run clean && npm run test:coverage && npm run build && npm run lint && npm run clean",
+    "check": "npm run test:coverage && npm run lint",
     "prepare": "[ \"$CI\" = \"true\" ] || [ \"$GITHUB_ACTIONS\" = \"true\" ] && echo 'Skipping husky' && exit 0 || husky",
-    "clean": "rimraf --glob ./{cli,lib,test}/**/*.{d.ts,js} ./vitest*.{d.ts,js}",
+    "clean": "rimraf --glob ./{cli,src,test}/**/*.{d.ts,js} ./{drizzle,vitest}*.{d.ts,js}",
     "prebuild": "npm run clean",
     "build": "tsc",
     "release": "semantic-release"
@@ -24,11 +30,12 @@
     "echoes-mcp-server": "./cli/index.js"
   },
   "exports": {
-    ".": "./lib/server.js"
+    ".": "./src/database/index.js"
   },
   "files": [
     "cli/**/*.{d.ts,js}",
-    "lib/**/*.{d.ts,js}"
+    "lib/**/*.{d.ts,js}",
+    "src/**/*.{d.ts,js}"
   ],
   "engines": {
     "node": ">= 20.3"
@@ -67,9 +74,12 @@
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
     "@tsconfig/node22": "^22.0.5",
+    "@types/better-sqlite3": "^7.6.11",
     "@types/node": "^24.10.1",
     "@vitest/coverage-v8": "^4.0.15",
     "concurrently": "^9.2.1",
+    "drizzle-kit": "^1.0.0-beta.3-36e9b9e",
+    "fast-check": "^4.4.0",
     "husky": "^9.1.7",
     "lint-staged": "^16.2.7",
     "lockfile-lint": "^4.14.1",
@@ -82,11 +92,12 @@
     "vitest": "^4.0.15"
   },
   "dependencies": {
-    "@echoes-io/books-generator": "^1.1.0",
-    "@echoes-io/models": "^1.1.0",
-    "@echoes-io/rag": "^1.4.0",
-    "@echoes-io/tracker": "^1.1.0",
-    "@echoes-io/utils": "^1.3.1",
-    "@modelcontextprotocol/sdk": "^1.24.2"
+    "@modelcontextprotocol/sdk": "^1.24.2",
+    "better-sqlite3": "^11.0.0",
+    "drizzle-orm": "^1.0.0-beta.3-36e9b9e",
+    "gray-matter": "^4.0.3",
+    "remove-markdown": "^0.6.2",
+    "sqlite-vec": "^0.1.7-alpha.2",
+    "zod": "^4.1.12"
   }
 }

package/cli/index.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/cli/index.js

@@ -1,6 +0,0 @@
-#!/usr/bin/env node
-import { runServer } from '../lib/server.js';
-runServer().catch((error) => {
-    console.error('Server error:', error);
-    process.exit(1);
-});

package/lib/prompts/handlers.d.ts

@@ -1,21 +0,0 @@
-import type { Tracker } from '@echoes-io/tracker';
-export declare function listPrompts(): {
-    prompts: {
-        name: string;
-        description: string;
-        arguments: {
-            name: string;
-            description: string;
-            required: boolean;
-        }[];
-    }[];
-};
-export declare function getPrompt(name: string, args: Record<string, string>, timeline: string, tracker: Tracker): Promise<{
-    messages: {
-        role: "user";
-        content: {
-            type: "text";
-            text: string;
-        };
-    }[];
-}>;

package/lib/prompts/handlers.js

@@ -1,107 +0,0 @@
-import { existsSync } from 'node:fs';
-import { readFile } from 'node:fs/promises';
-import { join, resolve } from 'node:path';
-import { substitutePlaceholders } from './substitution.js';
-import { validateGitHubRepo } from './validation.js';
-const PROMPTS = [
-    {
-        name: 'new-chapter',
-        description: 'Create a new chapter for a timeline arc',
-        arguments: [
-            { name: 'arc', description: 'Arc name (e.g., "work", "anima")', required: true },
-            { name: 'chapter', description: 'Chapter number (e.g., "1", "12")', required: true },
-        ],
-    },
-    {
-        name: 'revise-chapter',
-        description: 'Revise an existing chapter with specific improvements',
-        arguments: [
-            { name: 'arc', description: 'Arc name', required: true },
-            { name: 'chapter', description: 'Chapter number', required: true },
-        ],
-    },
-    {
-        name: 'expand-chapter',
-        description: 'Expand a chapter to reach target word count',
-        arguments: [
-            { name: 'arc', description: 'Arc name', required: true },
-            { name: 'chapter', description: 'Chapter number', required: true },
-            { name: 'target', description: 'Target word count (e.g., "4000")', required: true },
-        ],
-    },
-    {
-        name: 'new-character',
-        description: 'Create a new character sheet',
-        arguments: [{ name: 'name', description: 'Character name', required: true }],
-    },
-    {
-        name: 'new-episode',
-        description: 'Create a new episode outline',
-        arguments: [
-            { name: 'arc', description: 'Arc name', required: true },
-            { name: 'episode', description: 'Episode number', required: true },
-        ],
-    },
-    {
-        name: 'new-arc',
-        description: 'Create a new story arc',
-        arguments: [{ name: 'name', description: 'Arc name (lowercase, no spaces)', required: true }],
-    },
-];
-export function listPrompts() {
-    return { prompts: PROMPTS };
-}
-export async function getPrompt(name, args, timeline, tracker) {
-    try {
-        // Validate .github repo exists
-        const { exists: githubExists, path: githubPath } = validateGitHubRepo();
-        if (!githubExists) {
-            throw new Error('.github repository not found.\n' +
-                'Clone it as sibling: git clone https://github.com/echoes-io/.github ../.github');
-        }
-        // Read base template (required)
-        const basePath = join(githubPath, `${name}.md`);
-        if (!existsSync(basePath)) {
-            throw new Error(`Prompt template not found: ${name}.md\n` +
-                `Expected location: ../.github/.kiro/prompts/${name}.md`);
-        }
-        const basePrompt = await readFile(basePath, 'utf-8');
-        // Check for timeline override (optional)
-        const timelinePromptsPath = resolve(process.cwd(), '.kiro/prompts');
-        const overridePath = join(timelinePromptsPath, `${name}.md`);
-        let overridePrompt = '';
-        if (existsSync(overridePath)) {
-            overridePrompt = await readFile(overridePath, 'utf-8');
-        }
-        // Concatenate (base first, then override)
-        const combinedPrompt = overridePrompt
-            ? `${basePrompt}\n\n---\n\n${overridePrompt}`
-            : basePrompt;
-        // Substitute placeholders
-        const finalPrompt = await substitutePlaceholders(name, combinedPrompt, args, timeline, tracker);
-        return {
-            messages: [
-                {
-                    role: 'user',
-                    content: {
-                        type: 'text',
-                        text: finalPrompt,
-                    },
-                },
-            ],
-        };
-    }
-    catch (error) {
-        return {
-            messages: [
-                {
-                    role: 'user',
-                    content: {
-                        type: 'text',
-                        text: `❌ Error loading prompt "${name}":\n\n${error instanceof Error ? error.message : 'Unknown error'}`,
-                    },
-                },
-            ],
-        };
-    }
-}

package/lib/prompts/index.d.ts

@@ -1,2 +0,0 @@
-export { getPrompt, listPrompts } from './handlers.js';
-export { validateGitHubRepo } from './validation.js';

package/lib/prompts/index.js

@@ -1,2 +0,0 @@
-export { getPrompt, listPrompts } from './handlers.js';
-export { validateGitHubRepo } from './validation.js';

package/lib/prompts/substitution.d.ts

@@ -1,2 +0,0 @@
-import type { Tracker } from '@echoes-io/tracker';
-export declare function substitutePlaceholders(promptName: string, template: string, args: Record<string, string>, timeline: string, tracker: Tracker): Promise<string>;

package/lib/prompts/substitution.js

@@ -1,45 +0,0 @@
-import { getAvailableArcs, validateArcExists, validateArcNotExists } from './validation.js';
-export async function substitutePlaceholders(promptName, template, args, timeline, tracker) {
-    const replacements = {
-        TIMELINE: timeline,
-        ...args,
-    };
-    // Prompt-specific validations
-    if (['new-chapter', 'revise-chapter', 'expand-chapter'].includes(promptName)) {
-        const { arc, chapter } = args;
-        if (!arc) {
-            throw new Error('Missing required argument: arc');
-        }
-        if (!chapter) {
-            throw new Error('Missing required argument: chapter');
-        }
-        // Validate arc exists
-        const arcExists = await validateArcExists(arc, tracker, timeline);
-        if (!arcExists) {
-            const available = await getAvailableArcs(tracker, timeline);
-            throw new Error(`Arc "${arc}" not found in tracker.\nAvailable arcs: ${available.join(', ') || 'none'}`);
-        }
-        // Validate chapter is a number
-        if (!/^\d+$/.test(chapter)) {
-            throw new Error(`Chapter must be a number, got: "${chapter}"`);
-        }
-    }
-    if (promptName === 'new-arc') {
-        const { name } = args;
-        if (!name) {
-            throw new Error('Missing required argument: name');
-        }
-        // Validate arc doesn't exist
-        const arcNotExists = await validateArcNotExists(name, tracker, timeline);
-        if (!arcNotExists) {
-            throw new Error(`Arc "${name}" already exists in tracker.`);
-        }
-    }
-    // Replace all placeholders
-    let result = template;
-    for (const [key, value] of Object.entries(replacements)) {
-        const placeholder = `{${key.toUpperCase()}}`;
-        result = result.replace(new RegExp(placeholder.replace(/[{}]/g, '\\$&'), 'g'), value);
-    }
-    return result;
-}

package/lib/prompts/validation.d.ts

@@ -1,8 +0,0 @@
-import type { Tracker } from '@echoes-io/tracker';
-export declare function validateGitHubRepo(): {
-    exists: boolean;
-    path: string;
-};
-export declare function validateArcExists(arc: string, tracker: Tracker, timeline: string): Promise<boolean>;
-export declare function validateArcNotExists(arc: string, tracker: Tracker, timeline: string): Promise<boolean>;
-export declare function getAvailableArcs(tracker: Tracker, timeline: string): Promise<string[]>;

package/lib/prompts/validation.js

@@ -1,20 +0,0 @@
-import { existsSync } from 'node:fs';
-import { resolve } from 'node:path';
-export function validateGitHubRepo() {
-    const githubPath = resolve(process.cwd(), '../.github/.kiro/prompts');
-    return {
-        exists: existsSync(githubPath),
-        path: githubPath,
-    };
-}
-export async function validateArcExists(arc, tracker, timeline) {
-    const arcs = await tracker.getArcs(timeline);
-    return arcs.some((a) => a.name === arc);
-}
-export async function validateArcNotExists(arc, tracker, timeline) {
-    return !(await validateArcExists(arc, tracker, timeline));
-}
-export async function getAvailableArcs(tracker, timeline) {
-    const arcs = await tracker.getArcs(timeline);
-    return arcs.map((a) => a.name);
-}

package/lib/server.d.ts

@@ -1,55 +0,0 @@
-import { RAGSystem } from '@echoes-io/rag';
-import { Tracker } from '@echoes-io/tracker';
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-interface TimelineContext {
-    tracker: Tracker;
-    rag: RAGSystem;
-    contentPath: string;
-}
-export declare function createServer(timelines: Map<string, TimelineContext>): Server<{
-    method: string;
-    params?: {
-        [x: string]: unknown;
-        task?: {
-            [x: string]: unknown;
-            ttl?: number | null | undefined;
-            pollInterval?: number | undefined;
-        } | undefined;
-        _meta?: {
-            [x: string]: unknown;
-            progressToken?: string | number | undefined;
-            "io.modelcontextprotocol/related-task"?: {
-                [x: string]: unknown;
-                taskId: string;
-            } | undefined;
-        } | undefined;
-    } | undefined;
-}, {
-    method: string;
-    params?: {
-        [x: string]: unknown;
-        _meta?: {
-            [x: string]: unknown;
-            "io.modelcontextprotocol/related-task"?: {
-                [x: string]: unknown;
-                taskId: string;
-            } | undefined;
-        } | undefined;
-    } | undefined;
-}, {
-    [x: string]: unknown;
-    _meta?: {
-        [x: string]: unknown;
-        "io.modelcontextprotocol/related-task"?: {
-            [x: string]: unknown;
-            taskId: string;
-        } | undefined;
-    } | undefined;
-}>;
-interface TimelineContext {
-    tracker: Tracker;
-    rag: RAGSystem;
-    contentPath: string;
-}
-export declare function runServer(): Promise<void>;
-export {};