@epiccontext/mcp 0.1.56 → 0.1.57

package/dist/skills/generator.js

@@ -74,6 +74,12 @@ const SECTION_CONFIGS = {
         folder: "metrics",
         blockTypes: ["metric", "analytics_event", "north_star", "kpi"],
     },
+    performance: {
+        name: "Performance Expert",
+        description: "Reviews performance metrics for clarity and actionability. Helps read charts, set insights, and analyze KPI trends",
+        folder: "performance",
+        blockTypes: ["metric", "analytics_event", "north_star", "kpi"],
+    },
     decisions: {
         name: "Decision Recorder",
         description: "Ensures decisions are properly documented with context and rationale",
@@ -177,6 +183,13 @@ Example:
 - This addresses: [link to existing content]
 \`\`\`
 
+## Context Staleness Check
+
+When this section's blocks are referenced in code changes, verify they're still accurate.
+If you implemented something that relates to blocks in CONTEXT/${config.folder}/:
+- Update block status if work is complete
+- Flag any content that no longer matches the implementation
+
 ## Anti-Patterns to Avoid
 
 - Creating content without reading existing CONTEXT
@@ -184,6 +197,7 @@ Example:
 - Not linking to related sections
 - Using placeholder text (TBD, TODO, Lorem ipsum)
 - Using wrong block types for the content
+- Leaving block status as "draft" after implementation is complete
 `;
 }
 /**
@@ -205,12 +219,23 @@ allowed-tools: Read, Grep, Glob
 This project uses EpicContext for structured product documentation.
 The CONTEXT/ folder is the single source of truth.
 
+## Project Structure
+
+\`\`\`
+./
+├── CONTEXT/       Documentation blocks (syncs with EpicContext cloud)
+├── DOCUMENTS/     Reference files: PDFs, images, research (syncs with cloud)
+├── apps/          Code repositories (git repos)
+└── .epicontext    Project configuration
+\`\`\`
+
 ## Critical Rules
 
 1. **ALWAYS read CONTEXT first** - Before any development task, check relevant sections
 2. **Traceability required** - All code must trace to documented requirements
 3. **One block per file** - Never combine multiple items
 4. **Use correct block types** - See CONTEXT/AI-GUIDE.md
+5. **Update CONTEXT after implementation** - Keep documentation in sync with code
 
 ## Quick Navigation
 
@@ -222,20 +247,42 @@ The CONTEXT/ folder is the single source of truth.
 | How to build | CONTEXT/technical/ |
 | Past decisions | CONTEXT/decisions/ |
 | Visual design | CONTEXT/design-system/ and CONTEXT/brand/ |
+| Reference docs | DOCUMENTS/ |
 
 ## Before Starting Work
 
 1. Read \`CONTEXT/AI-GUIDE.md\` for block schemas
 2. Check relevant sections for your task
-3. Cite sources in your output
-4. Update CONTEXT if you make decisions
+3. Browse \`DOCUMENTS/\` for reference materials
+4. Cite sources in your output
+
+## AFTER Implementation — Context Update Triggers
+
+**You MUST update CONTEXT when your work changes the product.**
+
+| What You Did | Required Context Update |
+|-------------|------------------------|
+| Implemented a feature | Set feature block \`status: complete\` |
+| Made a technical decision | Create a \`decision\` block in \`decisions/\` |
+| Added an API endpoint | Create an \`api_endpoint\` block in \`technical/api/\` |
+| Completed a task | Set task block \`status: complete\` |
+| Changed data models | Update \`data_model\` blocks in \`technical/models/\` |
+| Added a new integration | Create an \`integration\` block in \`technical/integrations/\` |
+| Discovered a constraint | Create a \`constraint\` block |
+
+After updating CONTEXT, push changes:
+\`\`\`bash
+npx @epiccontext/mcp push
+\`\`\`
 
 ## Sync Commands
 
 \`\`\`bash
-npx @epiccontext/mcp push    # Push changes to cloud
-npx @epiccontext/mcp pull    # Pull from cloud
-npx @epiccontext/mcp status  # Check sync status
+npx @epiccontext/mcp push                  # Push CONTEXT to cloud
+npx @epiccontext/mcp pull                  # Pull CONTEXT from cloud
+npx @epiccontext/mcp push --with-documents # Push CONTEXT + DOCUMENTS
+npx @epiccontext/mcp pull --with-documents # Pull CONTEXT + DOCUMENTS
+npx @epiccontext/mcp status                # Check sync status
 \`\`\`
 `;
 }
@@ -485,6 +532,52 @@ export function generateSkills(projectRoot) {
         path: ".claude/skills/epicontext-core/SKILL.md",
         content: generateCoreSkillMd(),
     });
+    // Core skill workflow: post-implementation context update
+    result.workflows.push({
+        path: ".claude/skills/epicontext-core/workflows/post-implementation.md",
+        content: generateWorkflowMd("epicontext-core", {
+            id: "post-implementation",
+            name: "Post-Implementation",
+            description: "Check which CONTEXT blocks need updating after implementing code changes",
+            allowedTools: ["Read", "Grep", "Glob"],
+            prompt: `# Post-Implementation Context Check
+
+After implementing code changes, check which CONTEXT blocks need updating.
+
+## Process
+
+1. **Identify what changed** — Look at the code changes just made
+2. **Check related CONTEXT blocks** — Search for blocks that reference this area:
+   - Grep for feature names in CONTEXT/product/features/
+   - Grep for task/story names in CONTEXT/development/
+   - Check CONTEXT/technical/ for relevant API or data model blocks
+3. **Suggest updates** — For each related block:
+   - If a feature was implemented → suggest setting status to "complete"
+   - If a task was completed → suggest setting status to "complete"
+   - If a decision was made → suggest creating a decision block
+   - If data models changed → suggest updating data_model blocks
+   - If a new API was added → suggest creating api_endpoint block
+
+## Output Format
+
+\`\`\`
+## Context Blocks to Update
+
+### Status Changes
+- [ ] CONTEXT/development/tasks/[task].md → status: complete
+- [ ] CONTEXT/product/features/[feature].md → status: complete
+
+### New Blocks Needed
+- [ ] Create decision block: [what was decided]
+- [ ] Create api_endpoint block: [new endpoint]
+
+### No Action Needed
+- [blocks that are still accurate]
+\`\`\`
+
+Remind the user to run \`npx @epiccontext/mcp push\` after updates.`,
+        }),
+    });
     // Alignment skill with workflows
     result.skills.push({
         path: ".claude/skills/epicontext-alignment/SKILL.md",

package/dist/skills/generator.js.map

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

package/dist/sync/document-files.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Scanned file info from the local DOCUMENTS folder
+ */
+export interface ScannedFile {
+    /** Relative path within DOCUMENTS/, e.g., "research/user-interviews.pdf" */
+    relativePath: string;
+    /** Absolute path on disk */
+    absolutePath: string;
+    /** File size in bytes */
+    size: number;
+    /** Last modified time */
+    mtime: Date;
+}
+/**
+ * Recursively scan the DOCUMENTS folder for all non-hidden files
+ */
+export declare function scanDocumentsFolder(documentsPath: string): ScannedFile[];
+/**
+ * Ensure the DOCUMENTS folder and manifest exist
+ */
+export declare function ensureDocumentsFolderExists(documentsPath: string): void;
+/**
+ * Get a MIME type from file extension
+ */
+export declare function getMimeType(fileName: string): string;
+/**
+ * Compute the local file path for a document based on its folder path and file name.
+ * e.g., folderPath="research/interviews", fileName="report.pdf" → "research/interviews/report.pdf"
+ */
+export declare function computeLocalPath(folderPath: string | null, fileName: string): string;
+//# sourceMappingURL=document-files.d.ts.map

