emdash-emit 0.0.0-stage → 0.1.2

package/dist/mcp/tools/sync-push.js

@@ -0,0 +1,105 @@
+/*
+ * Copyright (C) 2026 SPORT-SERVICE RS★R
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { z } from 'zod';
+import { ApiError } from '../../client/error.js';
+import { pushArticle, PushValidationError } from '../../sync/push.js';
+export function registerSyncPushTool(server, resolveContext) {
+    server.tool('sync_push', {
+        filePath: z
+            .string()
+            .describe('Target markdown file path relative to workspace root (e.g. "posts/draft/20261103_01...-my-article.md")'),
+        allowPublish: z
+            .boolean()
+            .optional()
+            .describe('Explicit confirmation required to change status from draft to published'),
+        profile: z.string().optional().describe('Target profile name for multi-site setups'),
+    }, async (args) => {
+        const ctx = resolveContext(args.profile);
+        const origin = ctx.origin;
+        try {
+            const res = await pushArticle(args.filePath, {
+                workspaceRoot: ctx.root,
+                cache: ctx.cache,
+                origin,
+                token: ctx.auth.token,
+                refreshToken: ctx.auth.refreshToken,
+                allowPublish: args.allowPublish,
+            });
+            if (res.conflict) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: [
+                                '⚠️ Conflict detected and could not be resolved automatically.',
+                                `Conflict markers (<<<<<<< LOCAL ... ======= ... >>>>>>> REMOTE) have been inserted into "${res.filePath}".`,
+                                'Please resolve the conflicting lines in the file and retry sync_push.',
+                            ].join('\n'),
+                        },
+                    ],
+                };
+            }
+            const warningLines = res.warnings && res.warnings.length > 0
+                ? ['', '⚠️ Warnings:', ...res.warnings.map((w) => `  - ${w}`)]
+                : [];
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: [
+                            `✅ Successfully pushed '${res.id}' to remote (${res.filePath}, rev: ${res.rev}).`,
+                            ...warningLines,
+                        ].join('\n'),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            if (err instanceof PushValidationError) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: 'PREFLIGHT_VALIDATION_FAILED',
+                                message: err.message,
+                                errors: err.errors,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            if (err instanceof ApiError) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: err.toActionableString(),
+                        },
+                    ],
+                };
+            }
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=sync-push.js.map

package/dist/mcp/tools/sync-push.js.map

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

package/dist/mcp/tools/sync-status.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ContextResolver } from '../context.js';
+export declare function registerSyncStatusTool(server: McpServer, resolveContext: ContextResolver): void;
+//# sourceMappingURL=sync-status.d.ts.map

package/dist/mcp/tools/sync-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-status.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/sync-status.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,GAAG,IAAI,CAyB/F"}

package/dist/mcp/tools/sync-status.js

@@ -0,0 +1,45 @@
+/*
+ * Copyright (C) 2026 SPORT-SERVICE RS★R
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { z } from 'zod';
+import { getWorkspaceStatus } from '../../sync/status.js';
+export function registerSyncStatusTool(server, resolveContext) {
+    server.tool('sync_status', {
+        collection: z
+            .string()
+            .optional()
+            .describe('Collection name to inspect (defaults to "posts")'),
+        profile: z.string().optional().describe('Target profile name for multi-site setups'),
+    }, async (args) => {
+        const ctx = resolveContext(args.profile);
+        const collection = args.collection || ctx.config.defaultCollection;
+        const status = getWorkspaceStatus(ctx.root, ctx.cache, collection);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(status, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=sync-status.js.map

package/dist/mcp/tools/sync-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-status.js","sourceRoot":"","sources":["../../../src/mcp/tools/sync-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,cAA+B;IACvF,MAAM,CAAC,IAAI,CACT,aAAa,EACb;QACE,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,kDAAkD,CAAC;QAC/D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;KACrF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC;QACnE,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAEnE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/sync/bylines.d.ts

@@ -0,0 +1,23 @@
+import { type CacheDatabase } from '../db/cache.js';
+export interface BylineMaps {
+    slugToId: Record<string, string>;
+    idToSlug: Record<string, string>;
+}
+export interface SyncBylinesOptions {
+    origin: string;
+    token: string;
+    refreshToken?: string;
+    cache: CacheDatabase;
+    fetchFn?: typeof fetch;
+}
+/**
+ * Synchronizes remote bylines from EmDash into the local SQLite database cache.
+ * Automatically called on pull commands to ensure local author metadata is always fresh.
+ * Gracefully falls back to existing cache if remote is unreachable.
+ */
+export declare function syncRemoteBylines(options: SyncBylinesOptions): Promise<BylineMaps>;
+/**
+ * Returns cached slugToId and idToSlug maps directly from local DB.
+ */
+export declare function loadLocalBylineMaps(cache: CacheDatabase): BylineMaps;
+//# sourceMappingURL=bylines.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bylines.d.ts","sourceRoot":"","sources":["../../src/sync/bylines.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,KAAK,aAAa,EAAqB,MAAM,gBAAgB,CAAC;AAGvE,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AA4CD;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAsDxF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,CAEpE"}

