@epiccontext/mcp 0.1.0

package/dist/mcp/tools/update-block.js

@@ -0,0 +1,90 @@
+export const updateBlockTool = {
+    name: "update_block",
+    description: "Update an existing block's content or status.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            key: {
+                type: "string",
+                description: "The unique key of the block to update",
+            },
+            value: {
+                type: "object",
+                description: "The new content value for the block",
+            },
+            status: {
+                type: "string",
+                enum: ["empty", "draft", "complete"],
+                description: "The new status for the block",
+            },
+            name: {
+                type: "string",
+                description: "The display name for the block",
+            },
+        },
+        required: ["key"],
+    },
+};
+export async function handleUpdateBlock(config, args) {
+    const key = args.key;
+    const value = args.value;
+    const status = args.status;
+    const name = args.name;
+    if (!key) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Error: Block key is required.",
+                },
+            ],
+        };
+    }
+    if (!value && !status && !name) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Error: At least one of value, status, or name must be provided.",
+                },
+            ],
+        };
+    }
+    try {
+        const updates = {};
+        if (value !== undefined)
+            updates.value = value;
+        if (status !== undefined)
+            updates.status = status;
+        if (name !== undefined)
+            updates.name = name;
+        await config.client.updateBlock(key, updates);
+        let output = `Block updated successfully: ${key}\n\n`;
+        output += "Updated fields:\n";
+        if (value !== undefined)
+            output += "- value\n";
+        if (status !== undefined)
+            output += `- status: ${status}\n`;
+        if (name !== undefined)
+            output += `- name: ${name}\n`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: output,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error updating block: ${error.message}`,
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=update-block.js.map

package/dist/mcp/tools/update-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-block.js","sourceRoot":"","sources":["../../../src/mcp/tools/update-block.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,+CAA+C;IAC5D,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;aACrD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qCAAqC;aACnD;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC;gBACpC,WAAW,EAAE,8BAA8B;aAC5C;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gCAAgC;aAC9C;SACF;QACD,QAAQ,EAAE,CAAC,KAAK,CAAC;KAClB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAuB,EACvB,IAA6B;IAE7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAa,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAA4C,CAAC;IAChE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAoD,CAAC;IACzE,MAAM,IAAI,GAAG,IAAI,CAAC,IAA0B,CAAC;IAE7C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,+BAA+B;iBACtC;aACF;SACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/B,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,iEAAiE;iBACxE;aACF;SACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAIT,EAAE,CAAC;QAEP,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;QAC/C,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;QAClD,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QAE5C,MAAM,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAE9C,IAAI,MAAM,GAAG,+BAA+B,GAAG,MAAM,CAAC;QACtD,MAAM,IAAI,mBAAmB,CAAC;QAC9B,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,WAAW,CAAC;QAC/C,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,IAAI,aAAa,MAAM,IAAI,CAAC;QAC5D,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,WAAW,IAAI,IAAI,CAAC;QAEtD,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM;iBACb;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,yBAA0B,KAAe,CAAC,OAAO,EAAE;iBAC1D;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/sync/pull.d.ts

@@ -0,0 +1,16 @@
+import { EpicContextClient } from "../api/client.js";
+export interface PullOptions {
+    force?: boolean;
+    section?: string;
+}
+export interface PullResult {
+    success: boolean;
+    filesWritten: number;
+    filesSkipped: number;
+    totalFiles: number;
+}
+/**
+ * Pull from cloud to local CONTEXT folder
+ */
+export declare function pullFromCloud(client: EpicContextClient, contextPath: string, options?: PullOptions): Promise<PullResult>;
+//# sourceMappingURL=pull.d.ts.map

package/dist/sync/pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/sync/pull.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,iBAAiB,EACzB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAiCrB"}

package/dist/sync/pull.js

@@ -0,0 +1,32 @@
+import { writeContextFolder, ensureContextFolder } from "../cli/files.js";
+/**
+ * Pull from cloud to local CONTEXT folder
+ */
+export async function pullFromCloud(client, contextPath, options = {}) {
+    // Ensure context folder exists
+    ensureContextFolder(contextPath);
+    // Export files from cloud
+    const response = await client.exportFiles();
+    if (!response.files || response.files.length === 0) {
+        return {
+            success: true,
+            filesWritten: 0,
+            filesSkipped: 0,
+            totalFiles: 0,
+        };
+    }
+    // Filter by section if specified
+    let filesToWrite = response.files;
+    if (options.section) {
+        filesToWrite = response.files.filter((f) => f.path.startsWith(options.section));
+    }
+    // Write files to local folder
+    const { written, skipped } = writeContextFolder(contextPath, filesToWrite);
+    return {
+        success: true,
+        filesWritten: written,
+        filesSkipped: skipped,
+        totalFiles: filesToWrite.length,
+    };
+}
+//# sourceMappingURL=pull.js.map

package/dist/sync/pull.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.js","sourceRoot":"","sources":["../../src/sync/pull.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAc1E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAyB,EACzB,WAAmB,EACnB,UAAuB,EAAE;IAEzB,+BAA+B;IAC/B,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAEjC,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;IAE5C,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,YAAY,EAAE,CAAC;YACf,YAAY,EAAE,CAAC;YACf,UAAU,EAAE,CAAC;SACd,CAAC;IACJ,CAAC;IAED,iCAAiC;IACjC,IAAI,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC;IAClC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACzC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,OAAQ,CAAC,CACpC,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,kBAAkB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAE3E,OAAO;QACL,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,OAAO;QACrB,YAAY,EAAE,OAAO;QACrB,UAAU,EAAE,YAAY,CAAC,MAAM;KAChC,CAAC;AACJ,CAAC"}

package/dist/sync/push.d.ts

@@ -0,0 +1,18 @@
+import { EpicContextClient } from "../api/client.js";
+import type { SyncResult } from "../types/index.js";
+export interface PushOptions {
+    dryRun?: boolean;
+    conflictResolution?: "timestamp" | "folder_wins";
+    path?: string;
+}
+export interface PushResult {
+    success: boolean;
+    dryRun: boolean;
+    filesProcessed: number;
+    result: SyncResult;
+}
+/**
+ * Push local CONTEXT folder to cloud
+ */
+export declare function pushToCloud(client: EpicContextClient, contextPath: string, options?: PushOptions): Promise<PushResult>;
+//# sourceMappingURL=push.d.ts.map

package/dist/sync/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../src/sync/push.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kBAAkB,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,iBAAiB,EACzB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAuCrB"}

package/dist/sync/push.js

@@ -0,0 +1,39 @@
+import { readContextFolder } from "../cli/files.js";
+/**
+ * Push local CONTEXT folder to cloud
+ */
+export async function pushToCloud(client, contextPath, options = {}) {
+    // Read all local files
+    const files = readContextFolder(contextPath);
+    if (files.length === 0) {
+        return {
+            success: true,
+            dryRun: options.dryRun ?? false,
+            filesProcessed: 0,
+            result: {
+                created: 0,
+                updated: 0,
+                skipped: 0,
+                conflicts: [],
+                errors: [],
+            },
+        };
+    }
+    // Filter by path if specified
+    let filesToSync = files;
+    if (options.path) {
+        filesToSync = files.filter((f) => f.path.startsWith(options.path));
+    }
+    // Import to cloud
+    const response = await client.importFiles(filesToSync, {
+        dryRun: options.dryRun,
+        conflictResolution: options.conflictResolution ?? "folder_wins",
+    });
+    return {
+        success: response.success,
+        dryRun: response.dryRun,
+        filesProcessed: filesToSync.length,
+        result: response.result,
+    };
+}
+//# sourceMappingURL=push.js.map

package/dist/sync/push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.js","sourceRoot":"","sources":["../../src/sync/push.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAgBpD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAyB,EACzB,WAAmB,EACnB,UAAuB,EAAE;IAEzB,uBAAuB;IACvB,MAAM,KAAK,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAE7C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;YAC/B,cAAc,EAAE,CAAC;YACjB,MAAM,EAAE;gBACN,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;gBACV,SAAS,EAAE,EAAE;gBACb,MAAM,EAAE,EAAE;aACX;SACF,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/B,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAK,CAAC,CACjC,CAAC;IACJ,CAAC;IAED,kBAAkB;IAClB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE;QACrD,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,aAAa;KAChE,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,cAAc,EAAE,WAAW,CAAC,MAAM;QAClC,MAAM,EAAE,QAAQ,CAAC,MAAM;KACxB,CAAC;AACJ,CAAC"}

package/dist/sync/watcher.d.ts

@@ -0,0 +1,51 @@
+import type { EpicContextClient } from "../api/client.js";
+export interface WatcherConfig {
+    contextPath: string;
+    debounce: number;
+    ignoredPatterns: string[];
+    pushOnly: boolean;
+    onSync?: (result: {
+        files: number;
+        created: number;
+        updated: number;
+    }) => void;
+    onError?: (error: Error) => void;
+    onChange?: (event: string, path: string) => void;
+}
+/**
+ * File watcher for auto-syncing CONTEXT folder changes
+ */
+export declare class FileWatcher {
+    private client;
+    private config;
+    private watcher;
+    private pendingChanges;
+    private syncTimeout;
+    private isSyncing;
+    constructor(client: EpicContextClient, config: WatcherConfig);
+    /**
+     * Start watching for file changes
+     */
+    start(): void;
+    /**
+     * Stop watching
+     */
+    stop(): void;
+    /**
+     * Handle a file change event
+     */
+    private handleChange;
+    /**
+     * Schedule a sync after debounce period
+     */
+    private scheduleSync;
+    /**
+     * Process all pending changes
+     */
+    private processPendingChanges;
+}
+/**
+ * Create and start a file watcher
+ */
+export declare function createWatcher(client: EpicContextClient, config: WatcherConfig): FileWatcher;
+//# sourceMappingURL=watcher.d.ts.map

package/dist/sync/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/sync/watcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD;AAED;;GAEG;AACH,qBAAa,WAAW;IAOpB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;IAPhB,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,SAAS,CAAS;gBAGhB,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,aAAa;IAG/B;;OAEG;IACH,KAAK,IAAI,IAAI;IAqBb;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACH,OAAO,CAAC,YAAY;IAiBpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;YACW,qBAAqB;CAyBpC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,aAAa,GACpB,WAAW,CAIb"}

package/dist/sync/watcher.js

@@ -0,0 +1,114 @@
+import chokidar from "chokidar";
+import { pushToCloud } from "./push.js";
+/**
+ * File watcher for auto-syncing CONTEXT folder changes
+ */
+export class FileWatcher {
+    client;
+    config;
+    watcher = null;
+    pendingChanges = new Set();
+    syncTimeout = null;
+    isSyncing = false;
+    constructor(client, config) {
+        this.client = client;
+        this.config = config;
+    }
+    /**
+     * Start watching for file changes
+     */
+    start() {
+        this.watcher = chokidar.watch(this.config.contextPath, {
+            ignored: [
+                /(^|[\/\\])\../, // dotfiles
+                /node_modules/,
+                ...this.config.ignoredPatterns.map((p) => new RegExp(p)),
+            ],
+            persistent: true,
+            ignoreInitial: true,
+            awaitWriteFinish: {
+                stabilityThreshold: 1000,
+                pollInterval: 100,
+            },
+        });
+        this.watcher
+            .on("add", (filePath) => this.handleChange("add", filePath))
+            .on("change", (filePath) => this.handleChange("change", filePath))
+            .on("unlink", (filePath) => this.handleChange("unlink", filePath));
+    }
+    /**
+     * Stop watching
+     */
+    stop() {
+        if (this.syncTimeout) {
+            clearTimeout(this.syncTimeout);
+            this.syncTimeout = null;
+        }
+        this.watcher?.close();
+        this.watcher = null;
+    }
+    /**
+     * Handle a file change event
+     */
+    handleChange(event, path) {
+        // Only watch markdown files
+        if (!path.endsWith(".md")) {
+            return;
+        }
+        // Skip README and AI-GUIDE
+        const filename = path.split("/").pop()?.toLowerCase();
+        if (filename === "readme.md" || filename === "ai-guide.md") {
+            return;
+        }
+        this.config.onChange?.(event, path);
+        this.pendingChanges.add(path);
+        this.scheduleSync();
+    }
+    /**
+     * Schedule a sync after debounce period
+     */
+    scheduleSync() {
+        if (this.syncTimeout) {
+            clearTimeout(this.syncTimeout);
+        }
+        this.syncTimeout = setTimeout(() => {
+            this.processPendingChanges();
+        }, this.config.debounce);
+    }
+    /**
+     * Process all pending changes
+     */
+    async processPendingChanges() {
+        if (this.isSyncing || this.pendingChanges.size === 0) {
+            return;
+        }
+        this.isSyncing = true;
+        const changes = Array.from(this.pendingChanges);
+        this.pendingChanges.clear();
+        try {
+            const result = await pushToCloud(this.client, this.config.contextPath, {
+                conflictResolution: "folder_wins",
+            });
+            this.config.onSync?.({
+                files: changes.length,
+                created: result.result.created,
+                updated: result.result.updated,
+            });
+        }
+        catch (error) {
+            this.config.onError?.(error);
+        }
+        finally {
+            this.isSyncing = false;
+        }
+    }
+}
+/**
+ * Create and start a file watcher
+ */
+export function createWatcher(client, config) {
+    const watcher = new FileWatcher(client, config);
+    watcher.start();
+    return watcher;
+}
+//# sourceMappingURL=watcher.js.map

package/dist/sync/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../src/sync/watcher.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Configuration stored in .epiccontext file
+ */
+export interface EpicContextConfig {
+    version: number;
+    project: {
+        id: string;
+        url: string;
+        name: string;
+        slug: string;
+    };
+    auth: {
+        apiKey: string;
+    };
+    sync: {
+        path: string;
+        conflictResolution: ConflictResolution;
+        autoSync: boolean;
+        ignoredPatterns: string[];
+    };
+    watch: {
+        debounce: number;
+        pushOnly: boolean;
+    };
+}
+export type ConflictResolution = "timestamp" | "local_wins" | "remote_wins" | "ask";
+/**
+ * File info for sync operations
+ */
+export interface FileInfo {
+    path: string;
+    content: string;
+}
+/**
+ * Block from the EpicContext API
+ */
+export interface Block {
+    id: string;
+    section_id: string;
+    type: string;
+    key: string;
+    name?: string;
+    value: Record<string, unknown>;
+    status: "empty" | "draft" | "complete";
+    sort_order: number;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Section info
+ */
+export interface SectionInfo {
+    type: string;
+    name: string;
+}
+/**
+ * Block with section info
+ */
+export interface BlockWithSection extends Block {
+    section: SectionInfo;
+    section_type?: string;
+}
+/**
+ * Sync result from import operation
+ */
+export interface SyncResult {
+    created: number;
+    updated: number;
+    skipped: number;
+    conflicts: ConflictRecord[];
+    errors: ImportError[];
+}
+export interface ConflictRecord {
+    path: string;
+    key: string;
+    localModified: string;
+    remoteModified: string;
+    resolution?: string;
+}
+export interface ImportError {
+    path: string;
+    error: string;
+}
+/**
+ * Sync status
+ */
+export interface SyncStatus {
+    connected: boolean;
+    projectId: string;
+    projectName: string;
+    projectSlug: string;
+    lastSyncAt: string | null;
+    lastSyncDirection: "import" | "export" | null;
+    localChanges: number;
+    remoteChanges: number;
+    conflicts: number;
+}
+/**
+ * Export response
+ */
+export interface ExportResponse {
+    project: {
+        id: string;
+        name: string;
+        slug: string;
+    };
+    files: FileInfo[];
+    totalFiles: number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@epiccontext/mcp",
+  "version": "0.1.0",
+  "description": "MCP server and CLI for syncing EpicContext documentation with local codebases",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "epicontext": "./dist/bin/epicontext.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "lint": "eslint src",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "epiccontext",
+    "documentation",
+    "sync",
+    "ai",
+    "claude",
+    "cursor"
+  ],
+  "author": "EpicContext",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lijbers-com/EpicContext.git",
+    "directory": "packages/epiccontext-mcp"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "chalk": "^5.3.0",
+    "chokidar": "^4.0.3",
+    "commander": "^12.1.0",
+    "conf": "^13.0.1",
+    "gray-matter": "^4.0.3",
+    "inquirer": "^12.2.0",
+    "ora": "^8.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}