emdash-emit 0.1.8 → 0.1.10

package/dist/mcp/server.js

@@ -23,15 +23,19 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { resolveAuth } from '../client/auth.js';
 import { CacheDatabase } from '../db/cache.js';
-import { loadConfig } from '../utils/config.js';
-import { getWorkspacePaths, requireWorkspaceRoot } from '../utils/workspace.js';
-import { loadProfilesFile, AmbiguousProfileError } from '../utils/profile.js';
+import { resolveOriginPriority } from '../cli/context.js';
+import { DEFAULT_ORIGIN, getEnvOrigin, loadConfig } from '../utils/config.js';
+import { findWorkspaceRoot, getWorkspacePaths, requireWorkspaceRoot } from '../utils/workspace.js';
+import { findProfileByDirectory, loadProfilesFile, AmbiguousProfileError, } from '../utils/profile.js';
 import { registerProfileTools } from './tools/profile.js';
 import { registerSyncNewTool } from './tools/sync-new.js';
 import { registerSyncPullTools } from './tools/sync-pull.js';
 import { registerSyncPushTool } from './tools/sync-push.js';
 import { registerSyncStatusTool } from './tools/sync-status.js';
 import { registerSyncDiffTool } from './tools/sync-diff.js';
+import { registerSyncDeleteTool } from './tools/sync-delete.js';
+import { registerSyncConflictsTool } from './tools/sync-conflicts.js';
+import { registerSyncDoctorTool } from './tools/sync-doctor.js';
 import { getPackageVersion } from '../utils/version.js';
 export const EMIT_MCP_INSTRUCTIONS = `
 # Emit - AI-First Local Workspace & Sync Engine for EmDash
@@ -41,31 +45,63 @@ Emit manages articles, taxonomies, and media as plain files on your local filesy
 ## Local Directory Structure
 - posts/published/YYYYMMDD_<ulid>-<title>.md : Published articles in Markdown
 - posts/draft/YYYYMMDD_<ulid>-<title>.md : Draft articles in Markdown
+- posts/conflicts/<name>.conflict.md : Preserved divergent local copies (read-only rescue content; never an article)
 - categories/<id>-<name>.yaml : Category definitions
 - tags/<id>-<name>.yaml : Tag definitions
 - media/<yyyyMMdd>_<id>-<name>.<ext> & .yaml : Media assets & companion metadata
 - media/drafts/<filename> : Staging folder for offline draft images (auto-uploaded on sync_push)
 
+## Rescue Copy Rule (posts/conflicts/)
+- sync_pull moves a local file whose content diverged from the remote into posts/conflicts/ before overwriting it, so unpushed writing is never discarded.
+- Read rescue copies and merge any valuable content into the canonical article, then delete the copy.
+- Never pass a posts/conflicts/ path to sync_push: it is refused with QUARANTINED_COPY_NOT_PUSHABLE because it would overwrite the canonical article with stale content.
+
 ## Media & Image Rules (Two Distinct ID Spaces)
 - Frontmatter featuredImage uses the 26-character media record id (e.g. "01M67P0MBMJQQXH2K95HHCYRYB") or null.
 - Markdown body images use the storageKey-based URL: ![alt](/_emdash/api/media/file/<storageKey>). Never put a media record id in /_emdash/api/media/file/.
 - For new local images, place the file in media/drafts/<filename> and reference it on a standalone line: ![alt](../../media/drafts/<filename>). sync_push will automatically upload it, rewrite the Markdown URL, and promote the file into media/.
 
 ## AI Workflow (The Golden Path)
-1. [CHECK]: Use sync_status to list locally tracked articles and their file paths (returned newest-first, descending by date). If articles are already present locally, do NOT query remote CMS APIs (e.g. emdash MCP tools like content_list).
+1. [CHECK]: Use sync_status to inspect locally tracked articles. Returns a summary-first payload (actionRequired capped at 30 items, recentArticles 5 items). To locate specific articles across the full workspace, use search (title/slug/id/filePath) or slugFilter. If articles are already present locally, do NOT query remote CMS APIs (e.g. emdash MCP tools like content_list).
 2. [PULL]: Use sync_pull to sync articles AND taxonomies (categories/tags) from EmDash remote. Batch mode automatically pulls both and returns available taxonomy hints (also returned with postsOnly:true). Use postsOnly:true to skip taxonomies. Use includeMedia:true to also pull media assets.
 3. [READ & EDIT]: Read and edit the local Markdown files directly using your standard filesystem tools. Full article content and metadata (title, slug, status, bylines, taxonomies) are stored in the Markdown files.
 4. [PUSH]: Use sync_push with filePath to sync your changes to the remote EmDash CMS. If transitioning status from draft to published, pass allowPublish: true.
-5. [NEW]: Use sync_new to scaffold a new draft file in posts/draft/ (it returns available categories/tags hints), edit it locally, and push when ready.
+5. [NEW]: Use sync_new to scaffold a new draft file in posts/draft/ (it returns available categories/tags hints). Rejects duplicates if slug already exists locally or in cache.
+6. [DELETE]: Use sync_delete to permanently delete an article from both local workspace and remote CMS. Strictly refuses deletion if unpushed local modifications exist. Requires allowDeletePublished: true for published articles. Automatically saves a rescue copy in posts/conflicts/<file>.deleted.md and preserves referenced media files in media/.
+7. [CONFLICTS]: Use sync_conflicts to inspect quarantined sync conflict copies (.conflict.md) and deletion rescue backups (.deleted.md) in posts/conflicts/ (action: 'list' | 'diff' | 'resolve', strategy: 'accept-local' | 'accept-canonical'). Overwriting canonical files with unpushed edits requires force: true (G13).
+8. [DOCTOR]: Use sync_doctor to diagnose workspace health (version compatibility, origin consistency, frontmatter integrity, conflicts/quarantine, and media references).
+9. [MEDIA]: Use sync_pull_media to download media assets and companion YAML metadata into media/. Pass article: <ULID> to pull only media referenced by that specific article without downloading the whole media library.
+All tool responses include "_meta" context describing profile, workspace directory, origin, and resolution mechanism.
 `.trim();
 export function createMcpServer(options) {
     let activeProfileOverride;
     // Helper to resolve workspace context based on optional profile
     const resolveContext = (targetProfile) => {
         const profileToUse = targetProfile || activeProfileOverride;
+        const profilesData = loadProfilesFile(options?.profilesPath);
+        const explicitProf = profileToUse ? profilesData.profiles[profileToUse] : undefined;
+        const cwdProf = !profileToUse
+            ? findProfileByDirectory(process.cwd(), options?.profilesPath)
+            : null;
+        const nearestEmitRoot = !profileToUse ? findWorkspaceRoot(process.cwd()) : null;
+        const envOrigin = getEnvOrigin();
+        const preResolvedWorkspace = options?.workspaceRoot ||
+            explicitProf?.workspace ||
+            cwdProf?.config.workspace ||
+            nearestEmitRoot ||
+            process.env.EMDASH_WORKSPACE;
+        const preConfig = preResolvedWorkspace ? loadConfig(preResolvedWorkspace) : undefined;
+        const preConfiguredOrigin = preConfig && preConfig.origin !== DEFAULT_ORIGIN ? preConfig.origin : undefined;
+        // An explicit EMDASH_ORIGIN is also a valid disambiguation hint for multi-profile setups.
+        const preOriginHint = preConfiguredOrigin || envOrigin;
         let auth;
         try {
-            auth = resolveAuth({ profile: profileToUse });
+            auth = resolveAuth({
+                profile: profileToUse,
+                cwd: preResolvedWorkspace || process.cwd(),
+                origin: preOriginHint,
+                customProfilesPath: options?.profilesPath,
+            });
             if (!auth) {
                 throw new Error('No authentication token found. Please run emit profile add or set EMDASH_TOKEN.');
             }
@@ -76,23 +112,59 @@ export function createMcpServer(options) {
             }
             throw err;
         }
-        const profilesData = loadProfilesFile();
-        const activeProf = profileToUse ? profilesData.profiles[profileToUse] : undefined;
-        const origin = activeProf?.origin || auth.origin || 'https://example.com';
-        const workspaceRoot = options?.workspaceRoot ||
-            activeProf?.workspace ||
-            process.env.EMDASH_WORKSPACE ||
-            requireWorkspaceRoot();
+        const resolvedProf = explicitProf ||
+            (auth.profileName ? profilesData.profiles[auth.profileName] : undefined) ||
+            cwdProf?.config;
+        // An auto-resolved profile may only override the workspace config when none was requested.
+        const autoProf = profileToUse ? undefined : resolvedProf;
+        const workspaceRoot = preResolvedWorkspace || resolvedProf?.workspace || auth.workspace || requireWorkspaceRoot();
         const paths = getWorkspacePaths(workspaceRoot);
         const cache = options?.cache || new CacheDatabase(paths.dbPath);
-        const config = loadConfig(paths.configPath);
+        const config = preConfig && preResolvedWorkspace === workspaceRoot ? preConfig : loadConfig(workspaceRoot);
+        const configuredOrigin = config.origin !== DEFAULT_ORIGIN ? config.origin : undefined;
+        const resolution = resolveOriginPriority({
+            explicitProfileName: profileToUse,
+            explicitProfileOrigin: explicitProf?.origin,
+            envOrigin,
+            configuredOrigin,
+            autoProfileOrigin: autoProf?.origin,
+            autoProfileName: auth.profileName || cwdProf?.name,
+            authOrigin: auth.origin,
+        });
+        let resolvedBy = 'default';
+        if (auth.source === 'env') {
+            resolvedBy = 'env';
+        }
+        else if (profileToUse) {
+            resolvedBy = 'explicit-profile-argument';
+        }
+        else if (cwdProf) {
+            resolvedBy = 'workspace-directory-match';
+        }
+        else if (auth.workspace) {
+            resolvedBy = 'workspace-origin-match';
+        }
+        else if (auth.source === 'profile') {
+            resolvedBy = 'single-profile-fallback';
+        }
+        else {
+            resolvedBy = auth.source;
+        }
+        const meta = {
+            profile: auth.profileName || activeProfileOverride || 'default',
+            workspace: workspaceRoot,
+            origin: resolution.origin,
+            resolvedBy,
+        };
         return {
             root: workspaceRoot,
             paths,
             cache,
             config,
             auth,
-            origin,
+            origin: resolution.origin,
+            originWarning: resolution.warning || undefined,
+            meta,
         };
     };
     const server = new McpServer({
@@ -107,12 +179,16 @@ export function createMcpServer(options) {
         setActiveOverride: (name) => {
             activeProfileOverride = name;
         },
+        profilesPath: options?.profilesPath,
     });
     registerSyncNewTool(server, resolveContext);
     registerSyncPullTools(server, resolveContext);
     registerSyncPushTool(server, resolveContext);
     registerSyncStatusTool(server, resolveContext);
     registerSyncDiffTool(server, resolveContext);
+    registerSyncDeleteTool(server, resolveContext);
+    registerSyncConflictsTool(server, resolveContext);
+    registerSyncDoctorTool(server, resolveContext);
     return server;
 }
 /**

package/dist/mcp/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAOxD,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBpC,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,UAAU,eAAe,CAAC,OAAgC;IAC9D,IAAI,qBAAyC,CAAC;IAE9C,gEAAgE;IAChE,MAAM,cAAc,GAAoB,CAAC,aAAsB,EAAiB,EAAE;QAChF,MAAM,YAAY,GAAG,aAAa,IAAI,qBAAqB,CAAC;QAC5D,IAAI,IAAI,CAAC;QACT,IAAI,CAAC;YACH,IAAI,GAAG,WAAW,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;YAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAI,GAAG,YAAY,qBAAqB,EAAE,CAAC;gBACzC,MAAM,IAAI,KAAK,CACb,yGAAyG,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5I,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,MAAM,YAAY,GAAG,gBAAgB,EAAE,CAAC;QACxC,MAAM,UAAU,GAAG,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAClF,MAAM,MAAM,GAAG,UAAU,EAAE,MAAM,IAAI,IAAI,CAAC,MAAM,IAAI,qBAAqB,CAAC;QAE1E,MAAM,aAAa,GACjB,OAAO,EAAE,aAAa;YACtB,UAAU,EAAE,SAAS;YACrB,OAAO,CAAC,GAAG,CAAC,gBAAgB;YAC5B,oBAAoB,EAAE,CAAC;QAEzB,MAAM,KAAK,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,IAAI,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAE5C,OAAO;YACL,IAAI,EAAE,aAAa;YACnB,KAAK;YACL,KAAK;YACL,MAAM;YACN,IAAI;YACJ,MAAM;SACP,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,iBAAiB,EAAE;KAC7B,EACD;QACE,YAAY,EAAE,qBAAqB;KACpC,CACF,CAAC;IAEF,yBAAyB;IACzB,oBAAoB,CAAC,MAAM,EAAE;QAC3B,iBAAiB,EAAE,GAAG,EAAE,CAAC,qBAAqB;QAC9C,iBAAiB,EAAE,CAAC,IAAI,EAAE,EAAE;YAC1B,qBAAqB,GAAG,IAAI,CAAC;QAC/B,CAAC;KACF,CAAC,CAAC;IACH,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,qBAAqB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC9C,oBAAoB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC7C,sBAAsB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC/C,oBAAoB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAE7C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAgC;IACjE,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,8CAA8C;AAC9C,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QAC3B,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tool-errors.d.ts

@@ -0,0 +1,16 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { McpMeta } from './context.js';
+/**
+ * Formats a successful MCP response as formatted JSON with optional _meta context.
+ */
+export declare function formatToolSuccess(data: Record<string, unknown>, meta?: McpMeta): CallToolResult;
+/**
+ * Formats a known Emit error into a structured MCP tool result with optional _meta context.
+ *
+ * Without this, the MCP SDK converts a thrown error into `createToolError(String(error))`,
+ * which keeps only `error.message` and silently drops the structured diagnostics
+ * (`[CODE]`, HTTP status, endpoint, suggestion) that CLI users receive through
+ * `ApiError.toActionableString()`. AI agents need the same actionable detail.
+ */
+export declare function formatToolError(error: unknown, meta?: McpMeta): CallToolResult;
+//# sourceMappingURL=tool-errors.d.ts.map

package/dist/mcp/tool-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-errors.d.ts","sourceRoot":"","sources":["../../src/mcp/tool-errors.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAyB5C;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,cAAc,CAU/F;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,cAAc,CAwH9E"}

package/dist/mcp/tool-errors.js

@@ -0,0 +1,137 @@
+/*
+ * 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 { ApiError } from '../client/error.js';
+import { SyncPruneConflictError } from '../sync/orchestrator.js';
+import { PushValidationError } from '../sync/push.js';
+import { AmbiguousProfileError } from '../utils/profile.js';
+import { FrontmatterParseError } from '../utils/frontmatter.js';
+import { DuplicateSlugError } from '../sync/new.js';
+import { UnpushedModificationsError, PublishedArticleDeletionForbiddenError, } from '../sync/delete.js';
+import { CanonicalHasUnpushedEditsError, QuarantinedPathRequiredError } from '../sync/conflicts.js';
+function toolError(text) {
+    return {
+        isError: true,
+        content: [
+            {
+                type: 'text',
+                text,
+            },
+        ],
+    };
+}
+/**
+ * Formats a successful MCP response as formatted JSON with optional _meta context.
+ */
+export function formatToolSuccess(data, meta) {
+    const payload = meta ? { ...data, _meta: meta } : data;
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(payload, null, 2),
+            },
+        ],
+    };
+}
+/**
+ * Formats a known Emit error into a structured MCP tool result with optional _meta context.
+ *
+ * Without this, the MCP SDK converts a thrown error into `createToolError(String(error))`,
+ * which keeps only `error.message` and silently drops the structured diagnostics
+ * (`[CODE]`, HTTP status, endpoint, suggestion) that CLI users receive through
+ * `ApiError.toActionableString()`. AI agents need the same actionable detail.
+ */
+export function formatToolError(error, meta) {
+    const metaSuffix = meta ? `\n\n_meta: ${JSON.stringify(meta)}` : '';
+    if (error instanceof ApiError) {
+        return toolError(error.toActionableString() + metaSuffix);
+    }
+    if (error instanceof PushValidationError) {
+        return toolError(JSON.stringify({
+            error: 'PREFLIGHT_VALIDATION_FAILED',
+            message: error.message,
+            errors: error.errors,
+            ...(meta ? { _meta: meta } : {}),
+        }, null, 2));
+    }
+    if (error instanceof FrontmatterParseError) {
+        return toolError(JSON.stringify({
+            error: error.code,
+            message: error.message,
+            filePath: error.filePath,
+            line: error.line,
+            reason: error.reason,
+            suggestion: error.suggestion,
+            ...(meta ? { _meta: meta } : {}),
+        }, null, 2));
+    }
+    if (error instanceof DuplicateSlugError) {
+        return toolError(JSON.stringify({
+            error: error.code,
+            message: error.message,
+            slug: error.slug,
+            existingId: error.existingId,
+            existingFilePath: error.existingFilePath,
+            existingStatus: error.existingStatus,
+            suggestion: error.suggestion,
+            ...(meta ? { _meta: meta } : {}),
+        }, null, 2));
+    }
+    if (error instanceof UnpushedModificationsError ||
+        error instanceof PublishedArticleDeletionForbiddenError) {
+        return toolError(JSON.stringify({
+            error: error.code,
+            message: error.message,
+            filePath: error.filePath,
+            id: error.id,
+            suggestion: error.suggestion,
+            ...(meta ? { _meta: meta } : {}),
+        }, null, 2));
+    }
+    if (error instanceof CanonicalHasUnpushedEditsError) {
+        return toolError(JSON.stringify({
+            error: error.code,
+            message: error.message,
+            canonicalFilePath: error.canonicalFilePath,
+            conflictFilePath: error.conflictFilePath,
+            id: error.id,
+            suggestion: error.suggestion,
+            ...(meta ? { _meta: meta } : {}),
+        }, null, 2));
+    }
+    if (error instanceof QuarantinedPathRequiredError) {
+        return toolError(JSON.stringify({
+            error: error.code,
+            message: error.message,
+            filePath: error.filePath,
+            collection: error.collection,
+            suggestion: error.suggestion,
+            ...(meta ? { _meta: meta } : {}),
+        }, null, 2));
+    }
+    if (error instanceof SyncPruneConflictError || error instanceof AmbiguousProfileError) {
+        return toolError(`❌ ${error.message}${metaSuffix}`);
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return toolError(`❌ ${message}${metaSuffix}`);
+}
+//# sourceMappingURL=tool-errors.js.map

package/dist/mcp/tool-errors.js.map

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

package/dist/mcp/tools/profile.d.ts

@@ -1,6 +1,13 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerProfileTools(server: McpServer, options: {
+export interface ProfileToolOptions {
     getActiveOverride: () => string | undefined;
     setActiveOverride: (name: string | undefined) => void;
-}): void;
+    /**
+     * Custom profiles.yaml path forwarded from createMcpServer. When set, profile tools read and
+     * write exactly the same file the sync tools resolve against, so an embedded server never
+     * reports profiles it cannot actually use.
+     */
+    profilesPath?: string;
+}
+export declare function registerProfileTools(server: McpServer, options: ProfileToolOptions): void;
 //# sourceMappingURL=profile.d.ts.map

package/dist/mcp/tools/profile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/profile.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE;IACP,iBAAiB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC5C,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CACvD,GACA,IAAI,CA0EN"}
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/profile.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC5C,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACtD;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAwFzF"}

package/dist/mcp/tools/profile.js

@@ -21,28 +21,38 @@
  */
 import { z } from 'zod';
 import { loadProfilesFile, setActiveProfile } from '../../utils/profile.js';
+import { formatToolError } from '../tool-errors.js';
 export function registerProfileTools(server, options) {
     // profile_list: List available profiles and indicate active one
-    server.tool('profile_list', 'List configured site profiles from ~/.config/emit/profiles.yaml, showing their origin URLs, workspace roots, and active selection.', {}, async () => {
-        const data = loadProfilesFile();
-        const currentActive = options.getActiveOverride() || data.active;
-        const profiles = Object.entries(data.profiles).map(([name, p]) => ({
-            name,
-            origin: p.origin,
-            workspace: p.workspace,
-            active: name === currentActive,
-        }));
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        activeProfile: currentActive,
-                        profiles,
-                    }, null, 2),
-                },
-            ],
-        };
+    server.tool('profile_list', 'List configured site profiles from the Emit profiles file (~/.config/emit/profiles.yaml by default), showing their origin URLs, workspace roots, and active selection.', {}, async () => {
+        try {
+            const data = loadProfilesFile(options.profilesPath);
+            const currentActive = options.getActiveOverride() || data.active;
+            const profiles = Object.entries(data.profiles).map(([name, p]) => ({
+                name,
+                origin: p.origin,
+                workspace: p.workspace,
+                active: name === currentActive,
+            }));
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            activeProfile: currentActive,
+                            profiles,
+                            _meta: {
+                                activeProfile: currentActive,
+                                profilesPath: options.profilesPath || '~/.config/emit/profiles.yaml',
+                            },
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return formatToolError(error);
+        }
     });
     // profile_switch: Switch active profile for this session or globally
     server.tool('profile_switch', 'Switch the active site profile for the current MCP session (or globally with persist: true) when managing multiple EmDash instances.', {
@@ -50,32 +60,39 @@ export function registerProfileTools(server, options) {
         persist: z
             .boolean()
             .optional()
-            .describe('If true, updates active profile in ~/.config/emit/profiles.yaml permanently'),
+            .describe('If true, updates active profile in profiles.yaml permanently'),
     }, async (args) => {
-        const data = loadProfilesFile();
-        if (!data.profiles[args.name]) {
+        try {
+            const data = loadProfilesFile(options.profilesPath);
+            if (!data.profiles[args.name]) {
+                // Marked as a tool error so clients/agents can branch on isError instead of scraping text.
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: 'text',
+                            text: `❌ Profile "${args.name}" not found. Available profiles: ${Object.keys(data.profiles).join(', ') || 'none'}.`,
+                        },
+                    ],
+                };
+            }
+            if (args.persist) {
+                setActiveProfile(args.name, options.profilesPath);
+            }
+            options.setActiveOverride(args.name);
+            const p = data.profiles[args.name];
             return {
                 content: [
                     {
                         type: 'text',
-                        text: `❌ Profile "${args.name}" not found. Available profiles: ${Object.keys(data.profiles).join(', ') || 'none'}.`,
+                        text: `✅ Switched active profile to "${args.name}" (origin: ${p.origin}, workspace: ${p.workspace}${args.persist ? ', persisted to profiles.yaml' : ''}).`,
                     },
                 ],
             };
         }
-        if (args.persist) {
-            setActiveProfile(args.name);
+        catch (error) {
+            return formatToolError(error);
         }
-        options.setActiveOverride(args.name);
-        const p = data.profiles[args.name];
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `✅ Switched active profile to "${args.name}" (origin: ${p.origin}, workspace: ${p.workspace}${args.persist ? ', persisted to profiles.yaml' : ''}).`,
-                },
-            ],
-        };
     });
 }
 //# sourceMappingURL=profile.js.map

