emdash-emit 0.1.14 → 0.1.15

package/dist/sync/guards.js

@@ -0,0 +1,235 @@
+/**
+ * Canonical registry of preflight guards, authoring safety checks, and known error codes.
+ *
+ * This file is the single source of truth for:
+ * 1. Numbered safety guards (G1 through G19).
+ * 2. Operational ApiErrors emitted by network/push/media transport layers.
+ * 3. Standing protection errors raised by dedicated error classes.
+ *
+ * Verified against src/ via tests/guards.test.ts to guarantee zero drift.
+ */
+/**
+ * Operational ApiErrors (network, lock, HTTP transport, server reject).
+ * They report a failed system operation rather than a rejected authoring intent.
+ * Exhaustively enumerated against src/ to ensure the rogue-code check in tests/guards.test.ts is total.
+ */
+export const OPERATIONAL_ERROR_CODES = [
+    // push / publish transport
+    'PUSH_CREATE_FAILED',
+    'PUSH_FAILED',
+    'PUSH_RETRY_FAILED',
+    'PUBLISH_FAILED',
+    'UNPUBLISH_FAILED',
+    'REMOTE_ARTICLE_DELETED',
+    'CONFLICT_REMOTE_FETCH_FAILED',
+    // taxonomy transport (push.ts / taxonomies.ts)
+    'TAXONOMY_UPDATE_FAILED',
+    'TAXONOMY_DIVERGENCE',
+    'TAXONOMY_UNION_REJECTED',
+    'TAXONOMY_FETCH_FAILED',
+    // lock lease (client/lock.ts, thrown as EntryLockError('ENTRY_LOCKED'))
+    'ENTRY_LOCKED',
+    // media upload transport (client/media.ts)
+    'MEDIA_UPLOAD_URL_FAILED',
+    'MEDIA_BINARY_UPLOAD_FAILED',
+    'MEDIA_CONFIRM_FAILED',
+    'MEDIA_NOT_READY',
+    // list / fetch failures
+    'ARTICLE_LIST_FAILED',
+    'ARTICLE_PULL_FAILED',
+    'ARTICLE_NOT_FOUND',
+    'MEDIA_LIST_FAILED',
+    'NETWORK_ERROR',
+    // delete transport (sync/delete.ts)
+    'REMOTE_DELETE_FAILED',
+    'REMOTE_DELETE_UNCONFIRMED',
+];
+/**
+ * Standing protection errors raised by dedicated error classes rather than ApiError.
+ * They guard destructive operations (e.g. deleting published or modified articles)
+ * or fundamental parsing, living outside GUARD_REGISTRY.
+ */
+export const PROTECTION_ERROR_CODES = [
+    'UNPUSHED_CHANGES_PROTECTION', // sync/delete.ts (UnpushedModificationsError)
+    'PUBLISHED_ARTICLE_PROTECTION', // sync/delete.ts (PublishedArticleDeletionForbiddenError)
+    'FRONTMATTER_PARSE_ERROR', // utils/frontmatter.ts (FrontmatterParseError)
+];
+export const GUARD_REGISTRY = [
+    {
+        id: 1,
+        name: 'SINGLE_TARGET_GUARD',
+        codes: [],
+        stage: 'cli-mcp',
+        severity: 'error',
+        source: 'src/sync/preflight.ts:358',
+        description: 'CLI / MCP 呼び出し層での単一ファイル指定強制（一括 Push の抑止）',
+    },
+    {
+        id: 2,
+        name: 'ID_MISMATCH_ERROR',
+        codes: ['ID_MISMATCH_ERROR'],
+        stage: 'preflight',
+        severity: 'error',
+        source: 'src/sync/preflight.ts:377',
+        description: 'ファイルパスと Frontmatter 内 ULID の整合性検証',
+    },
+    {
+        id: 3,
+        name: 'UNINTENDED_PUBLISH_GUARD',
+        codes: ['UNINTENDED_PUBLISH_GUARD'],
+        stage: 'preflight',
+        severity: 'error',
+        source: 'src/sync/preflight.ts:389',
+        description: '明示的な allowPublish 指定なしの公開昇格を防止',
+    },
+    {
+        id: 4,
+        name: 'INVALID_TAXONOMY_ERROR',
+        codes: ['INVALID_TAXONOMY_ERROR'],
+        stage: 'preflight',
+        severity: 'error',
+        source: 'src/sync/preflight.ts:440',
+        description: '未定義カテゴリ・タグの指定検知',
+    },
+    {
+        id: 5,
+        name: 'LOCAL_IMAGE_DETECTED',
+        codes: ['LOCAL_IMAGE_DETECTED', 'INLINE_LOCAL_IMAGE_NOT_SUPPORTED'],
+        stage: 'preflight',
+        severity: 'error',
+        source: 'src/sync/preflight.ts:515,608',
+        description: '本文内の未解決ローカル画像パスおよびインラインローカル画像検知',
+    },
+    {
+        id: 6,
+        name: 'UNRESOLVED_CONFLICT_MARKERS',
+        codes: ['UNRESOLVED_CONFLICT_MARKERS'],
+        stage: 'preflight',
+        severity: 'error',
+        source: 'src/sync/preflight.ts:642',
+        description: '3-Way Merge コンフリクトマーカー（<<<<<<<, =======, >>>>>>>）の残存検知',
+    },
+    {
+        id: 7,
+        name: 'TITLE_DUPLICATION_AUTOTRIM',
+        codes: [],
+        stage: 'preflight',
+        severity: 'info',
+        source: 'src/sync/preflight.ts:651-663',
+        description: '本文冒頭の重複 # Title 自動除去（cleanedBody の mutation）',
+    },
+    {
+        id: 8,
+        name: 'UNSUPPORTED_SYNTAX_WARNING',
+        codes: [],
+        stage: 'preflight',
+        severity: 'warning',
+        source: 'src/client/portable-text.ts:618',
+        description: 'Portable Text 非互換構文の警告（detectUnsupportedMarkdownSyntax）',
+    },
+    {
+        id: 9,
+        name: 'MODIFIED_OPAQUE_BLOCK',
+        codes: ['MODIFIED_OPAQUE_BLOCK'],
+        stage: 'preflight',
+        severity: 'error',
+        source: 'src/sync/preflight.ts:672',
+        description: '<!--ec:block--> 保護ブロック改ざん検知',
+    },
+    {
+        id: 10,
+        name: 'INVALID_FEATURED_IMAGE',
+        codes: ['INVALID_FEATURED_IMAGE'],
+        stage: 'preflight',
+        severity: 'error',
+        source: 'src/sync/preflight.ts:630',
+        description: 'アイキャッチ画像 ID の形式検証（26 文字 ULID または null）',
+    },
+    {
+        id: 11,
+        name: 'LOCAL_IMAGE_AUTO_UPLOAD',
+        codes: [
+            'MISSING_LOCAL_IMAGE_FILE',
+            'INVALID_LOCAL_IMAGE_TYPE',
+            'LOCAL_IMAGE_SIZE_EXCEEDED',
+            'PROMOTED_MEDIA_NOT_FOUND_REMOTE',
+        ],
+        stage: 'preflight',
+        severity: 'error',
+        source: 'src/sync/preflight.ts:545,564',
+        description: 'media/drafts/ からのオフライン画像自動アップロード・置換処理（[MEDIA_EXISTENCE_UNVERIFIED] 警告を含む）',
+    },
+    {
+        id: 12,
+        name: 'QUARANTINED_COPY_NOT_PUSHABLE',
+        codes: ['QUARANTINED_COPY_NOT_PUSHABLE'],
+        stage: 'push',
+        severity: 'error',
+        source: 'src/sync/push.ts:581',
+        description: 'conflicts/ 配下の退避ファイル直接 Push 禁止',
+    },
+    {
+        id: 13,
+        name: 'CANONICAL_HAS_UNPUSHED_EDITS',
+        codes: ['CANONICAL_HAS_UNPUSHED_EDITS'],
+        stage: 'conflicts',
+        severity: 'error',
+        source: 'src/sync/conflicts.ts:67',
+        description: 'コンフリクト解消時の未 Push ローカル編集上書き防止',
+    },
+    {
+        id: 14,
+        name: 'QUARANTINED_PATH_REQUIRED',
+        codes: ['QUARANTINED_PATH_REQUIRED'],
+        stage: 'conflicts',
+        severity: 'error',
+        source: 'src/sync/conflicts.ts:86',
+        description: 'コンフリクト対象パスの検証',
+    },
+    {
+        id: 15,
+        name: 'DELETE_PENDING_ARTICLE',
+        codes: ['DELETE_PENDING_ARTICLE'],
+        stage: 'push',
+        severity: 'error',
+        source: 'src/sync/push.ts:674',
+        description: '削除保留中記事の Push 抑止',
+    },
+    {
+        id: 16,
+        name: 'TAXONOMY_CONFLICT_PENDING',
+        codes: ['TAXONOMY_CONFLICT_PENDING'],
+        stage: 'push',
+        severity: 'error',
+        source: 'src/sync/push.ts:711',
+        description: 'タクソノミー未反映状態での Push 抑止',
+    },
+    {
+        id: 17,
+        name: 'TAXONOMY_APPLY_PENDING',
+        codes: ['TAXONOMY_APPLY_PENDING'],
+        stage: 'push',
+        severity: 'error',
+        source: 'src/sync/push.ts:726',
+        description: 'タクソノミー同期保留中の Push 抑止',
+    },
+    {
+        id: 18,
+        name: 'DUPLICATE_SLUG_CONFLICT',
+        codes: ['DUPLICATE_SLUG_CONFLICT'],
+        stage: 'new',
+        severity: 'error',
+        source: 'src/sync/new.ts:45',
+        description: '記事作成時の重複スラッグ検証',
+    },
+    {
+        id: 19,
+        name: 'DESTRUCTIVE_TAXONOMY_WIPE',
+        codes: ['DESTRUCTIVE_TAXONOMY_WIPE'],
+        stage: 'push',
+        severity: 'error',
+        source: 'src/sync/push.ts:803,1232',
+        description: 'タクソノミー全削除等の破壊的操作抑止',
+    },
+];
+//# sourceMappingURL=guards.js.map