package/dist/sync/document-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-files.d.ts","sourceRoot":"","sources":["../../src/sync/document-files.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,KAAK,EAAE,IAAI,CAAC;CACb;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW,EAAE,CAqCxE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAavE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAuBpD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,QAAQ,EAAE,MAAM,GACf,MAAM,CAKR"}

package/dist/sync/document-files.js

@@ -0,0 +1,98 @@
+import * as fs from "fs";
+import * as path from "path";
+/**
+ * Files to skip when scanning the DOCUMENTS folder
+ */
+const SKIP_FILES = new Set([
+    ".manifest.json",
+    ".ds_store",
+    "thumbs.db",
+    ".gitkeep",
+]);
+/**
+ * Recursively scan the DOCUMENTS folder for all non-hidden files
+ */
+export function scanDocumentsFolder(documentsPath) {
+    const results = [];
+    function walk(dir) {
+        if (!fs.existsSync(dir))
+            return;
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            // Skip hidden files/directories
+            if (entry.name.startsWith("."))
+                continue;
+            // Skip known system files
+            if (SKIP_FILES.has(entry.name.toLowerCase()))
+                continue;
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walk(fullPath);
+            }
+            else if (entry.isFile()) {
+                const stats = fs.statSync(fullPath);
+                const relativePath = path.relative(documentsPath, fullPath);
+                // Skip README.md at root level
+                if (relativePath === "README.md")
+                    continue;
+                results.push({
+                    relativePath,
+                    absolutePath: fullPath,
+                    size: stats.size,
+                    mtime: stats.mtime,
+                });
+            }
+        }
+    }
+    walk(documentsPath);
+    return results;
+}
+/**
+ * Ensure the DOCUMENTS folder and manifest exist
+ */
+export function ensureDocumentsFolderExists(documentsPath) {
+    if (!fs.existsSync(documentsPath)) {
+        fs.mkdirSync(documentsPath, { recursive: true });
+    }
+    const manifestPath = path.join(documentsPath, ".manifest.json");
+    if (!fs.existsSync(manifestPath)) {
+        fs.writeFileSync(manifestPath, JSON.stringify({ version: 1, lastSyncAt: null, entries: [] }, null, 2), "utf-8");
+    }
+}
+/**
+ * Get a MIME type from file extension
+ */
+export function getMimeType(fileName) {
+    const ext = path.extname(fileName).toLowerCase();
+    const mimeMap = {
+        ".pdf": "application/pdf",
+        ".jpg": "image/jpeg",
+        ".jpeg": "image/jpeg",
+        ".png": "image/png",
+        ".gif": "image/gif",
+        ".webp": "image/webp",
+        ".svg": "image/svg+xml",
+        ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        ".xls": "application/vnd.ms-excel",
+        ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+        ".doc": "application/msword",
+        ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+        ".ppt": "application/vnd.ms-powerpoint",
+        ".txt": "text/plain",
+        ".csv": "text/csv",
+        ".md": "text/markdown",
+        ".zip": "application/zip",
+    };
+    return mimeMap[ext] || "application/octet-stream";
+}
+/**
+ * Compute the local file path for a document based on its folder path and file name.
+ * e.g., folderPath="research/interviews", fileName="report.pdf" → "research/interviews/report.pdf"
+ */
+export function computeLocalPath(folderPath, fileName) {
+    if (folderPath) {
+        return path.join(folderPath, fileName);
+    }
+    return fileName;
+}
+//# sourceMappingURL=document-files.js.map

