claude code agent 227
6dcc19ce59
git-sync's converter-core (src/lib) was a byte-identical duplicate of the new @docmost/prosemirror-markdown package (created in the previous commit). Switch git-sync to consume the package and delete its copy — ending the duplication that the whole #293 effort targets. Pure no-op: NO format/behavior change. - git-sync depends on @docmost/prosemirror-markdown (workspace:*); engine (stabilize/push/pull) + src/index barrel + 12 engine tests re-point their converter imports to the package. - Delete git-sync/src/lib (8 files) and the 23 duplicate converter-core test files + their fixtures — the converter and its ~440 tests now live once, in the package. git-sync keeps only its ENGINE tests, which exercise the converter through the package (the no-op proof). Kept roundtrip-helpers.ts (an engine test imports firstDivergence from it; pure helper, no double-run). - Added docmostExtensions to the package barrel (a kept engine schema-validity test needs it). Verified: editor-ext + prosemirror-markdown + git-sync all tsc EXIT 0; git-sync vitest 28 files, 268 passed, 0 failures (engine cycle/roundtrip/push/ pull/reconcile green = no-op proof); prosemirror-markdown vitest still 443 passed | 1 expected-fail; pnpm --frozen-lockfile EXIT 0; no ../lib refs remain in git-sync. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
79 lines
3.1 KiB
TypeScript
79 lines
3.1 KiB
TypeScript
/**
|
|
* Normalize-on-write helper (SPEC §11 "Resolution").
|
|
*
|
|
* git diffs byte-for-byte, so writing a page in a NON-fixpoint markdown form
|
|
* would make the next pull re-export it to a slightly different (but stable)
|
|
* form and produce a phantom diff -> churny commits. The converter has a couple
|
|
* of known one-pass asymmetries (a block image after a paragraph adds an empty
|
|
* paragraph; a diagram materializes `data-align`), all of which converge to a
|
|
* fixpoint after ONE `export -> import -> export` round-trip.
|
|
*
|
|
* So at write time we run exactly that one pass and persist the fixpoint form.
|
|
* Already-stable content is unaffected (the pass is idempotent), so re-pulls of
|
|
* unchanged pages produce identical bytes and git sees no diff.
|
|
*/
|
|
import {
|
|
convertProseMirrorToMarkdown,
|
|
markdownToProseMirror,
|
|
serializeDocmostMarkdownBody,
|
|
type DocmostMdMeta,
|
|
} from "@docmost/prosemirror-markdown";
|
|
|
|
/**
|
|
* Meta object as `exportPageBody` builds it (SPEC §4). Kept byte-for-byte
|
|
* compatible so files produced here match `exportPageBody`'s output exactly.
|
|
*/
|
|
export interface PageMeta {
|
|
version: 1;
|
|
pageId: string;
|
|
slugId: string;
|
|
title: string;
|
|
spaceId: string;
|
|
parentPageId: string | null;
|
|
}
|
|
|
|
/**
|
|
* Produce the self-contained `.md` file text for a page from its raw
|
|
* ProseMirror `content` + identity meta, in the verified fixpoint form.
|
|
*
|
|
* md1 = convertProseMirrorToMarkdown(content)
|
|
* doc2 = markdownToProseMirror(md1) // one import...
|
|
* stableBody = convertProseMirrorToMarkdown(doc2) // ...and re-export
|
|
* file = serializeDocmostMarkdownBody(meta, stableBody)
|
|
*
|
|
* The single export->import->export pass is the verified fixpoint (SPEC §11):
|
|
* idempotent for already-stable content, and the convergence point for the
|
|
* known converter asymmetries.
|
|
*/
|
|
export async function stabilizePageFile(
|
|
content: unknown,
|
|
meta: PageMeta,
|
|
): Promise<string> {
|
|
// The meta shape is exactly what `exportPageBody` writes; cast to the lib's
|
|
// DocmostMdMeta (a superset with optional fields) for the serializer.
|
|
return serializeDocmostMarkdownBody(
|
|
meta as DocmostMdMeta,
|
|
await stabilizePageBody(content),
|
|
);
|
|
}
|
|
|
|
/**
|
|
* The fixpoint markdown BODY for a page's ProseMirror `content`, WITHOUT any meta
|
|
* envelope:
|
|
*
|
|
* md1 = convertProseMirrorToMarkdown(content) // export...
|
|
* doc2 = markdownToProseMirror(md1) // ...import...
|
|
* stableBody = convertProseMirrorToMarkdown(doc2) // ...re-export
|
|
*
|
|
* The single export->import->export pass is the verified fixpoint (SPEC §11):
|
|
* idempotent for already-stable content, and the convergence point for the known
|
|
* converter asymmetries. The native-Obsidian writer (`serializePageFile`) wraps
|
|
* this body with a minimal `gitmost_id` frontmatter; determinism here is what
|
|
* keeps re-pulls of an unchanged page byte-identical (no churn, loop-guard).
|
|
*/
|
|
export async function stabilizePageBody(content: unknown): Promise<string> {
|
|
const md1 = convertProseMirrorToMarkdown(content);
|
|
const doc2 = await markdownToProseMirror(md1);
|
|
return convertProseMirrorToMarkdown(doc2);
|
|
}
|