package/dist/sync/guards.js.map

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

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

@@ -0,0 +1,15 @@
+import type { OrphanMediaDescriptor } from './types.js';
+/**
+ * Extracts every media file storageKey referenced by an article (markdown images, HTML img tags,
+ * opaque custom-block fences, and legacy container lines such as `[dimage url="..." control=true]`).
+ * A storageKey must be ULID-segment based with a known image extension, so template placeholders
+ * (`<storageKey>`) and prose never produce descriptors. The media record id is deliberately NOT
+ * inferred from it: for migrated WordPress assets the file route serves `<storageKey>` while the
+ * record id returns 404, so only the storageKey can be reported to the user.
+ */
+export declare function collectArticleStorageKeys(content: string): OrphanMediaDescriptor[];
+/**
+ * Collects all media ULIDs referenced by an article content (frontmatter featuredImage + body images).
+ */
+export declare function collectArticleReferencedMediaIds(content: string): string[];
+//# sourceMappingURL=body_scan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"body_scan.d.ts","sourceRoot":"","sources":["../../../src/sync/media/body_scan.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAuBxD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,EAAE,CA+BlF;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAwE1E"}

package/dist/sync/media/body_scan.js

@@ -0,0 +1,132 @@
+import yaml from 'js-yaml';
+import { extractMediaUlid } from '../../client/mapper.js';
+import { parseMarkdown, lenientRepairMarkdownFrontmatter } from '../../utils/frontmatter.js';
+import { scanArticleMediaReferences } from '../delete.js';
+/** Builds a descriptor from a ULID-segment storageKey, defaulting to `.jpg` when no extension is present. */
+function descriptorFromStorageKey(storageKey) {
+    const extMatch = storageKey.match(/\.[a-z]+$/i);
+    return {
+        storageKey,
+        ext: extMatch ? extMatch[0].toLowerCase() : '.jpg',
+        ulids: Array.from(storageKey.matchAll(/[0-9A-HJ-NP-Z]{26}/gi), (m) => m[0].toUpperCase()),
+    };
+}
+/** Collapses descriptors that name the same storageKey, keeping one entry per key. */
+function dedupeDescriptorsByStorageKey(descriptors) {
+    const byKey = new Map();
+    for (const descriptor of descriptors) {
+        if (!byKey.has(descriptor.storageKey))
+            byKey.set(descriptor.storageKey, descriptor);
+    }
+    return Array.from(byKey.values()).sort((a, b) => a.storageKey.localeCompare(b.storageKey));
+}
+/**
+ * Extracts every media file storageKey referenced by an article (markdown images, HTML img tags,
+ * opaque custom-block fences, and legacy container lines such as `[dimage url="..." control=true]`).
+ * A storageKey must be ULID-segment based with a known image extension, so template placeholders
+ * (`<storageKey>`) and prose never produce descriptors. The media record id is deliberately NOT
+ * inferred from it: for migrated WordPress assets the file route serves `<storageKey>` while the
+ * record id returns 404, so only the storageKey can be reported to the user.
+ */
+export function collectArticleStorageKeys(content) {
+    const keys = new Set();
+    const keyPattern = /(?:^|\/)media\/file\/([0-9A-HJ-NP-Z]{26}(?:\.[0-9A-HJ-NP-Z]{26})*\.(?:jpg|jpeg|png|gif|webp|avif|svg))/gi;
+    // A workspace that spells a mirrored image as `media/<storageKey>` names the key outright rather than
+    // through the file route, so the census must read that spelling too — otherwise an unmirrored local
+    // reference silently disappears from `referencedUnmirroredStorageKeys`.
+    const localRefPattern = /(?:^|\/)media\/([0-9A-HJ-NP-Z]{26}(?:\.[0-9A-HJ-NP-Z]{26})*\.(?:jpg|jpeg|png|gif|webp|avif|svg))/gi;
+    const harvest = (text, pattern) => {
+        let match;
+        pattern.lastIndex = 0;
+        while ((match = pattern.exec(text)) !== null) {
+            keys.add(match[1]);
+        }
+    };
+    // scanArticleMediaReferences covers markdown images and HTML img tags anywhere in the body,
+    // including inside opaque fences and legacy container lines where doctor stays quiet by design.
+    const scannedRefs = scanArticleMediaReferences(content).join('\n');
+    harvest(scannedRefs, keyPattern);
+    harvest(content, keyPattern);
+    harvest(scannedRefs, localRefPattern);
+    harvest(content, localRefPattern);
+    const descriptors = [];
+    for (const storageKey of keys) {
+        descriptors.push(descriptorFromStorageKey(storageKey));
+    }
+    return dedupeDescriptorsByStorageKey(descriptors);
+}
+/**
+ * Collects all media ULIDs referenced by an article content (frontmatter featuredImage + body images).
+ */
+export function collectArticleReferencedMediaIds(content) {
+    const ids = new Set();
+    let frontmatter = null;
+    let body = content;
+    // Try extracting YAML block directly if present
+    const fmMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/);
+    if (fmMatch) {
+        try {
+            frontmatter = yaml.load(fmMatch[1]) || null;
+            body = content.slice(fmMatch[0].length);
+        }
+        catch {
+            // Keep going
+        }
+    }
+    if (!frontmatter) {
+        try {
+            const parsed = parseMarkdown(content);
+            frontmatter = parsed.frontmatter;
+            body = parsed.body;
+        }
+        catch {
+            try {
+                const healed = lenientRepairMarkdownFrontmatter(content);
+                if (healed) {
+                    const parsed = parseMarkdown(healed);
+                    frontmatter = parsed.frontmatter;
+                    body = parsed.body;
+                }
+            }
+            catch {
+                // Fallback: search raw content
+            }
+        }
+    }
+    // 1. Frontmatter featuredImage
+    if (frontmatter && frontmatter.featuredImage) {
+        const ulid = extractMediaUlid(frontmatter.featuredImage);
+        if (ulid) {
+            ids.add(ulid);
+        }
+    }
+    else {
+        // Regex fallback for featuredImage in raw text if YAML parsing failed
+        const rawFiMatch = content.match(/featuredImage:\s*["']?([0-9A-HJ-NP-Z]{26})["']?/i);
+        if (rawFiMatch) {
+            ids.add(rawFiMatch[1].toUpperCase());
+        }
+    }
+    // 2. Body Markdown & HTML image references
+    const refs = scanArticleMediaReferences(body);
+    for (const ref of refs) {
+        const ulid = extractMediaUlid(ref);
+        if (ulid) {
+            ids.add(ulid);
+        }
+        else {
+            const match = ref.match(/(?:^|\/)(?:\d{8}_)?([0-9A-HJ-NP-Z]{26})-/i);
+            if (match) {
+                ids.add(match[1].toUpperCase());
+            }
+        }
+    }
+    // 3. URLs matching /_emdash/api/media/file/<ULID> or /media/<ULID>
+    const mediaUrlRegex = /(?:\/media\/file\/|\/media\/)([0-9A-HJ-NP-Z]{26})/gi;
+    let m;
+    while ((m = mediaUrlRegex.exec(body)) !== null) {
+        ids.add(m[1].toUpperCase());
+    }
+    return Array.from(ids).sort();
+}
+//# sourceMappingURL=body_scan.js.map

package/dist/sync/media/body_scan.js.map

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

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

@@ -0,0 +1,20 @@
+import type { EmDashMediaItem, LocalMediaMirrorCandidate } from './types.js';
+export declare function buildMediaMetaDoc(item: EmDashMediaItem, origin: string, existingMeta?: Record<string, unknown> | null): Record<string, unknown>;
+/**
+ * Recovers the storageKey a companion YAML actually refers to. Older mirrors — most visibly the ones
+ * written before Emit persisted the field — carry no `storageKey:` key at all, yet their `url:` is the
+ * canonical `/_emdash/api/media/file/<storageKey>` route, which is confirmed metadata written from the
+ * server response and not an inference from a body reference. Absolute and root-relative forms are both
+ * accepted because either can appear depending on how the record was mirrored. `legacy_*` residue is
+ * never read here: it backs no real record, so it must not serve as verification evidence.
+ */
+export declare function storageKeyFromMediaMeta(doc: Record<string, unknown>): string | undefined;
+/**
+ * Indexes every locally mirrored media asset (`media/<markdownRef>.yaml`, plus legacy companion names) so a body
+ * storageKey that the canonical id lookup failed to resolve can be re-checked against confirmed local
+ * metadata instead of being declared missing. Leftover `legacy_*` residue is skipped because it backs
+ * no real record. The result maps each ULID found in a mirror (record id or storageKey) to its entry,
+ * which is what lets Emit tell "the record exists under a different id" apart from "no record exists".
+ */
+export declare function collectLocalMediaMirrorCandidates(mediaDir: string): Map<string, LocalMediaMirrorCandidate>;
+//# sourceMappingURL=companions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"companions.d.ts","sourceRoot":"","sources":["../../../src/sync/media/companions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE7E,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAC5C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoDzB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAOxF;AAED;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,MAAM,GACf,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAgCxC"}

package/dist/sync/media/companions.js

@@ -0,0 +1,111 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import yaml from 'js-yaml';
+import { toRootRelativeMediaUrl } from '../../client/media.js';
+import { MEDIA_FILE_ROUTE_PREFIX } from '../../utils/media-refs.js';
+export function buildMediaMetaDoc(item, origin, existingMeta) {
+    const storageKey = (typeof item.storageKey === 'string' && item.storageKey ? item.storageKey : undefined) ??
+        (typeof existingMeta?.storageKey === 'string' && existingMeta.storageKey
+            ? existingMeta.storageKey
+            : '');
+    const canonicalUrl = item.url ||
+        (storageKey
+            ? `${MEDIA_FILE_ROUTE_PREFIX}${storageKey}`
+            : typeof existingMeta?.url === 'string'
+                ? existingMeta.url
+                : '');
+    const rootRelativeUrl = canonicalUrl
+        ? toRootRelativeMediaUrl(canonicalUrl, storageKey, origin)
+        : '';
+    const resolvedAlt = item.alt !== undefined && item.alt !== null && item.alt !== ''
+        ? item.alt
+        : typeof existingMeta?.alt === 'string'
+            ? existingMeta.alt
+            : '';
+    const resolvedCaption = item.caption !== undefined && item.caption !== null && item.caption !== ''
+        ? item.caption
+        : typeof existingMeta?.caption === 'string'
+            ? existingMeta.caption
+            : '';
+    const resolvedContentHash = typeof item.contentHash === 'string' && item.contentHash
+        ? item.contentHash
+        : typeof existingMeta?.contentHash === 'string' && existingMeta.contentHash
+            ? existingMeta.contentHash
+            : null;
+    return {
+        id: item.id,
+        filename: item.filename,
+        mimeType: item.mimeType,
+        size: item.size,
+        width: item.width ?? (typeof existingMeta?.width === 'number' ? existingMeta.width : null),
+        height: item.height ?? (typeof existingMeta?.height === 'number' ? existingMeta.height : null),
+        alt: resolvedAlt,
+        caption: resolvedCaption,
+        storageKey,
+        contentHash: resolvedContentHash,
+        status: item.status ?? (typeof existingMeta?.status === 'string' ? existingMeta.status : 'ready'),
+        url: rootRelativeUrl,
+        createdAt: item.createdAt || (typeof existingMeta?.createdAt === 'string' ? existingMeta.createdAt : ''),
+    };
+}
+/**
+ * Recovers the storageKey a companion YAML actually refers to. Older mirrors — most visibly the ones
+ * written before Emit persisted the field — carry no `storageKey:` key at all, yet their `url:` is the
+ * canonical `/_emdash/api/media/file/<storageKey>` route, which is confirmed metadata written from the
+ * server response and not an inference from a body reference. Absolute and root-relative forms are both
+ * accepted because either can appear depending on how the record was mirrored. `legacy_*` residue is
+ * never read here: it backs no real record, so it must not serve as verification evidence.
+ */
+export function storageKeyFromMediaMeta(doc) {
+    if (typeof doc.storageKey === 'string' && doc.storageKey.trim()) {
+        return doc.storageKey.trim();
+    }
+    if (typeof doc.url !== 'string' || !doc.url.trim())
+        return undefined;
+    const match = doc.url.match(/(?:^|\/)media\/file\/([^?#]+)/);
+    return match ? match[1] : undefined;
+}
+/**
+ * Indexes every locally mirrored media asset (`media/<markdownRef>.yaml`, plus legacy companion names) so a body
+ * storageKey that the canonical id lookup failed to resolve can be re-checked against confirmed local
+ * metadata instead of being declared missing. Leftover `legacy_*` residue is skipped because it backs
+ * no real record. The result maps each ULID found in a mirror (record id or storageKey) to its entry,
+ * which is what lets Emit tell "the record exists under a different id" apart from "no record exists".
+ */
+export function collectLocalMediaMirrorCandidates(mediaDir) {
+    const byUlid = new Map();
+    if (!fs.existsSync(mediaDir))
+        return byUlid;
+    for (const file of fs.readdirSync(mediaDir)) {
+        if (!file.endsWith('.yaml') || file.startsWith('legacy_'))
+            continue;
+        let doc = null;
+        try {
+            doc = yaml.load(fs.readFileSync(path.join(mediaDir, file), 'utf8'));
+        }
+        catch {
+            continue;
+        }
+        if (!doc)
+            continue;
+        const storageKey = storageKeyFromMediaMeta(doc);
+        const stem = file.replace(/\.yaml$/, '');
+        const idMatch = stem.replace(/^\d{8}_/, '').match(/^([0-9A-HJ-NP-Z]{26})/i);
+        const docId = typeof doc.id === 'string' && /^[0-9A-HJ-NP-Z]{26}$/i.test(doc.id.trim())
+            ? doc.id.trim().toUpperCase()
+            : undefined;
+        const mediaId = docId || (idMatch ? idMatch[1].toUpperCase() : '');
+        if (!mediaId)
+            continue;
+        const candidate = { mediaId, storageKey, metaFile: file };
+        if (!byUlid.has(mediaId))
+            byUlid.set(mediaId, candidate);
+        for (const ulid of storageKey?.matchAll(/[0-9A-HJ-NP-Z]{26}/gi) ?? []) {
+            const key = ulid[0].toUpperCase();
+            if (!byUlid.has(key))
+                byUlid.set(key, candidate);
+        }
+    }
+    return byUlid;
+}
+//# sourceMappingURL=companions.js.map

package/dist/sync/media/companions.js.map

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

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

@@ -0,0 +1,9 @@
+export * from './types.js';
+export * from './naming_mirror.js';
+export * from './companions.js';
+export * from './body_scan.js';
+export * from './mirror_item.js';
+export * from './pull_article.js';
+export * from './pull_library.js';
+export * from './remote_index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sync/media/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}

package/dist/sync/media/index.js

@@ -0,0 +1,9 @@
+export * from './types.js';
+export * from './naming_mirror.js';
+export * from './companions.js';
+export * from './body_scan.js';
+export * from './mirror_item.js';
+export * from './pull_article.js';
+export * from './pull_library.js';
+export * from './remote_index.js';
+//# sourceMappingURL=index.js.map

package/dist/sync/media/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sync/media/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}

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

@@ -0,0 +1,27 @@
+import type { CacheDatabase } from '../../db/cache.js';
+import type { EmDashMediaItem, PromoteDraftMediaOptions, PromotedMediaFile } from './types.js';
+/**
+ * Persists YAML companion metadata and downloads the binary file for a single media item.
+ */
+export declare function syncSingleMediaItem(options: {
+    item: EmDashMediaItem;
+    mediaDir: string;
+    origin: string;
+    token: string;
+    downloadFiles: boolean;
+    fetchFn: typeof fetch;
+    cache?: CacheDatabase;
+}): Promise<{
+    downloaded: boolean;
+    skipped: boolean;
+    baseName: string;
+}>;
+/**
+ * Promotes a local draft image from media/drafts/<name> into the canonical
+ * media/<markdownRef>.<ext> location alongside its matching media/<markdownRef>.yaml companion, where
+ * markdownRef is derived from the storageKey the article body will reference. Returns both the workspace-relative
+ * path of the promoted binary and the shared `media/<markdownRef>` stem, so the caller can record the mirror in
+ * `media_state.markdown_ref`.
+ */
+export declare function promoteDraftMediaFile(options: PromoteDraftMediaOptions): PromotedMediaFile;
+//# sourceMappingURL=mirror_item.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mirror_item.d.ts","sourceRoot":"","sources":["../../../src/sync/media/mirror_item.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAQvD,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/F;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IACjD,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,KAAK,CAAC;IACtB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAmKvE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAyD1F"}