package/dist/mcp/tools/profile.js.map

@@ -1 +1 @@
-{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../../src/mcp/tools/profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE5E,MAAM,UAAU,oBAAoB,CAClC,MAAiB,EACjB,OAGC;IAED,gEAAgE;IAChE,MAAM,CAAC,IAAI,CACT,cAAc,EACd,oIAAoI,EACpI,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAC;QAChC,MAAM,aAAa,GAAG,OAAO,CAAC,iBAAiB,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC;QACjE,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjE,IAAI;YACJ,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,MAAM,EAAE,IAAI,KAAK,aAAa;SAC/B,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,aAAa,EAAE,aAAa;wBAC5B,QAAQ;qBACT,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,qEAAqE;IACrE,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,sIAAsI,EACtI;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QACtD,OAAO,EAAE,CAAC;aACP,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,6EAA6E,CAAC;KAC3F,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,cAAc,IAAI,CAAC,IAAI,oCAAoC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG;qBACpH;iBACF;aACF,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAErC,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,iCAAiC,IAAI,CAAC,IAAI,cAAc,CAAC,CAAC,MAAM,gBAAgB,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,EAAE,IAAI;iBAC3J;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../../src/mcp/tools/profile.ts"],"names":[],"mappings":"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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync-conflicts.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/sync-conflicts.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,eAAe,CAAC;AAIpE,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,eAAe,GAC9B,IAAI,CAwGN"}

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

@@ -0,0 +1,100 @@
+/*
+ * 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 { listConflicts, diffConflict, resolveConflict } from '../../sync/conflicts.js';
+import { formatToolError, formatToolSuccess } from '../tool-errors.js';
+export function registerSyncConflictsTool(server, resolveContext) {
+    server.tool('sync_conflicts', 'Manage quarantined sync conflict copies (.conflict.md) and deletion rescue backups (.deleted.md) in posts/conflicts/. Actions: "list" (view quarantined files and types), "diff" (inspect line-by-line differences against canonical live article), and "resolve" (strategy "accept-local" to restore/replace canonical article, or "accept-canonical" to discard quarantined copy).', {
+        action: z
+            .enum(['list', 'diff', 'resolve'])
+            .describe('Operation to perform: "list", "diff", or "resolve"'),
+        filePath: z
+            .string()
+            .optional()
+            .describe('Target conflict file path or filename in posts/conflicts/ (required for diff and resolve)'),
+        strategy: z
+            .enum(['accept-local', 'accept-canonical'])
+            .optional()
+            .describe('Resolution strategy for action="resolve": "accept-local" (restore/apply quarantined copy) or "accept-canonical" (discard quarantined copy)'),
+        force: z
+            .boolean()
+            .optional()
+            .describe('Force overwrite canonical article even if it has unpushed local modifications'),
+        collection: z
+            .string()
+            .optional()
+            .describe('Collection containing conflicts (defaults to "posts")'),
+        profile: z.string().optional().describe('Target profile name for multi-site setups'),
+    }, async (args) => {
+        let ctx;
+        try {
+            ctx = resolveContext(args.profile);
+        }
+        catch (error) {
+            return formatToolError(error);
+        }
+        const collection = args.collection || ctx.config.defaultCollection || 'posts';
+        try {
+            if (args.action === 'list') {
+                const items = listConflicts(ctx.root, collection);
+                return formatToolSuccess({
+                    conflicts: items,
+                    count: items.length,
+                    collection,
+                }, ctx.meta);
+            }
+            if (args.action === 'diff') {
+                if (!args.filePath) {
+                    return formatToolError(new Error('action="diff" requires "filePath" parameter.'), ctx.meta);
+                }
+                const diffResult = diffConflict({
+                    workspaceRoot: ctx.root,
+                    filePath: args.filePath,
+                    collection,
+                });
+                return formatToolSuccess(diffResult, ctx.meta);
+            }
+            if (args.action === 'resolve') {
+                if (!args.filePath) {
+                    return formatToolError(new Error('action="resolve" requires "filePath" parameter.'), ctx.meta);
+                }
+                if (!args.strategy) {
+                    return formatToolError(new Error('action="resolve" requires "strategy" parameter ("accept-local" or "accept-canonical").'), ctx.meta);
+                }
+                const res = resolveConflict({
+                    workspaceRoot: ctx.root,
+                    cache: ctx.cache,
+                    filePath: args.filePath,
+                    strategy: args.strategy,
+                    force: args.force,
+                    collection,
+                });
+                return formatToolSuccess(res, ctx.meta);
+            }
+            return formatToolError(new Error(`Unknown action "${args.action}". Must be "list", "diff", or "resolve".`), ctx.meta);
+        }
+        catch (err) {
+            return formatToolError(err, ctx.meta);
+        }
+    });
+}
+//# sourceMappingURL=sync-conflicts.js.map