package/dist/sync/bylines.js

@@ -0,0 +1,112 @@
+/*
+ * Copyright (C) 2026 SPORT-SERVICE RS★R
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { createAuthedFetch } from '../client/http.js';
+/**
+ * Parses raw JSON-RPC result from EmDash /_emdash/api/mcp endpoint.
+ * Handles both Server-Sent Events (SSE) format ("data: {...}") and plain JSON responses.
+ */
+function parseMcpToolCallText(rawBody) {
+    const trimmed = rawBody.trim();
+    if (trimmed.startsWith('{')) {
+        try {
+            const json = JSON.parse(trimmed);
+            return json.result?.content?.[0]?.text || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    // Handle SSE data: lines
+    const dataLine = rawBody.split('\n').find((l) => l.startsWith('data:'));
+    if (dataLine) {
+        try {
+            const jsonStr = dataLine.replace(/^data:\s*/, '').trim();
+            const json = JSON.parse(jsonStr);
+            return json.result?.content?.[0]?.text || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+/**
+ * Synchronizes remote bylines from EmDash into the local SQLite database cache.
+ * Automatically called on pull commands to ensure local author metadata is always fresh.
+ * Gracefully falls back to existing cache if remote is unreachable.
+ */
+export async function syncRemoteBylines(options) {
+    const fetchFn = createAuthedFetch(options);
+    try {
+        const mcpUrl = new URL('/_emdash/api/mcp', options.origin).toString();
+        const res = await fetchFn(mcpUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Accept: 'application/json, text/event-stream',
+            },
+            body: JSON.stringify({
+                jsonrpc: '2.0',
+                id: 1,
+                method: 'tools/call',
+                params: {
+                    name: 'byline_list',
+                    arguments: { limit: 100 },
+                },
+            }),
+        });
+        if (res.ok) {
+            const responseText = await res.text();
+            const toolText = parseMcpToolCallText(responseText);
+            if (toolText) {
+                const parsed = JSON.parse(toolText);
+                const rawItems = Array.isArray(parsed.items) ? parsed.items : [];
+                const records = [];
+                const now = Math.floor(Date.now() / 1000);
+                for (const item of rawItems) {
+                    if (item.id && item.slug) {
+                        records.push({
+                            id: item.id,
+                            slug: item.slug,
+                            displayName: item.displayName || item.slug,
+                            isGuest: Boolean(item.isGuest),
+                            rawJson: JSON.stringify(item),
+                            updatedAt: now,
+                        });
+                    }
+                }
+                options.cache.saveBylines(records, true);
+            }
+        }
+    }
+    catch {
+        // Non-fatal: if remote byline sync fails (e.g. offline, permissions), proceed with existing cache
+    }
+    return options.cache.getBylineMaps();
+}
+/**
+ * Returns cached slugToId and idToSlug maps directly from local DB.
+ */
+export function loadLocalBylineMaps(cache) {
+    return cache.getBylineMaps();
+}
+//# sourceMappingURL=bylines.js.map

package/dist/sync/bylines.js.map

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

package/dist/sync/diff.d.ts

@@ -0,0 +1,16 @@
+export interface DiffResult {
+    hasChanges: boolean;
+    unifiedDiff: string;
+    additions: number;
+    deletions: number;
+}
+/**
+ * Computes a unified-like diff between base text and local text without dumping full contents.
+ * Conserves LLM context tokens by outputting only changed regions with line context.
+ */
+export declare function computeContextDiff(baseText: string, localText: string, options?: {
+    contextLines?: number;
+    baseLabel?: string;
+    localLabel?: string;
+}): DiffResult;
+//# sourceMappingURL=diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/sync/diff.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3E,UAAU,CAiDZ"}

package/dist/sync/diff.js

@@ -0,0 +1,68 @@
+/*
+ * Copyright (C) 2026 SPORT-SERVICE RS★R
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { diffPatch } from 'node-diff3';
+/**
+ * Computes a unified-like diff between base text and local text without dumping full contents.
+ * Conserves LLM context tokens by outputting only changed regions with line context.
+ */
+export function computeContextDiff(baseText, localText, options) {
+    if (baseText === localText) {
+        return {
+            hasChanges: false,
+            unifiedDiff: 'No changes detected.',
+            additions: 0,
+            deletions: 0,
+        };
+    }
+    const baseLines = baseText.split('\n');
+    const localLines = localText.split('\n');
+    const patches = diffPatch(baseLines, localLines);
+    const contextLines = options?.contextLines ?? 3;
+    const baseLabel = options?.baseLabel ?? 'base';
+    const localLabel = options?.localLabel ?? 'local';
+    let additions = 0;
+    let deletions = 0;
+    const output = [`--- ${baseLabel}`, `+++ ${localLabel}`];
+    for (const patch of patches) {
+        const b1 = patch.buffer1;
+        const b2 = patch.buffer2;
+        deletions += b1.length;
+        additions += b2.length;
+        // Output hunk header
+        output.push(`@@ -${b1.offset + 1},${b1.length} +${b2.offset + 1},${b2.length} @@`);
+        // Removed lines
+        for (const line of b1.chunk) {
+            output.push(`-${line}`);
+        }
+        // Added lines
+        for (const line of b2.chunk) {
+            output.push(`+${line}`);
+        }
+    }
+    return {
+        hasChanges: true,
+        unifiedDiff: output.join('\n'),
+        additions,
+        deletions,
+    };
+}
+//# sourceMappingURL=diff.js.map

package/dist/sync/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/sync/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AASvC;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,SAAiB,EACjB,OAA4E;IAE5E,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,WAAW,EAAE,sBAAsB;YACnC,SAAS,EAAE,CAAC;YACZ,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,SAAS,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAEjD,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,MAAM,CAAC;IAC/C,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,OAAO,CAAC;IAElD,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,MAAM,GAAa,CAAC,OAAO,SAAS,EAAE,EAAE,OAAO,UAAU,EAAE,CAAC,CAAC;IAEnE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC;QACzB,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC;QAEzB,SAAS,IAAI,EAAE,CAAC,MAAM,CAAC;QACvB,SAAS,IAAI,EAAE,CAAC,MAAM,CAAC;QAEvB,qBAAqB;QACrB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC;QAEnF,gBAAgB;QAChB,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC1B,CAAC;QAED,cAAc;QACd,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO;QACL,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9B,SAAS;QACT,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/sync/media.d.ts

@@ -0,0 +1,37 @@
+export interface EmDashMediaItem {
+    id: string;
+    filename: string;
+    mimeType: string;
+    size: number;
+    width?: number | null;
+    height?: number | null;
+    alt?: string | null;
+    caption?: string | null;
+    url?: string;
+    storageKey?: string;
+    createdAt?: string;
+}
+export interface PullMediaOptions {
+    workspaceRoot: string;
+    origin: string;
+    token: string;
+    refreshToken?: string;
+    limit?: number;
+    all?: boolean;
+    downloadFiles?: boolean;
+    prune?: boolean;
+    fetchFn?: typeof fetch;
+}
+export interface PullMediaResult {
+    total: number;
+    downloaded: number;
+    skipped: number;
+    deleted?: number;
+}
+/**
+ * Pulls media metadata and files from EmDash API into media/ directory with cursor pagination.
+ * media/<id>-<filename>.yaml
+ * media/<id>-<filename>.<ext>
+ */
+export declare function pullMedia(options: PullMediaOptions): Promise<PullMediaResult>;
+//# sourceMappingURL=media.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/sync/media.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAkLnF"}

package/dist/sync/media.js

@@ -0,0 +1,191 @@
+/*
+ * Copyright (C) 2026 SPORT-SERVICE RS★R
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import yaml from 'js-yaml';
+import { formatDatePrefix, sanitizeTitleForFilename } from '../utils/frontmatter.js';
+import { ApiError } from '../client/error.js';
+import { createAuthedFetch } from '../client/http.js';
+import { unwrapEnvelope } from '../client/api.js';
+/**
+ * Pulls media metadata and files from EmDash API into media/ directory with cursor pagination.
+ * media/<id>-<filename>.yaml
+ * media/<id>-<filename>.<ext>
+ */
+export async function pullMedia(options) {
+    const fetchFn = createAuthedFetch(options);
+    const targetTotal = options.all ? Infinity : (options.limit ?? 300);
+    const downloadFiles = options.downloadFiles !== false;
+    const batchSize = 100;
+    const mediaDir = path.join(options.workspaceRoot, 'media');
+    fs.mkdirSync(mediaDir, { recursive: true });
+    const activeMediaBaseNames = new Set();
+    const activeMediaIds = new Set();
+    let totalProcessed = 0;
+    let downloadedCount = 0;
+    let skippedCount = 0;
+    let cursor = undefined;
+    while (totalProcessed < targetTotal) {
+        const remaining = targetTotal - totalProcessed;
+        const currentBatch = Math.min(remaining, batchSize);
+        const url = new URL(`/_emdash/api/media`, options.origin);
+        url.searchParams.set('limit', String(currentBatch));
+        if (cursor) {
+            url.searchParams.set('cursor', cursor);
+        }
+        const res = await fetchFn(url.toString(), {
+            method: 'GET',
+            headers: {
+                Authorization: `Bearer ${options.token}`,
+                Accept: 'application/json',
+            },
+        });
+        if (!res.ok) {
+            throw new ApiError({
+                message: `Failed to list media: ${res.statusText}`,
+                code: 'MEDIA_LIST_FAILED',
+                status: res.status,
+                endpoint: url.toString(),
+                suggestion: 'Verify network connection and token permissions.',
+            });
+        }
+        const json = await res.json();
+        const data = unwrapEnvelope(json);
+        const rawItems = (Array.isArray(data.items) ? data.items : Array.isArray(data) ? data : []);
+        if (rawItems.length === 0) {
+            break;
+        }
+        for (const item of rawItems) {
+            const ext = path.extname(item.filename);
+            const baseWithoutExt = path.basename(item.filename, ext);
+            const sanitizedBase = sanitizeTitleForFilename(baseWithoutExt);
+            const datePrefix = formatDatePrefix(item.createdAt);
+            const baseName = `${datePrefix}${item.id}-${sanitizedBase}`;
+            const oldBaseName = `${item.id}-${sanitizedBase}`;
+            activeMediaBaseNames.add(baseName);
+            activeMediaBaseNames.add(oldBaseName);
+            activeMediaIds.add(item.id);
+            // Clean up old un-prefixed YAML if migrating
+            const oldYamlPath = path.join(mediaDir, `${oldBaseName}.yaml`);
+            const yamlPath = path.join(mediaDir, `${baseName}.yaml`);
+            if (oldYamlPath !== yamlPath && fs.existsSync(oldYamlPath)) {
+                try {
+                    fs.unlinkSync(oldYamlPath);
+                }
+                catch { }
+            }
+            // 1. Write YAML metadata
+            const metaDoc = {
+                id: item.id,
+                filename: item.filename,
+                mimeType: item.mimeType,
+                size: item.size,
+                width: item.width ?? null,
+                height: item.height ?? null,
+                alt: item.alt ?? '',
+                caption: item.caption ?? '',
+                url: item.url ? new URL(item.url, options.origin).toString() : '',
+                createdAt: item.createdAt || '',
+            };
+            fs.writeFileSync(yamlPath, yaml.dump(metaDoc, { indent: 2, quotingType: '"', forceQuotes: false }), 'utf8');
+            // 2. Download binary file if enabled and url is present
+            if (downloadFiles && item.url) {
+                const fileExt = ext || (item.mimeType.includes('png') ? '.png' : '.jpg');
+                const oldFilePath = path.join(mediaDir, `${oldBaseName}${fileExt}`);
+                const targetFilePath = path.join(mediaDir, `${baseName}${fileExt}`);
+                // Migrate/rename old file to new name if already downloaded
+                if (oldFilePath !== targetFilePath && fs.existsSync(oldFilePath)) {
+                    try {
+                        const stat = fs.statSync(oldFilePath);
+                        if (stat.size === item.size) {
+                            fs.renameSync(oldFilePath, targetFilePath);
+                        }
+                    }
+                    catch { }
+                }
+                // Avoid re-downloading if already present and matches size
+                let shouldDownload = true;
+                if (fs.existsSync(targetFilePath)) {
+                    const stat = fs.statSync(targetFilePath);
+                    if (stat.size === item.size) {
+                        shouldDownload = false;
+                        skippedCount++;
+                    }
+                }
+                if (shouldDownload) {
+                    try {
+                        const downloadUrl = new URL(item.url, options.origin).toString();
+                        const fileRes = await fetchFn(downloadUrl, {
+                            headers: {
+                                Authorization: `Bearer ${options.token}`,
+                            },
+                        });
+                        if (fileRes.ok) {
+                            const buffer = Buffer.from(await fileRes.arrayBuffer());
+                            fs.writeFileSync(targetFilePath, buffer);
+                            downloadedCount++;
+                        }
+                    }
+                    catch {
+                        // Ignore individual download failures
+                    }
+                }
+            }
+            totalProcessed++;
+            if (totalProcessed >= targetTotal) {
+                break;
+            }
+        }
+        if (!data.nextCursor || typeof data.nextCursor !== 'string') {
+            break;
+        }
+        cursor = data.nextCursor;
+    }
+    // Pruning logic for media: if --prune or --all is enabled, delete local media not present on remote
+    let deletedCount = 0;
+    if ((options.prune || options.all) && fs.existsSync(mediaDir)) {
+        const files = fs.readdirSync(mediaDir);
+        for (const file of files) {
+            // Check if file is related to any active media ID
+            const match = file.replace(/^\d{8}_/, '').match(/^([0-9A-Z]{26})/);
+            if (match) {
+                const id = match[1];
+                if (!activeMediaIds.has(id)) {
+                    try {
+                        fs.unlinkSync(path.join(mediaDir, file));
+                        deletedCount++;
+                    }
+                    catch {
+                        // Ignore unlink errors
+                    }
+                }
+            }
+        }
+    }
+    return {
+        total: totalProcessed,
+        downloaded: downloadedCount,
+        skipped: skippedCount,
+        deleted: deletedCount,
+    };
+}
+//# sourceMappingURL=media.js.map