mrplex 0.0.1

package/dist/links/extract.js

@@ -0,0 +1,233 @@
+/**
+ * Deterministic link extraction — design §11.2 "Extraction" (WS2).
+ *
+ * Body and frontmatter string values each honor their own LinkSyntaxes profile.
+ * Frontmatter links are discovered by walking all scalar string values — no
+ * per-field opt-in list.
+ */
+import { parse, postprocess, preprocess } from "micromark";
+/** The `field` value for body-derived edges (§11.2 reserved sentinel). */
+export const BODY_FIELD = "$body";
+/** Repo-root absolute path ending in `.md` — whole frontmatter value form. */
+export const FRONTMATTER_FULLPATH_WHOLE = /^\/[^\s#]+\.md(?:#.*)?$/;
+/** Inline repo-root `/…/*.md` paths in prose (body scan). Requires `/` at a token boundary. */
+const BODY_FULLPATH = /(?:^|[\s(\["'`<>])(\/[^\s\])"'`<>]+\.md(?:#[^\s\])"'`<>]*)?)/g;
+export function extractEdges(input) {
+    const { body, frontmatter, config } = input;
+    const bodyEdges = extractBodyEdges(body, config.body);
+    const fmEdges = extractFrontmatterEdges(frontmatter, config.frontmatter);
+    const out = [];
+    let ord = 0;
+    for (const e of bodyEdges)
+        out.push({ ...e, ord: ord++ });
+    for (const e of fmEdges)
+        out.push({ ...e, ord: ord++ });
+    return out;
+}
+function extractBodyEdges(body, syntaxes) {
+    const hits = [];
+    const codeRanges = collectCommonMark(body, syntaxes, hits);
+    if (syntaxes.wikilink)
+        collectWikilinks(body, codeRanges, hits);
+    if (syntaxes.fullpath)
+        collectBodyFullpaths(body, codeRanges, hits);
+    hits.sort((a, b) => a.offset - b.offset);
+    return hits.map((h) => ({
+        field: BODY_FIELD,
+        target: h.target,
+        wikilink: h.wikilink,
+        ...(h.dest_span ? { dest_span: h.dest_span } : {}),
+    }));
+}
+function collectBodyFullpaths(body, codeRanges, hits) {
+    for (const m of body.matchAll(BODY_FULLPATH)) {
+        const target = m[1];
+        const offset = (m.index ?? 0) + m[0].length - target.length;
+        if (inAnyRange(offset, codeRanges))
+            continue;
+        hits.push({
+            offset,
+            target,
+            wikilink: false,
+            dest_span: { start: offset, end: offset + target.length },
+        });
+    }
+}
+// -----------------------------------------------------------------------------
+// Frontmatter extraction — walk all string values.
+// -----------------------------------------------------------------------------
+function extractFrontmatterEdges(frontmatter, syntaxes) {
+    const out = [];
+    walkFrontmatterStrings(frontmatter, [], (field, value) => {
+        for (const hit of extractFromFrontmatterString(value, syntaxes)) {
+            out.push({ field, target: hit.target, wikilink: hit.wikilink });
+        }
+    });
+    return out;
+}
+function walkFrontmatterStrings(node, path, visit) {
+    if (typeof node === "string") {
+        visit(path.join("."), node);
+        return;
+    }
+    if (Array.isArray(node)) {
+        for (const el of node)
+            walkFrontmatterStrings(el, path, visit);
+        return;
+    }
+    if (node !== null && typeof node === "object") {
+        for (const [key, val] of Object.entries(node)) {
+            walkFrontmatterStrings(val, [...path, key], visit);
+        }
+    }
+}
+function extractFromFrontmatterString(value, syntaxes) {
+    const hits = [];
+    if (syntaxes.fullpath) {
+        const trimmed = value.trim();
+        if (FRONTMATTER_FULLPATH_WHOLE.test(trimmed)) {
+            hits.push({ offset: 0, target: trimmed, wikilink: false });
+            return hits;
+        }
+    }
+    const codeRanges = collectCommonMark(value, syntaxes, hits);
+    if (syntaxes.wikilink)
+        collectWikilinks(value, codeRanges, hits);
+    hits.sort((a, b) => a.offset - b.offset);
+    return hits;
+}
+// -----------------------------------------------------------------------------
+// CommonMark + wikilinks (shared by body and frontmatter strings)
+// -----------------------------------------------------------------------------
+function collectCommonMark(text, syntaxes, hits) {
+    const events = tokenize(text);
+    const slice = (t) => text.slice(t.start.offset, t.end.offset);
+    const definitions = new Map();
+    for (const [kind, token] of events) {
+        if (kind !== "enter")
+            continue;
+        if (token.type === "definition") {
+            const label = childValue(events, text, token, "definitionLabelString");
+            const destTok = childToken(events, token, "definitionDestinationString");
+            if (label !== undefined && destTok !== undefined) {
+                const key = normalizeLabel(label);
+                if (!definitions.has(key)) {
+                    definitions.set(key, {
+                        dest: text.slice(destTok.start.offset, destTok.end.offset),
+                        span: { start: destTok.start.offset, end: destTok.end.offset },
+                    });
+                }
+            }
+        }
+    }
+    const codeRanges = [];
+    const stack = [];
+    for (const [kind, token] of events) {
+        const T = token.type;
+        if (kind === "enter") {
+            if (T === "codeText" || T === "codeFenced" || T === "codeIndented") {
+                codeRanges.push([token.start.offset, token.end.offset]);
+            }
+            else if (T === "link" || T === "image") {
+                stack.push({ isImage: T === "image", start: token.start.offset, label: "" });
+            }
+            else if (T === "labelText") {
+                const top = stack[stack.length - 1];
+                if (top && top.dest === undefined && top.refKey === undefined)
+                    top.label += slice(token);
+            }
+            else if (T === "resourceDestinationString") {
+                const top = stack[stack.length - 1];
+                if (top) {
+                    top.dest = slice(token);
+                    top.destSpan = { start: token.start.offset, end: token.end.offset };
+                }
+            }
+            else if (T === "referenceString") {
+                const top = stack[stack.length - 1];
+                if (top)
+                    top.refKey = normalizeLabel(slice(token));
+            }
+        }
+        else if (kind === "exit" && (T === "link" || T === "image")) {
+            const frame = stack.pop();
+            if (!frame)
+                continue;
+            const resolved = resolveDestination(frame, definitions);
+            if (resolved !== undefined && resolved.dest.length > 0 && syntaxEnabled(frame, syntaxes)) {
+                const span = frame.destSpan ?? resolved.span;
+                hits.push({
+                    offset: frame.start,
+                    target: resolved.dest,
+                    wikilink: false,
+                    ...(span ? { dest_span: span } : {}),
+                });
+            }
+        }
+    }
+    return codeRanges;
+}
+function resolveDestination(frame, definitions) {
+    if (frame.dest !== undefined)
+        return { dest: frame.dest, span: frame.destSpan };
+    const key = frame.refKey && frame.refKey.length > 0 ? frame.refKey : normalizeLabel(frame.label);
+    const def = definitions.get(key);
+    return def ? { dest: def.dest, span: def.span } : undefined;
+}
+function syntaxEnabled(frame, syntaxes) {
+    return frame.dest !== undefined ? syntaxes.inline : syntaxes.reference;
+}
+function normalizeLabel(raw) {
+    return raw.trim().replace(/\s+/g, " ").toLowerCase();
+}
+const WIKILINK = () => /!?\[\[([^\]\n]+?)\]\]/g;
+function collectWikilinks(text, codeRanges, hits) {
+    for (const m of text.matchAll(WIKILINK())) {
+        const offset = m.index ?? 0;
+        if (inAnyRange(offset, codeRanges))
+            continue;
+        const full = m[0];
+        const inner = m[1];
+        const pageRaw = inner.split("|")[0];
+        const target = pageRaw.trim();
+        if (target.length === 0)
+            continue;
+        const innerStart = offset + full.indexOf(inner);
+        const lead = pageRaw.length - pageRaw.trimStart().length;
+        const start = innerStart + lead;
+        hits.push({
+            offset,
+            target,
+            wikilink: true,
+            dest_span: { start, end: start + target.length },
+        });
+    }
+}
+function inAnyRange(offset, ranges) {
+    for (const [start, end] of ranges) {
+        if (offset >= start && offset < end)
+            return true;
+    }
+    return false;
+}
+function tokenize(md) {
+    const p = parse();
+    return postprocess(p.document().write(preprocess()(md, "utf8", true)));
+}
+function childValue(events, body, parent, type) {
+    const tok = childToken(events, parent, type);
+    return tok ? body.slice(tok.start.offset, tok.end.offset) : undefined;
+}
+function childToken(events, parent, type) {
+    for (const [kind, token] of events) {
+        if (kind !== "enter")
+            continue;
+        if (token.type === type &&
+            token.start.offset >= parent.start.offset &&
+            token.end.offset <= parent.end.offset) {
+            return token;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=extract.js.map

package/dist/links/extract.js.map

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

package/dist/links/link-config.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Link config layering — design §11.2 (Phase 1, links-plan.md §1.2).
+ *
+ *   HARDCODED_DEFAULTS  → server config  → per-repo override
+ *      (in code)          (operator)       (repos.link_config JSON)
+ *
+ * Body and frontmatter each declare which link *syntaxes* are recognized in
+ * that region. Frontmatter string values are scanned automatically — no
+ * per-field opt-in list.
+ */
+/**
+ * Which link syntaxes extraction recognizes. Each is a boolean knob; the
+ * `!` embed/transclusion prefix is NOT a syntax — it's a rendering hint
+ * captured as an ordinary edge from its base syntax (§1.1).
+ *
+ * `fullpath` matches repo-root paths written as `/dir/doc.md` (optional
+ * `#anchor`). In the document body, matches may appear inline in prose; in
+ * frontmatter, only a string value that *is* such a path (after trim) counts.
+ */
+export type LinkSyntaxes = {
+    inline: boolean;
+    reference: boolean;
+    autolink: boolean;
+    wikilink: boolean;
+    fullpath: boolean;
+};
+/**
+ * Path-resolution knobs. Absolute-vs-relative and case policy follow the
+ * repo's §3.5.1 path policy — one path-normalization authority — so they
+ * are deliberately NOT knobs here.
+ */
+export type LinkResolution = {
+    wikilink_elision: boolean;
+    preserve_anchors: boolean;
+    index_basename: string;
+};
+/** The full config after merging tiers — every field populated. */
+export type LinkConfig = {
+    /** Syntaxes recognized in the Markdown body. */
+    body: LinkSyntaxes;
+    /** Syntaxes recognized inside frontmatter string values. */
+    frontmatter: LinkSyntaxes;
+    resolution: LinkResolution;
+};
+/**
+ * Optional per-field override — the shape stored in `repos.link_config`
+ * JSON and accepted by `repos.set_link_config`. Omitting a field means
+ * "inherit"; setting it means "replace the inherited value wholesale."
+ */
+export type LinkConfigOverride = {
+    body?: LinkSyntaxes;
+    frontmatter?: LinkSyntaxes;
+    resolution?: LinkResolution;
+};
+/** All body syntaxes on — the default document-body profile. */
+export declare const DEFAULT_BODY_SYNTAXES: LinkSyntaxes;
+/**
+ * Frontmatter profile: whole-value `/…/*.md` paths plus embedded wikilinks
+ * and inline links. Reference/autolink off — uncommon inside YAML scalars.
+ */
+export declare const DEFAULT_FRONTMATTER_SYNTAXES: LinkSyntaxes;
+export declare const HARDCODED_DEFAULTS: LinkConfig;
+export declare function mergeConfig(base: LinkConfig, override: LinkConfigOverride | null): LinkConfig;
+export declare function effectiveLinkConfig(serverConfig: LinkConfig, repoOverride: LinkConfigOverride | null): LinkConfig;
+export declare function parseRepoOverride(json: string | null): LinkConfigOverride | null;
+export declare class ConfigError extends Error {
+    constructor(message: string);
+}
+export declare function validateConfig(config: LinkConfig): void;
+export declare function validateRepoOverride(override: LinkConfigOverride, serverConfig: LinkConfig): void;

package/dist/links/link-config.js

@@ -0,0 +1,107 @@
+/**
+ * Link config layering — design §11.2 (Phase 1, links-plan.md §1.2).
+ *
+ *   HARDCODED_DEFAULTS  → server config  → per-repo override
+ *      (in code)          (operator)       (repos.link_config JSON)
+ *
+ * Body and frontmatter each declare which link *syntaxes* are recognized in
+ * that region. Frontmatter string values are scanned automatically — no
+ * per-field opt-in list.
+ */
+import { KernelError } from "../kernel/errors.js";
+const SYNTAX_KEYS = ["inline", "reference", "autolink", "wikilink", "fullpath"];
+/** All body syntaxes on — the default document-body profile. */
+export const DEFAULT_BODY_SYNTAXES = {
+    inline: true,
+    reference: true,
+    autolink: true,
+    wikilink: true,
+    fullpath: true,
+};
+/**
+ * Frontmatter profile: whole-value `/…/*.md` paths plus embedded wikilinks
+ * and inline links. Reference/autolink off — uncommon inside YAML scalars.
+ */
+export const DEFAULT_FRONTMATTER_SYNTAXES = {
+    inline: true,
+    reference: false,
+    autolink: false,
+    wikilink: true,
+    fullpath: true,
+};
+export const HARDCODED_DEFAULTS = {
+    body: DEFAULT_BODY_SYNTAXES,
+    frontmatter: DEFAULT_FRONTMATTER_SYNTAXES,
+    resolution: {
+        wikilink_elision: true,
+        preserve_anchors: true,
+        index_basename: "index",
+    },
+};
+// -----------------------------------------------------------------------------
+// Merging.
+// -----------------------------------------------------------------------------
+export function mergeConfig(base, override) {
+    if (!override)
+        return base;
+    return {
+        body: override.body ?? base.body,
+        frontmatter: override.frontmatter ?? base.frontmatter,
+        resolution: override.resolution ?? base.resolution,
+    };
+}
+export function effectiveLinkConfig(serverConfig, repoOverride) {
+    return mergeConfig(serverConfig, repoOverride);
+}
+export function parseRepoOverride(json) {
+    if (json === null)
+        return null;
+    const parsed = JSON.parse(json);
+    if (parsed === null || parsed === undefined)
+        return null;
+    if (typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error(`corrupt repos.link_config JSON: expected object, got ${typeof parsed}`);
+    }
+    return parsed;
+}
+// -----------------------------------------------------------------------------
+// Startup invariants.
+// -----------------------------------------------------------------------------
+export class ConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ConfigError";
+    }
+}
+function validateSyntaxes(label, syn) {
+    for (const key of SYNTAX_KEYS) {
+        if (typeof syn[key] !== "boolean") {
+            throw new ConfigError(`${label}.${key} must be a boolean, got ${JSON.stringify(syn[key])}`);
+        }
+    }
+}
+export function validateConfig(config) {
+    validateSyntaxes("body", config.body);
+    validateSyntaxes("frontmatter", config.frontmatter);
+    if (typeof config.resolution.index_basename !== "string" ||
+        config.resolution.index_basename.length === 0) {
+        throw new ConfigError(`resolution.index_basename must be a non-empty string, got ${JSON.stringify(config.resolution.index_basename)}`);
+    }
+    for (const key of ["wikilink_elision", "preserve_anchors"]) {
+        if (typeof config.resolution[key] !== "boolean") {
+            throw new ConfigError(`resolution.${key} must be a boolean, got ${JSON.stringify(config.resolution[key])}`);
+        }
+    }
+}
+export function validateRepoOverride(override, serverConfig) {
+    try {
+        validateConfig(mergeConfig(serverConfig, override));
+    }
+    catch (err) {
+        if (err instanceof ConfigError) {
+            throw new KernelError("link_config_invalid", { reason: err.message });
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=link-config.js.map

package/dist/links/link-config.js.map

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

package/dist/links/maintain.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Link-index maintenance — the write-path glue (design §11.2, WS3).
+ *
+ * Extraction is pure CPU (no external I/O), so the design runs it in the
+ * write transaction alongside version_insert rather than on the async
+ * backlog worker (links-plan.md §5 decision 1). These helpers are called
+ * from inside the kernel's create/put/delete tx closures.
+ *
+ * The flow for a source document D whose current version just advanced:
+ *   1. extractEdges(body, frontmatter, config)     → RawEdge[]   (parse)
+ *   2. normalizeEdges(edges, srcPath, config)       → NormalizedEdge[] (paths)
+ *   3. resolve each edge's candidates against live paths → target_id | null
+ *   4. links_replace(repo, D, resolved)
+ *
+ * Resolution is case-insensitive: candidates are matched via the storage
+ * layer's version_current (which folds to path_norm, §3.5.1), and the
+ * folded key of the primary candidate is stored as target_norm so a later
+ * dangling re-resolution can rebind by folded path.
+ */
+import type { FrontmatterJson } from "../markdown/frontmatter.js";
+import type { Storage } from "../storage/types.js";
+import type { LinkConfig } from "./link-config.js";
+/**
+ * Extract + resolve + persist document `sourceId`'s outbound edges. Called
+ * after every create/put that advances the doc's current version, inside
+ * the same tx. `sourcePath` is the new current version's repo-root-relative
+ * path (edges resolve relative to it).
+ */
+export declare function reindexOutboundLinks(storage: Storage, config: LinkConfig, repoId: number, sourceId: number, sourcePath: string, body: string, frontmatter: FrontmatterJson): Promise<void>;
+/**
+ * Bind dangling edges that name `path` (in `repoId`) to `documentId`, so a
+ * document appearing at a path (create / move-in / restore) resolves the
+ * links that were waiting for it. Matches on the folded path (§3.5.1),
+ * consistent with how resolution stored target_norm. Returns the count
+ * bound. Bind-only — never unbinds (a move produces zero inbound churn).
+ */
+export declare function bindDanglingToPath(storage: Storage, repoId: number, path: string, documentId: number): Promise<number>;

package/dist/links/maintain.js

@@ -0,0 +1,91 @@
+/**
+ * Link-index maintenance — the write-path glue (design §11.2, WS3).
+ *
+ * Extraction is pure CPU (no external I/O), so the design runs it in the
+ * write transaction alongside version_insert rather than on the async
+ * backlog worker (links-plan.md §5 decision 1). These helpers are called
+ * from inside the kernel's create/put/delete tx closures.
+ *
+ * The flow for a source document D whose current version just advanced:
+ *   1. extractEdges(body, frontmatter, config)     → RawEdge[]   (parse)
+ *   2. normalizeEdges(edges, srcPath, config)       → NormalizedEdge[] (paths)
+ *   3. resolve each edge's candidates against live paths → target_id | null
+ *   4. links_replace(repo, D, resolved)
+ *
+ * Resolution is case-insensitive: candidates are matched via the storage
+ * layer's version_current (which folds to path_norm, §3.5.1), and the
+ * folded key of the primary candidate is stored as target_norm so a later
+ * dangling re-resolution can rebind by folded path.
+ */
+import { normalizeKey } from "../kernel/casefold.js";
+import { extractEdges } from "./extract.js";
+import { normalizeEdges } from "./resolve.js";
+/**
+ * Resolve one normalized edge's ordered candidates against the repo's live
+ * paths, returning the storable edge. The first candidate that resolves to
+ * a live document wins; if none resolve, the edge is dangling (target_id
+ * null) and keyed by the folded primary candidate for later rebinding.
+ *
+ * An edge with no candidates (external URI / bare fragment) yields null —
+ * it never enters the index (links are repo-local, §11.2).
+ */
+async function resolveEdge(storage, repoId, edge) {
+    if (edge.candidates.length === 0)
+        return null;
+    let targetId = null;
+    for (const candidate of edge.candidates) {
+        const current = await storage.version_current(repoId, candidate);
+        if (current) {
+            targetId = current.document_id;
+            break;
+        }
+    }
+    // The primary candidate is the canonical resolution key: its folded form
+    // is what a later-appearing document's path will match against to rebind.
+    const primary = edge.candidates[0];
+    return {
+        ord: edge.ord,
+        field: edge.field,
+        target_raw: edge.target_raw,
+        target_norm: normalizeKey(primary),
+        target_id: targetId,
+    };
+}
+/**
+ * Extract + resolve + persist document `sourceId`'s outbound edges. Called
+ * after every create/put that advances the doc's current version, inside
+ * the same tx. `sourcePath` is the new current version's repo-root-relative
+ * path (edges resolve relative to it).
+ */
+export async function reindexOutboundLinks(storage, config, repoId, sourceId, sourcePath, body, frontmatter) {
+    const rawEdges = extractEdges({ body, frontmatter, config });
+    const normalized = normalizeEdges(rawEdges, sourcePath, config);
+    const resolved = [];
+    let ord = 0;
+    for (const edge of normalized) {
+        const stored = await resolveEdge(storage, repoId, edge);
+        if (stored === null)
+            continue;
+        // Drop self-links: an edge resolving to the source document itself is
+        // noise — it would make the doc appear in its own $backlinks_static() /
+        // $links_static() and match $in_static against itself. A self-reference
+        // is never a meaningful graph edge, so it never enters the index.
+        if (stored.target_id === sourceId)
+            continue;
+        // Re-pack ord densely: dropped edges (external, self) must not leave
+        // gaps, and the PK is (source_id, ord). Extraction order is preserved.
+        resolved.push({ ...stored, ord: ord++ });
+    }
+    await storage.links_replace(repoId, sourceId, resolved);
+}
+/**
+ * Bind dangling edges that name `path` (in `repoId`) to `documentId`, so a
+ * document appearing at a path (create / move-in / restore) resolves the
+ * links that were waiting for it. Matches on the folded path (§3.5.1),
+ * consistent with how resolution stored target_norm. Returns the count
+ * bound. Bind-only — never unbinds (a move produces zero inbound churn).
+ */
+export async function bindDanglingToPath(storage, repoId, path, documentId) {
+    return storage.links_resolve_dangling(repoId, normalizeKey(path), documentId);
+}
+//# sourceMappingURL=maintain.js.map

package/dist/links/maintain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintain.js","sourceRoot":"","sources":["../../src/links/maintain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrD,OAAO,EAAgB,YAAY,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,EAAuB,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnE;;;;;;;;GAQG;AACH,KAAK,UAAU,WAAW,CACxB,OAAgB,EAChB,MAAc,EACd,IAAoB;IAEpB,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9C,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACjE,IAAI,OAAO,EAAE,CAAC;YACZ,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC;YAC/B,MAAM;QACR,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,0EAA0E;IAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAW,CAAC;IAC7C,OAAO;QACL,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,YAAY,CAAC,OAAO,CAAC;QAClC,SAAS,EAAE,QAAQ;KACpB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAgB,EAChB,MAAkB,EAClB,MAAc,EACd,QAAgB,EAChB,UAAkB,EAClB,IAAY,EACZ,WAA4B;IAE5B,MAAM,QAAQ,GAAc,YAAY,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;IACxE,MAAM,UAAU,GAAG,cAAc,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAEhE,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACxD,IAAI,MAAM,KAAK,IAAI;YAAE,SAAS;QAC9B,sEAAsE;QACtE,wEAAwE;QACxE,wEAAwE;QACxE,kEAAkE;QAClE,IAAI,MAAM,CAAC,SAAS,KAAK,QAAQ;YAAE,SAAS;QAC5C,qEAAqE;QACrE,uEAAuE;QACvE,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAgB,EAChB,MAAc,EACd,IAAY,EACZ,UAAkB;IAElB,OAAO,OAAO,CAAC,sBAAsB,CAAC,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;AAChF,CAAC"}

package/dist/links/repair.d.ts

@@ -0,0 +1,46 @@
+/**
+ * mrplex links repair — rewrite stale link text so the written destination
+ * matches the target's current path (design §11.2 "Link rewriting is
+ * cosmetic, not structural — and opt-in").
+ *
+ * The graph is identity-bound, so a move breaks nothing structurally; this
+ * only repairs the visible text. Each source document is rewritten as an
+ * ordinary optimistic `docs.put` under the caller's token — `prev` checks
+ * apply, conflicts are reported and skipped, and every repair is a normal
+ * authored version in the chain (NOT a silent side effect of the move).
+ *
+ * Rewriting is surgical: only the destination spans of stale edges are
+ * spliced (right-to-left so earlier offsets stay valid); the rest of the
+ * body is byte-identical. Only inline/​wikilink edges with a captured
+ * destination span are rewritten; reference-definition links are left for a
+ * later phase.
+ */
+import type { Storage, VersionRow } from "../storage/types.js";
+import type { LinkConfig } from "./link-config.js";
+export type RepairOutcome = {
+    repaired: {
+        path: string;
+        edges: number;
+    }[];
+    skipped: {
+        path: string;
+        reason: string;
+    }[];
+};
+/**
+ * A single planned rewrite of one source document: the new body plus the
+ * version to base the optimistic put on. Returned by planRepairs so a
+ * caller (the kernel op) can drive the actual docs.put and handle conflicts.
+ */
+export type RepairPlan = {
+    version: VersionRow;
+    newBody: string;
+    edges: number;
+};
+/**
+ * Compute the body rewrites needed to repair stale links across a repo's
+ * live documents. Pure w.r.t. storage reads — no writes. The caller issues
+ * the puts (so auth, conflict handling, and dry-run all live at the op
+ * layer, where the actor and kernel are in scope).
+ */
+export declare function planRepairs(storage: Storage, repoId: number, config: LinkConfig): Promise<RepairPlan[]>;