package/dist/sync/document-files.js.map

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

package/dist/sync/document-manifest.d.ts

@@ -0,0 +1,22 @@
+import type { DocumentManifest, DocumentManifestEntry } from "../types/index.js";
+/**
+ * Read the document manifest from the DOCUMENTS folder
+ */
+export declare function readDocumentManifest(documentsPath: string): DocumentManifest;
+/**
+ * Write the document manifest to the DOCUMENTS folder
+ */
+export declare function writeDocumentManifest(documentsPath: string, manifest: DocumentManifest): void;
+/**
+ * Update a single entry in the manifest (upsert by document ID)
+ */
+export declare function updateManifestEntry(documentsPath: string, entry: DocumentManifestEntry): void;
+/**
+ * Remove an entry from the manifest by document ID
+ */
+export declare function removeManifestEntry(documentsPath: string, documentId: string): void;
+/**
+ * Find a manifest entry by local path
+ */
+export declare function findEntryByLocalPath(manifest: DocumentManifest, localPath: string): DocumentManifestEntry | undefined;
+//# sourceMappingURL=document-manifest.d.ts.map

package/dist/sync/document-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-manifest.d.ts","sourceRoot":"","sources":["../../src/sync/document-manifest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAIjF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,gBAAgB,CAa5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,gBAAgB,GACzB,IAAI,CAGN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,qBAAqB,GAC3B,IAAI,CAWN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,IAAI,CAIN;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,MAAM,GAChB,qBAAqB,GAAG,SAAS,CAEnC"}

package/dist/sync/document-manifest.js

