emdash-emit 0.1.18 → 0.1.30

package/dist/db/migrations.js

@@ -0,0 +1,320 @@
+/*
+ * 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 { getPackageVersion } from '../utils/version.js';
+export const CURRENT_CACHE_SCHEMA_VERSION = 5;
+function pruneBackups(dbPath) {
+    if (dbPath === ':memory:')
+        return;
+    try {
+        const dbDir = path.dirname(dbPath);
+        const dbBase = path.basename(dbPath);
+        if (!fs.existsSync(dbDir))
+            return;
+        const backupFiles = fs
+            .readdirSync(dbDir)
+            .filter((f) => f.startsWith(`${dbBase}.bak-`))
+            .map((f) => path.join(dbDir, f));
+        // 1. Unconditionally purge 0-byte backup files
+        const validBackups = [];
+        for (const bak of backupFiles) {
+            try {
+                const stat = fs.statSync(bak);
+                if (stat.size === 0) {
+                    fs.unlinkSync(bak);
+                }
+                else {
+                    validBackups.push(bak);
+                }
+            }
+            catch {
+                // Ignore stat/unlink errors
+            }
+        }
+        // 2. Retain up to 3 newest valid backups
+        validBackups.sort((a, b) => {
+            try {
+                return fs.statSync(b).mtimeMs - fs.statSync(a).mtimeMs;
+            }
+            catch {
+                return 0;
+            }
+        });
+        if (validBackups.length > 3) {
+            for (const oldBak of validBackups.slice(3)) {
+                try {
+                    fs.unlinkSync(oldBak);
+                }
+                catch {
+                    // Ignore unlink errors
+                }
+            }
+        }
+    }
+    catch {
+        // Ignore backup prune errors
+    }
+}
+/**
+ * Initializes SQLite schema tables and executes versioned migrations up to CURRENT_CACHE_SCHEMA_VERSION.
+ */
+export function runCacheMigrations(db, dbPath = ':memory:') {
+    // Enable WAL mode for better concurrency and write performance
+    db.exec('PRAGMA journal_mode = WAL;');
+    // 1. entries table: remote state cache
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS entries (
+      id TEXT PRIMARY KEY,
+      collection TEXT NOT NULL,
+      slug TEXT NOT NULL,
+      status TEXT NOT NULL,
+      title TEXT NOT NULL,
+      rev TEXT NOT NULL,
+      published_at TEXT,
+      raw_json TEXT NOT NULL,
+      updated_at INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_entries_collection ON entries (collection);
+    CREATE INDEX IF NOT EXISTS idx_entries_slug ON entries (slug);
+  `);
+    // 2. base_snapshots table: baseline state for 3-way merge
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS base_snapshots (
+      id TEXT PRIMARY KEY,
+      rev TEXT NOT NULL,
+      body_markdown TEXT NOT NULL,
+      frontmatter_yaml TEXT NOT NULL,
+      hash TEXT NOT NULL,
+      saved_at INTEGER NOT NULL
+    );
+  `);
+    // 3. sync_state table: local path tracking & dirty change detection
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS sync_state (
+      id TEXT PRIMARY KEY,
+      local_file_path TEXT NOT NULL,
+      local_hash TEXT NOT NULL,
+      remote_rev TEXT NOT NULL,
+      status TEXT NOT NULL,
+      slug TEXT NOT NULL,
+      last_synced_at INTEGER NOT NULL,
+      conflict_pending INTEGER NOT NULL DEFAULT 0,
+      body_conflict_pending INTEGER NOT NULL DEFAULT 0,
+      taxonomy_conflict_pending INTEGER NOT NULL DEFAULT 0,
+      delete_pending INTEGER NOT NULL DEFAULT 0,
+      conflict_copy_hash TEXT,
+      conflict_copy_path TEXT,
+      conflict_at INTEGER,
+      remote_taxonomy_hash TEXT,
+      taxonomy_apply_pending INTEGER NOT NULL DEFAULT 0
+    );
+    CREATE INDEX IF NOT EXISTS idx_sync_state_file_path ON sync_state (local_file_path);
+  `);
+    // 4. bylines table: local cache for author/byline resolution
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS bylines (
+      id TEXT PRIMARY KEY,
+      slug TEXT NOT NULL UNIQUE,
+      display_name TEXT NOT NULL,
+      is_guest INTEGER NOT NULL DEFAULT 0,
+      raw_json TEXT NOT NULL DEFAULT '{}',
+      updated_at INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_bylines_slug ON bylines (slug);
+  `);
+    // 5. media_state table: local draft media upload tracking & idempotency (Schema v5)
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS media_state (
+      storage_key TEXT PRIMARY KEY,
+      media_id TEXT NOT NULL,
+      local_content_hash TEXT,
+      remote_record_ref TEXT,
+      url TEXT NOT NULL,
+      workspace_path TEXT,
+      markdown_ref TEXT,
+      status TEXT NOT NULL,
+      uploaded_at INTEGER
+    );
+    CREATE INDEX IF NOT EXISTS idx_media_state_media_id ON media_state (media_id);
+    CREATE INDEX IF NOT EXISTS idx_media_state_status ON media_state (status);
+  `);
+    const versionRow = db.prepare('PRAGMA user_version;').get();
+    const currentVersion = Number(versionRow?.user_version || 0);
+    // Guard against opening a database created by a newer version of emdash-emit
+    if (currentVersion > CURRENT_CACHE_SCHEMA_VERSION) {
+        throw new Error(`[CACHE_SCHEMA_MISMATCH] Cache database at ${dbPath} was created with schema version ${currentVersion}, but current emit supports up to ${CURRENT_CACHE_SCHEMA_VERSION}. Please upgrade emdash-emit.`);
+    }
+    if (currentVersion < CURRENT_CACHE_SCHEMA_VERSION) {
+        // 1. Backup database before running migration via SQLite native VACUUM INTO
+        if (dbPath !== ':memory:' && fs.existsSync(dbPath)) {
+            try {
+                const version = getPackageVersion();
+                const versionStr = version !== 'unknown' ? version : CURRENT_CACHE_SCHEMA_VERSION;
+                const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+                const bakPath = `${dbPath}.bak-${versionStr}-${timestamp}`;
+                db.prepare('VACUUM INTO ?').run(bakPath);
+            }
+            catch {
+                // Ignore in-memory or constrained test environments
+            }
+        }
+        // Unconditionally sweep 0-byte or excess backups
+        pruneBackups(dbPath);
+        // Migration 1 & 2: schema columns from v1 and v2 if missing
+        const columns = db.prepare("PRAGMA table_info('sync_state');").all();
+        const columnNames = new Set(columns.map((c) => String(c.name)));
+        if (!columnNames.has('conflict_pending')) {
+            db.exec('ALTER TABLE sync_state ADD COLUMN conflict_pending INTEGER NOT NULL DEFAULT 0;');
+        }
+        if (!columnNames.has('delete_pending')) {
+            db.exec('ALTER TABLE sync_state ADD COLUMN delete_pending INTEGER NOT NULL DEFAULT 0;');
+        }
+        if (!columnNames.has('conflict_copy_hash')) {
+            db.exec('ALTER TABLE sync_state ADD COLUMN conflict_copy_hash TEXT;');
+        }
+        if (!columnNames.has('conflict_copy_path')) {
+            db.exec('ALTER TABLE sync_state ADD COLUMN conflict_copy_path TEXT;');
+        }
+        if (!columnNames.has('conflict_at')) {
+            db.exec('ALTER TABLE sync_state ADD COLUMN conflict_at INTEGER;');
+        }
+        if (!columnNames.has('remote_taxonomy_hash')) {
+            db.exec('ALTER TABLE sync_state ADD COLUMN remote_taxonomy_hash TEXT;');
+        }
+        if (!columnNames.has('taxonomy_apply_pending')) {
+            db.exec('ALTER TABLE sync_state ADD COLUMN taxonomy_apply_pending INTEGER NOT NULL DEFAULT 0;');
+        }
+        // Migration 3 (v3): separate body and taxonomy conflict pending flags
+        if (!columnNames.has('body_conflict_pending')) {
+            db.exec('ALTER TABLE sync_state ADD COLUMN body_conflict_pending INTEGER NOT NULL DEFAULT 0;');
+        }
+        if (!columnNames.has('taxonomy_conflict_pending')) {
+            db.exec('ALTER TABLE sync_state ADD COLUMN taxonomy_conflict_pending INTEGER NOT NULL DEFAULT 0;');
+        }
+        // Existing rows allocation rule when upgrading to v3
+        if (currentVersion < 3) {
+            db.exec(`
+        UPDATE sync_state
+        SET body_conflict_pending = CASE
+          WHEN conflict_pending = 1 AND conflict_copy_path LIKE '%.conflict.md' THEN 1
+          WHEN conflict_pending = 1 AND remote_taxonomy_hash IS NOT NULL AND (conflict_copy_path IS NULL OR conflict_copy_path NOT LIKE '%.conflict.md') THEN 0
+          WHEN conflict_pending = 1 THEN 1
+          ELSE 0 END,
+        taxonomy_conflict_pending = CASE
+          WHEN conflict_pending = 1 AND conflict_copy_path LIKE '%.conflict.md' THEN 0
+          WHEN conflict_pending = 1 AND remote_taxonomy_hash IS NOT NULL THEN 1
+          WHEN conflict_pending = 1 THEN 1
+          ELSE 0 END
+        WHERE conflict_pending = 1;
+      `);
+        }
+        db.exec('CREATE INDEX IF NOT EXISTS idx_sync_state_conflict ON sync_state (conflict_pending);');
+        db.exec('CREATE INDEX IF NOT EXISTS idx_sync_state_body_conflict ON sync_state (body_conflict_pending);');
+        db.exec('CREATE INDEX IF NOT EXISTS idx_sync_state_tax_conflict ON sync_state (taxonomy_conflict_pending);');
+        db.exec('CREATE INDEX IF NOT EXISTS idx_sync_state_delete ON sync_state (delete_pending);');
+        db.exec('CREATE INDEX IF NOT EXISTS idx_sync_state_tax_apply ON sync_state (taxonomy_apply_pending);');
+        // Migration 4 (v4): media mirrors are named after the storageKey
+        const mediaColumns = db.prepare("PRAGMA table_info('media_state');").all();
+        const mediaColumnNames = new Set(mediaColumns.map((c) => String(c.name)));
+        if (!mediaColumnNames.has('markdown_ref')) {
+            db.exec('ALTER TABLE media_state ADD COLUMN markdown_ref TEXT;');
+        }
+        // Migration 5 (v5): recreate media_state with storage_key as PRIMARY KEY,
+        // separating local_content_hash (SHA-256) and remote_record_ref (media-record:<id>).
+        if (currentVersion < 5) {
+            const mediaCols = db.prepare("PRAGMA table_info('media_state');").all();
+            const mediaColNames = new Set(mediaCols.map((c) => String(c.name)));
+            const storageKeyCol = mediaCols.find((c) => String(c.name) === 'storage_key');
+            const isStorageKeyPk = storageKeyCol && Number(storageKeyCol.pk) > 0;
+            if (!isStorageKeyPk) {
+                db.exec('BEGIN TRANSACTION;');
+                try {
+                    db.exec(`
+            CREATE TABLE IF NOT EXISTS media_state_v5 (
+              storage_key TEXT PRIMARY KEY,
+              media_id TEXT NOT NULL,
+              local_content_hash TEXT,
+              remote_record_ref TEXT,
+              url TEXT NOT NULL,
+              workspace_path TEXT,
+              markdown_ref TEXT,
+              status TEXT NOT NULL,
+              uploaded_at INTEGER
+            );
+          `);
+                    if (mediaColNames.has('local_hash')) {
+                        const hasMarkdownRef = mediaColNames.has('markdown_ref');
+                        db.exec(`
+              INSERT INTO media_state_v5 (
+                storage_key,
+                media_id,
+                local_content_hash,
+                remote_record_ref,
+                url,
+                workspace_path,
+                markdown_ref,
+                status,
+                uploaded_at
+              )
+              SELECT
+                COALESCE(
+                  NULLIF(storage_key, ''),
+                  CASE WHEN url LIKE '%/file/%' THEN substr(url, instr(url, '/file/') + 6) ELSE 'legacy_' || media_id END
+                ) AS computed_key,
+                MAX(media_id),
+                MAX(CASE WHEN local_hash NOT LIKE 'media-record:%' THEN local_hash ELSE NULL END),
+                MAX(CASE WHEN local_hash LIKE 'media-record:%' THEN local_hash ELSE NULL END),
+                MAX(url),
+                MAX(workspace_path),
+                ${hasMarkdownRef ? 'MAX(markdown_ref)' : 'NULL'},
+                MAX(status),
+                MAX(uploaded_at)
+              FROM media_state
+              WHERE (storage_key IS NOT NULL AND storage_key != '') OR url LIKE '%/file/%'
+              GROUP BY computed_key;
+            `);
+                        db.exec('DROP TABLE media_state;');
+                    }
+                    db.exec('ALTER TABLE media_state_v5 RENAME TO media_state;');
+                    db.exec(`
+            CREATE INDEX IF NOT EXISTS idx_media_state_media_id ON media_state (media_id);
+            CREATE INDEX IF NOT EXISTS idx_media_state_status ON media_state (status);
+            CREATE INDEX IF NOT EXISTS idx_media_state_content_hash ON media_state (local_content_hash);
+          `);
+                    db.exec('COMMIT;');
+                }
+                catch (err) {
+                    db.exec('ROLLBACK;');
+                    throw err;
+                }
+            }
+        }
+        db.exec(`PRAGMA user_version = ${CURRENT_CACHE_SCHEMA_VERSION};`);
+    }
+    // Create indexes that depend on migrated columns
+    db.exec(`
+    CREATE INDEX IF NOT EXISTS idx_sync_state_conflict ON sync_state (conflict_pending);
+    CREATE INDEX IF NOT EXISTS idx_media_state_content_hash ON media_state (local_content_hash);
+  `);
+}
+//# sourceMappingURL=migrations.js.map

package/dist/db/migrations.js.map

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

package/dist/mcp/heartbeat.d.ts

@@ -1,35 +1,2 @@
-export interface McpHeartbeatState {
-    pid: number;
-    version: string;
-    startedAt: string;
-    origin?: string;
-    profile?: string;
-    workspaceRoot?: string;
-}
-export interface McpProcessCheckResult {
-    status: 'alive' | 'stale' | 'unknown' | 'none';
-    state?: McpHeartbeatState;
-    isOutdated?: boolean;
-    message?: string;
-}
-export declare function getMcpStateFilePath(): string;
-export declare function getPackageVersion(): string;
-/**
- * Records heartbeat metadata to ~/.config/emit/mcp_state.json with restricted 0600 permissions.
- */
-export declare function recordMcpHeartbeat(metadata?: string | {
-    origin?: string;
-    profile?: string;
-    workspaceRoot?: string;
-}): void;
-/**
- * Checks the status of the recorded MCP process in ~/.config/emit/mcp_state.json.
- * Handles process vitality via process.kill(pid, 0):
- * - ESRCH: Process has terminated -> cleanly remove stale state file.
- * - EPERM: Process belongs to another user on shared host -> mark unknown.
- * - Alive: Compares start time against package.json mtime to detect outdated processes.
- *
- * Note: mtime-based comparison can yield false negatives if package is downgraded.
- */
-export declare function checkMcpProcess(customPackageJsonPath?: string): McpProcessCheckResult;
+export * from '../utils/mcp-heartbeat.js';
 //# sourceMappingURL=heartbeat.d.ts.map

package/dist/mcp/heartbeat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../src/mcp/heartbeat.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAC/C,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAG5C;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAS1C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,CAAC,EACL,MAAM,GACN;IACE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACJ,IAAI,CAiBN;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,qBAAqB,CAAC,EAAE,MAAM,GAAG,qBAAqB,CAkErF"}
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../src/mcp/heartbeat.ts"],"names":[],"mappings":"AAsBA,cAAc,2BAA2B,CAAC"}

package/dist/mcp/heartbeat.js

@@ -19,117 +19,5 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-export function getMcpStateFilePath() {
-    const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
-    return path.join(home, '.config', 'emit', 'mcp_state.json');
-}
-export function getPackageVersion() {
-    try {
-        const pkgPath = fileURLToPath(new URL('../../package.json', import.meta.url));
-        const content = fs.readFileSync(pkgPath, 'utf8');
-        const parsed = JSON.parse(content);
-        return parsed.version || 'unknown';
-    }
-    catch {
-        return 'unknown';
-    }
-}
-/**
- * Records heartbeat metadata to ~/.config/emit/mcp_state.json with restricted 0600 permissions.
- */
-export function recordMcpHeartbeat(metadata) {
-    try {
-        const filePath = getMcpStateFilePath();
-        fs.mkdirSync(path.dirname(filePath), { recursive: true, mode: 0o700 });
-        const metaObj = typeof metadata === 'string' ? { origin: metadata } : metadata || {};
-        const payload = {
-            pid: process.pid,
-            version: getPackageVersion(),
-            startedAt: new Date().toISOString(),
-            ...(metaObj.origin ? { origin: metaObj.origin } : {}),
-            ...(metaObj.profile ? { profile: metaObj.profile } : {}),
-            ...(metaObj.workspaceRoot ? { workspaceRoot: metaObj.workspaceRoot } : {}),
-        };
-        fs.writeFileSync(filePath, JSON.stringify(payload, null, 2), { mode: 0o600 });
-    }
-    catch {
-        // Non-fatal if filesystem is restricted or read-only
-    }
-}
-/**
- * Checks the status of the recorded MCP process in ~/.config/emit/mcp_state.json.
- * Handles process vitality via process.kill(pid, 0):
- * - ESRCH: Process has terminated -> cleanly remove stale state file.
- * - EPERM: Process belongs to another user on shared host -> mark unknown.
- * - Alive: Compares start time against package.json mtime to detect outdated processes.
- *
- * Note: mtime-based comparison can yield false negatives if package is downgraded.
- */
-export function checkMcpProcess(customPackageJsonPath) {
-    const filePath = getMcpStateFilePath();
-    if (!fs.existsSync(filePath)) {
-        return { status: 'none' };
-    }
-    let state;
-    try {
-        const content = fs.readFileSync(filePath, 'utf8');
-        state = JSON.parse(content);
-    }
-    catch {
-        return { status: 'none' };
-    }
-    try {
-        // Probe process vitality
-        process.kill(state.pid, 0);
-    }
-    catch (err) {
-        const code = err.code;
-        if (code === 'ESRCH') {
-            // Process is dead: clean up stale heartbeat file
-            try {
-                fs.unlinkSync(filePath);
-            }
-            catch {
-                // Ignore unlink error
-            }
-            return { status: 'stale', state };
-        }
-        if (code === 'EPERM') {
-            // Process belongs to another user
-            return { status: 'unknown', state };
-        }
-        return { status: 'unknown', state };
-    }
-    // Process is alive: check if outdated
-    let isOutdated = false;
-    let message;
-    try {
-        const pkgPath = customPackageJsonPath || fileURLToPath(new URL('../../package.json', import.meta.url));
-        if (fs.existsSync(pkgPath)) {
-            const pkgStat = fs.statSync(pkgPath);
-            const pkgContent = fs.readFileSync(pkgPath, 'utf8');
-            const pkgJson = JSON.parse(pkgContent);
-            const currentPkgVersion = pkgJson.version || '';
-            const startedMs = new Date(state.startedAt).getTime();
-            const mtimeMs = pkgStat.mtimeMs;
-            if (state.version !== currentPkgVersion || startedMs < mtimeMs) {
-                isOutdated = true;
-                message = `An MCP server process (PID ${state.pid}, version ${state.version}) is currently running from a previous installation. Restart your IDE or MCP client to activate version ${currentPkgVersion}.`;
-            }
-        }
-    }
-    catch {
-        // Ignore version check errors
-    }
-    return {
-        status: 'alive',
-        state,
-        isOutdated,
-        message,
-    };
-}
+export * from '../utils/mcp-heartbeat.js';
 //# sourceMappingURL=heartbeat.js.map

package/dist/mcp/heartbeat.js.map

@@ -1 +1 @@
-{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../src/mcp/heartbeat.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../src/mcp/heartbeat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,cAAc,2BAA2B,CAAC"}

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

@@ -1,9 +1,20 @@
 import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import type { McpMeta } from './context.js';
+import type { ContextResolver, McpMeta, ServerContext } 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 successful plain-text MCP response with optional _meta context suffix.
+ */
+export declare function formatToolTextWithMeta(text: string, meta?: McpMeta, trailingText?: string): CallToolResult;
+/**
+ * Resolves the MCP ServerContext inside a guarded try/catch block so any profile/workspace
+ * resolution error or subsequent handler exception is returned as a structured MCP tool error.
+ */
+export declare function withResolvedContext<TArgs extends {
+    profile?: string;
+}>(resolveContext: ContextResolver, args: TArgs, handler: (ctx: ServerContext) => Promise<CallToolResult> | CallToolResult): Promise<CallToolResult>;
 /**
  * Formats a known Emit error into a structured MCP tool result with optional _meta context.
  *

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

@@ -1 +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"}
+{"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,eAAe,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAyB5E;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,cAAc,CAU/F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,YAAY,CAAC,EAAE,MAAM,GACpB,cAAc,CAWhB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,SAAS;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1E,cAAc,EAAE,eAAe,EAC/B,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,GACxE,OAAO,CAAC,cAAc,CAAC,CAQzB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,cAAc,CAwH9E"}

package/dist/mcp/tool-errors.js

@@ -52,6 +52,35 @@ export function formatToolSuccess(data, meta) {
         ],
     };
 }
+/**
+ * Formats a successful plain-text MCP response with optional _meta context suffix.
+ */
+export function formatToolTextWithMeta(text, meta, trailingText) {
+    const metaSuffix = meta ? `\n\n_meta: ${JSON.stringify(meta)}` : '';
+    const tail = trailingText ? `\n\n${trailingText}` : '';
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `${text}${metaSuffix}${tail}`,
+            },
+        ],
+    };
+}
+/**
+ * Resolves the MCP ServerContext inside a guarded try/catch block so any profile/workspace
+ * resolution error or subsequent handler exception is returned as a structured MCP tool error.
+ */
+export async function withResolvedContext(resolveContext, args, handler) {
+    let ctx;
+    try {
+        ctx = resolveContext(args.profile);
+        return await handler(ctx);
+    }
+    catch (error) {
+        return formatToolError(error, ctx?.meta);
+    }
+}
 /**
  * Formats a known Emit error into a structured MCP tool result with optional _meta context.
  *

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

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

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

@@ -1 +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;AASpE,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,eAAe,GAC9B,IAAI,CAsIN"}
+{"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,EAAE,MAAM,eAAe,CAAC;AASrD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,eAAe,GAC9B,IAAI,CA4HN"}