@@ -0,0 +1,55 @@
+import * as fs from "fs";
+import * as path from "path";
+const MANIFEST_FILENAME = ".manifest.json";
+/**
+ * Read the document manifest from the DOCUMENTS folder
+ */
+export function readDocumentManifest(documentsPath) {
+    const manifestPath = path.join(documentsPath, MANIFEST_FILENAME);
+    if (!fs.existsSync(manifestPath)) {
+        return { version: 1, lastSyncAt: null, entries: [] };
+    }
+    try {
+        const content = fs.readFileSync(manifestPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return { version: 1, lastSyncAt: null, entries: [] };
+    }
+}
+/**
+ * Write the document manifest to the DOCUMENTS folder
+ */
+export function writeDocumentManifest(documentsPath, manifest) {
+    const manifestPath = path.join(documentsPath, MANIFEST_FILENAME);
+    fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), "utf-8");
+}
+/**
+ * Update a single entry in the manifest (upsert by document ID)
+ */
+export function updateManifestEntry(documentsPath, entry) {
+    const manifest = readDocumentManifest(documentsPath);
+    const idx = manifest.entries.findIndex((e) => e.id === entry.id);
+    if (idx >= 0) {
+        manifest.entries[idx] = entry;
+    }
+    else {
+        manifest.entries.push(entry);
+    }
+    writeDocumentManifest(documentsPath, manifest);
+}
+/**
+ * Remove an entry from the manifest by document ID
+ */
+export function removeManifestEntry(documentsPath, documentId) {
+    const manifest = readDocumentManifest(documentsPath);
+    manifest.entries = manifest.entries.filter((e) => e.id !== documentId);
+    writeDocumentManifest(documentsPath, manifest);
+}
+/**
+ * Find a manifest entry by local path
+ */
+export function findEntryByLocalPath(manifest, localPath) {
+    return manifest.entries.find((e) => e.localPath === localPath);
+}
+//# sourceMappingURL=document-manifest.js.map

package/dist/sync/document-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-manifest.js","sourceRoot":"","sources":["../../src/sync/document-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAE3C;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,aAAqB;IACxD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;IAEjE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACvD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAqB,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACvD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,aAAqB,EACrB,QAA0B;IAE1B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;IACjE,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,aAAqB,EACrB,KAA4B;IAE5B,MAAM,QAAQ,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC;IAEjE,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAChC,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,qBAAqB,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,aAAqB,EACrB,UAAkB;IAElB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC;IACrD,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;IACvE,qBAAqB,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAA0B,EAC1B,SAAiB;IAEjB,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;AACjE,CAAC"}

package/dist/sync/document-pull.d.ts

@@ -0,0 +1,16 @@
+import type { EpicContextClient } from "../api/client.js";
+import type { DocumentSyncResult } from "../types/index.js";
+export interface DocumentPullOptions {
+    /** Overwrite local files even if they are newer */
+    force?: boolean;
+    /** Skip files larger than this (bytes) */
+    maxFileSize?: number;
+    /** Preview changes without downloading */
+    dryRun?: boolean;
+}
+/**
+ * Pull documents from the cloud to the local DOCUMENTS folder.
+ * Only downloads new or updated files (delta sync based on timestamps).
+ */
+export declare function pullDocuments(client: EpicContextClient, documentsPath: string, options?: DocumentPullOptions): Promise<DocumentSyncResult>;
+//# sourceMappingURL=document-pull.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-pull.d.ts","sourceRoot":"","sources":["../../src/sync/document-pull.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAEV,kBAAkB,EAEnB,MAAM,mBAAmB,CAAC;AAI3B,MAAM,WAAW,mBAAmB;IAClC,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,iBAAiB,EACzB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA+I7B"}

package/dist/sync/document-pull.js

@@ -0,0 +1,149 @@
+import * as fs from "fs";
+import * as path from "path";
+import { readDocumentManifest, writeDocumentManifest } from "./document-manifest.js";
+import { ensureDocumentsFolderExists, computeLocalPath } from "./document-files.js";
+/**
+ * Pull documents from the cloud to the local DOCUMENTS folder.
+ * Only downloads new or updated files (delta sync based on timestamps).
+ */
+export async function pullDocuments(client, documentsPath, options = {}) {
+    ensureDocumentsFolderExists(documentsPath);
+    const result = {
+        downloaded: 0,
+        uploaded: 0,
+        skipped: 0,
+        deleted: 0,
+        errors: [],
+    };
+    // 1. Get cloud documents
+    const cloudData = await client.listDocuments();
+    const manifest = readDocumentManifest(documentsPath);
+    const manifestMap = new Map(manifest.entries.map((e) => [e.id, e]));
+    // 2. Process each cloud document
+    for (const cloudDoc of cloudData.documents) {
+        const localPath = computeLocalPath(cloudDoc.folderPath || null, cloudDoc.fileName);
+        const absolutePath = path.join(documentsPath, localPath);
+        // Check max file size
+        if (options.maxFileSize && cloudDoc.fileSize > options.maxFileSize) {
+            result.skipped++;
+            continue;
+        }
+        const existingEntry = manifestMap.get(cloudDoc.id);
+        let needsDownload = false;
+        if (!existingEntry) {
+            // New document — not in manifest
+            needsDownload = true;
+        }
+        else if (!fs.existsSync(absolutePath)) {
+            // In manifest but missing locally — re-download
+            needsDownload = true;
+        }
+        else if (cloudDoc.updatedAt > (existingEntry.cloudUpdatedAt || "")) {
+            // Cloud version is newer
+            if (options.force) {
+                needsDownload = true;
+            }
+            else {
+                // Check if local is also newer (conflict)
+                const localMtime = getFileMtime(absolutePath);
+                if (localMtime &&
+                    existingEntry.localUpdatedAt &&
+                    localMtime > existingEntry.localUpdatedAt) {
+                    // Both modified — skip unless forced
+                    result.skipped++;
+                    continue;
+                }
+                needsDownload = true;
+            }
+        }
+        else {
+            // Already in sync
+            result.skipped++;
+            continue;
+        }
+        if (options.dryRun) {
+            result.downloaded++;
+            continue;
+        }
+        // Download the file
+        try {
+            const { data } = await client.downloadDocument(cloudDoc.id);
+            // Ensure directory exists
+            const dir = path.dirname(absolutePath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            // Write atomically: temp file → rename
+            const tempPath = absolutePath + ".tmp";
+            fs.writeFileSync(tempPath, Buffer.from(data));
+            fs.renameSync(tempPath, absolutePath);
+            // Update manifest entry
+            const entry = {
+                id: cloudDoc.id,
+                name: cloudDoc.name,
+                fileName: cloudDoc.fileName,
+                localPath,
+                cloudUrl: cloudDoc.fileUrl,
+                storagePath: cloudDoc.storagePath,
+                mimeType: cloudDoc.mimeType,
+                fileSize: cloudDoc.fileSize,
+                cloudUpdatedAt: cloudDoc.updatedAt,
+                localUpdatedAt: new Date().toISOString(),
+                syncStatus: "synced",
+                folderId: cloudDoc.folderId,
+                folderPath: cloudDoc.folderPath || null,
+            };
+            // Update in-memory manifest
+            const idx = manifest.entries.findIndex((e) => e.id === cloudDoc.id);
+            if (idx >= 0) {
+                manifest.entries[idx] = entry;
+            }
+            else {
+                manifest.entries.push(entry);
+            }
+            result.downloaded++;
+        }
+        catch (error) {
+            result.errors.push({
+                path: localPath,
+                error: error instanceof Error ? error.message : "Download failed",
+            });
+        }
+    }
+    // 3. Check for deleted cloud documents (in manifest but not in cloud)
+    const cloudIds = new Set(cloudData.documents.map((d) => d.id));
+    for (const entry of [...manifest.entries]) {
+        if (!cloudIds.has(entry.id)) {
+            entry.syncStatus = "deleted_cloud";
+            // Optionally remove local file
+            const absolutePath = path.join(documentsPath, entry.localPath);
+            if (fs.existsSync(absolutePath) && !options.dryRun) {
+                try {
+                    fs.unlinkSync(absolutePath);
+                    result.deleted++;
+                }
+                catch {
+                    // Leave file but mark in manifest
+                }
+            }
+            // Remove from manifest
+            manifest.entries = manifest.entries.filter((e) => e.id !== entry.id);
+        }
+    }
+    // 4. Save manifest
+    if (!options.dryRun) {
+        manifest.lastSyncAt = new Date().toISOString();
+        writeDocumentManifest(documentsPath, manifest);
+    }
+    return result;
+}
+function getFileMtime(filePath) {
+    try {
+        const stats = fs.statSync(filePath);
+        return stats.mtime.toISOString();
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=document-pull.js.map

package/dist/sync/document-pull.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-pull.js","sourceRoot":"","sources":["../../src/sync/document-pull.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAO7B,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAWpF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAyB,EACzB,aAAqB,EACrB,UAA+B,EAAE;IAEjC,2BAA2B,CAAC,aAAa,CAAC,CAAC;IAE3C,MAAM,MAAM,GAAuB;QACjC,UAAU,EAAE,CAAC;QACb,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,EAAE;KACX,CAAC;IAEF,yBAAyB;IACzB,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpE,iCAAiC;IACjC,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,UAAU,IAAI,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnF,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QAEzD,sBAAsB;QACtB,IAAI,OAAO,CAAC,WAAW,IAAI,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YACnE,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,SAAS;QACX,CAAC;QAED,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACnD,IAAI,aAAa,GAAG,KAAK,CAAC;QAE1B,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,iCAAiC;YACjC,aAAa,GAAG,IAAI,CAAC;QACvB,CAAC;aAAM,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACxC,gDAAgD;YAChD,aAAa,GAAG,IAAI,CAAC;QACvB,CAAC;aAAM,IAAI,QAAQ,CAAC,SAAS,GAAG,CAAC,aAAa,CAAC,cAAc,IAAI,EAAE,CAAC,EAAE,CAAC;YACrE,yBAAyB;YACzB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBAClB,aAAa,GAAG,IAAI,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,0CAA0C;gBAC1C,MAAM,UAAU,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;gBAC9C,IACE,UAAU;oBACV,aAAa,CAAC,cAAc;oBAC5B,UAAU,GAAG,aAAa,CAAC,cAAc,EACzC,CAAC;oBACD,qCAAqC;oBACrC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACjB,SAAS;gBACX,CAAC;gBACD,aAAa,GAAG,IAAI,CAAC;YACvB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,kBAAkB;YAClB,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,SAAS;QACX,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,CAAC,UAAU,EAAE,CAAC;YACpB,SAAS;QACX,CAAC;QAED,oBAAoB;QACpB,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAE5D,0BAA0B;YAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzC,CAAC;YAED,uCAAuC;YACvC,MAAM,QAAQ,GAAG,YAAY,GAAG,MAAM,CAAC;YACvC,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9C,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YAEtC,wBAAwB;YACxB,MAAM,KAAK,GAA0B;gBACnC,EAAE,EAAE,QAAQ,CAAC,EAAE;gBACf,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,SAAS;gBACT,QAAQ,EAAE,QAAQ,CAAC,OAAO;gBAC1B,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,cAAc,EAAE,QAAQ,CAAC,SAAS;gBAClC,cAAc,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACxC,UAAU,EAAE,QAAQ;gBACpB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,UAAU,EAAE,QAAQ,CAAC,UAAU,IAAI,IAAI;aACxC,CAAC;YAEF,4BAA4B;YAC5B,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,CAAC,CAAC;YACpE,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;gBACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;YAED,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;gBACjB,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB;aAClE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/D,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5B,KAAK,CAAC,UAAU,GAAG,eAAe,CAAC;YAEnC,+BAA+B;YAC/B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YAC/D,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnD,IAAI,CAAC;oBACH,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;oBAC5B,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,CAAC;gBAAC,MAAM,CAAC;oBACP,kCAAkC;gBACpC,CAAC;YACH,CAAC;YAED,uBAAuB;YACvB,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,QAAQ,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC/C,qBAAqB,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB;IACpC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACpC,OAAO,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/sync/document-push.d.ts

@@ -0,0 +1,14 @@
+import type { EpicContextClient } from "../api/client.js";
+import type { DocumentSyncResult } from "../types/index.js";
+export interface DocumentPushOptions {
+    /** Preview changes without uploading */
+    dryRun?: boolean;
+    /** Push only a specific file or folder path */
+    path?: string;
+}
+/**
+ * Push local documents to the cloud.
+ * Only uploads new or modified files (delta sync based on timestamps).
+ */
+export declare function pushDocuments(client: EpicContextClient, documentsPath: string, options?: DocumentPushOptions): Promise<DocumentSyncResult>;
+//# sourceMappingURL=document-push.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-push.d.ts","sourceRoot":"","sources":["../../src/sync/document-push.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAEV,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAY3B,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,iBAAiB,EACzB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAoH7B"}