@crowi/api 2.0.0-alpha.1 → 2.0.0-alpha.2

package/dist/migration/migrations/wikilink-format.js

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.wikilinkFormat = exports.WIKILINK_DETECTION_REGEX = exports.KNOWN_HTML_ELEMENTS = void 0;
+exports.wikilinkFormat = exports.WIKILINK_DETECTION_REGEX = void 0;
 exports.bodyHasRewritableWikilink = bodyHasRewritableWikilink;
 exports.shouldRewriteWikilink = shouldRewriteWikilink;
 exports.rewriteAndDetect = rewriteAndDetect;
 exports.rewriteWikilinks = rewriteWikilinks;
+const api_contract_1 = require("@crowi/api-contract");
 const page_1 = require("../../models/page");
+const helpers_1 = require("../helpers");
 const types_1 = require("../types");
 /**
  * RFC-0008 §10.2 step 4 / §4.3.1 — `wikilink-format` (preflight layer).
@@ -29,129 +31,6 @@ const types_1 = require("../types");
  * The textual conversion logic below is moved verbatim from the old command so
  * the rewrite output is byte-identical to the legacy migrator.
  */
-/**
- * HTML5 element name set used to reject `</foo>` matches whose first path
- * segment is actually a closing HTML tag. Source:
- * https://developer.mozilla.org/en-US/docs/Web/HTML/Element — the full
- * standard element list as of the HTML Living Standard.
- *
- * Kept as a top-level `Set<string>` so detection runs O(1) per match.
- * `h1`..`h6` are listed explicitly because the regex captures `foo` for
- * `</foo>` and we want both `</h1>` and `</h6>` to be rejected.
- */
-exports.KNOWN_HTML_ELEMENTS = new Set([
-    'a',
-    'abbr',
-    'address',
-    'area',
-    'article',
-    'aside',
-    'audio',
-    'b',
-    'base',
-    'bdi',
-    'bdo',
-    'blockquote',
-    'body',
-    'br',
-    'button',
-    'canvas',
-    'caption',
-    'cite',
-    'code',
-    'col',
-    'colgroup',
-    'data',
-    'datalist',
-    'dd',
-    'del',
-    'details',
-    'dfn',
-    'dialog',
-    'div',
-    'dl',
-    'dt',
-    'em',
-    'embed',
-    'fieldset',
-    'figcaption',
-    'figure',
-    'footer',
-    'form',
-    'h1',
-    'h2',
-    'h3',
-    'h4',
-    'h5',
-    'h6',
-    'head',
-    'header',
-    'hgroup',
-    'hr',
-    'html',
-    'i',
-    'iframe',
-    'img',
-    'input',
-    'ins',
-    'kbd',
-    'label',
-    'legend',
-    'li',
-    'link',
-    'main',
-    'map',
-    'mark',
-    'menu',
-    'meta',
-    'meter',
-    'nav',
-    'noscript',
-    'object',
-    'ol',
-    'optgroup',
-    'option',
-    'output',
-    'p',
-    'picture',
-    'pre',
-    'progress',
-    'q',
-    'rp',
-    'rt',
-    'ruby',
-    's',
-    'samp',
-    'script',
-    'section',
-    'select',
-    'slot',
-    'small',
-    'source',
-    'span',
-    'strong',
-    'style',
-    'sub',
-    'summary',
-    'sup',
-    'table',
-    'tbody',
-    'td',
-    'template',
-    'textarea',
-    'tfoot',
-    'th',
-    'thead',
-    'time',
-    'title',
-    'tr',
-    'track',
-    'u',
-    'ul',
-    'var',
-    'video',
-    'wbr',
-]);
 /**
  * v1 angle-bracket internal link form. The capture group grabs the path-style
  * payload (starts with `/`, no whitespace, no `<` / `>` / `|` other than the
@@ -215,7 +94,7 @@ function shouldRewriteWikilink(innerPath) {
     // Only reject lowercase-ASCII first segments that are real HTML elements.
     if (!/^[a-z][a-z0-9]*$/.test(firstSegment))
         return true;
-    return !exports.KNOWN_HTML_ELEMENTS.has(firstSegment);
+    return !api_contract_1.KNOWN_HTML_ELEMENTS.has(firstSegment);
 }
 /**
  * Single-pass detect-and-rewrite. Returns the rewritten body together with the
@@ -246,36 +125,6 @@ function rewriteAndDetect(body) {
 function rewriteWikilinks(body) {
     return rewriteAndDetect(body).body;
 }
-/**
- * Resolve which user is recorded as the author of every rewritten revision.
- * The `updatePage`-equivalent path (`rewritePageBody`) ultimately calls
- * `Revision.prepareRevision`, which **throws** when handed a falsy user, so a
- * preflight rewrite MUST resolve a real acting user up front rather than rely
- * on per-page `lastUpdateUser`/`creator` (those can dangle to a deleted user).
- *
- * Order, mirroring the legacy `migrate-wikilink` command:
- *   1. `process.env.CROWI_MIGRATE_USER` — interpreted as an email; the named
- *      user must exist.
- *   2. otherwise the oldest admin user (`{ admin: true }` sorted by createdAt),
- *      deterministic across re-runs.
- *
- * Throws when neither yields a user so the operator gets a clear error instead
- * of a per-page `user should have _id` failure deep inside the rewrite.
- */
-async function resolveActingUserId(ctx) {
-    const User = ctx.crowi.model('User');
-    const explicit = process.env.CROWI_MIGRATE_USER;
-    if (explicit) {
-        const named = await User.findOne({ email: explicit }).select('_id').lean().exec();
-        if (named)
-            return String(named._id);
-        throw new Error(`CROWI_MIGRATE_USER='${explicit}' but no user with that email exists.`);
-    }
-    const admin = await User.findOne({ admin: true }).sort({ createdAt: 1 }).select('_id').lean().exec();
-    if (admin)
-        return String(admin._id);
-    throw new Error('wikilink-format: no admin user found; set CROWI_MIGRATE_USER=<email> or create an admin user first.');
-}
 /**
  * Walk every published page, keep those whose current revision body holds a
  * genuine legacy wikilink (`bodyHasRewritableWikilink` — the same full
@@ -394,7 +243,7 @@ exports.wikilinkFormat = (0, types_1.defineMigration)({
                     const pages = await collectRewritablePages(ctx);
                     return { name: 'rewrite-wikilink', transformed: 0, stats: { wouldRewrite: pages.length } };
                 }
-                const actingUserId = await resolveActingUserId(ctx);
+                const actingUserId = await (0, helpers_1.resolveActingUserId)(ctx, 'wikilink-format');
                 const pages = await collectRewritablePages(ctx);
                 ctx.progress.setTotal(pages.length);
                 let rewritten = 0;

package/dist/migration/migrations/wikilink-format.js.map

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

package/dist/migration/migrations/wikilink-html-recover.d.ts

@@ -0,0 +1,116 @@
+/**
+ * `wikilink-html-recover` (preflight layer) — undo the `wikilink-format`
+ * close-tag misfire.
+ *
+ * Before `font` / `center` / `marquee` / `blink` / `applet` were added to
+ * `KNOWN_HTML_ELEMENTS`, `wikilink-format` mistook the deprecated HTML close
+ * tags `</font>` etc. for v1 angle-bracket wikilinks and rewrote them to
+ * `[[/font]]` (§A). `wikilink-format` is recorded as applied and never
+ * re-runs, and the corrupted `[[/font]]` form no longer matches its detection
+ * regex, so it does not self-heal. This migration walks every published page
+ * and reverts the corrupted form `[[/<x>]]` back to the close tag `</x>` when:
+ *
+ *   - `x` is a single path segment (no `/` inside), AND
+ *   - `x` has no `|alias` segment, AND
+ *   - `x` is one of the FIVE deprecated tags the misfire could have produced.
+ *
+ * Scope is the 5 tags, NOT every known HTML element: those 5 were the ONLY
+ * names absent from `KNOWN_HTML_ELEMENTS` when `wikilink-format` ran, so they
+ * are the only `</x>` that could ever have been mis-rewritten to `[[/x]]`.
+ * `section` / `div` / `br` / `img` / etc. were always known and never rewritten,
+ * so a `[[/section]]` in real data is a GENUINE wikilink and must be preserved.
+ *
+ * Genuine wikilinks are otherwise preserved too: `[[/foo/bar]]` (multi-segment),
+ * `[[/font|alias]]` (aliased), `[[/Font]]` (uppercase → case-sensitive page
+ * name), and `[[/wiki-page]]` (non-recoverable name) are all left untouched.
+ *
+ * ── Inherent ambiguity ───────────────────────────────────────────────
+ * `[[/font]]` could be a corrupted `</font>` OR a genuine wikilink to a real
+ * page literally at `/font`. They are indistinguishable from the text alone.
+ * We resolve this conservatively: a `[[/<x>]]` whose `/<x>` matches a **live
+ * content page** (published, not a redirect stub) is NOT reverted — it is
+ * reported by `detect` so an operator can decide manually. The revert therefore
+ * only touches occurrences that have no same-named live page to be mistaken for.
+ * Pages literally named after a deprecated tag (`/font`, `/center`, …) are very
+ * rare, but an absent-page `[[/font]]` is still reverted — see the docs Caution.
+ * ─────────────────────────────────────────────────────────────────────
+ *
+ * Like `wikilink-format`, every body rewrite routes through
+ * `ctx.rewritePageBody` (the `updatePage`-equivalent path) so `yjsState` /
+ * `yjsCheckpointAt` are nulled and an active editor's stale `Y.Doc` cannot
+ * silently revert the recovery (RFC-0008 §4.3.1).
+ *
+ * Idempotent: once reverted, `</x>` no longer matches this migration's
+ * detection regex (it scans for `[[/...]]`, not `</...>`), and a re-run of
+ * `wikilink-format` leaves `</x>` alone because `x` is now in
+ * `KNOWN_HTML_ELEMENTS`.
+ */
+/**
+ * The five deprecated/obsolete presentational tags absent from
+ * `KNOWN_HTML_ELEMENTS` when `wikilink-format` first ran — the ONLY close tags
+ * the misfire could have rewritten to `[[/x]]`. Recovery is scoped to exactly
+ * these so a genuine single-segment wikilink to any other element-named page
+ * (`[[/section]]`, `[[/div]]`, `[[/br]]`) is never destroyed.
+ */
+export declare const RECOVERABLE_DEPRECATED_TAGS: ReadonlySet<string>;
+/**
+ * Matches a corrupted-wikilink candidate `[[/<segment>]]` with a single
+ * path segment and no alias. The capture group grabs the bare segment
+ * (`font` in `[[/font]]`). The `[^[\]|/]+` class excludes `[`, `]`, `|`, and
+ * `/`, so multi-segment (`[[/foo/bar]]`) and aliased (`[[/font|x]]`) forms
+ * never match here — only `shouldRecoverSegment` then filters by tag name.
+ */
+export declare const WIKILINK_HTML_CANDIDATE_REGEX: RegExp;
+/**
+ * True iff `[[/<segment>]]` should be reverted to `</segment>`: the segment is
+ * a lowercase-ASCII identifier that is one of the FIVE deprecated tags the
+ * misfire could have produced. Uppercase (`/Font`), non-deprecated element
+ * names (`/section`, `/div`), and non-HTML names (`/wiki`) are genuine
+ * wikilinks and are left alone.
+ */
+export declare function shouldRecoverSegment(segment: string): boolean;
+/** A single corrupted occurrence located in a body. */
+export interface RecoverableOccurrence {
+    /** The full raw match, e.g. `[[/font]]`. */
+    raw: string;
+    /** The deprecated HTML tag name, e.g. `font`. */
+    element: string;
+}
+/**
+ * Single-pass scan: locate every recoverable `[[/<deprecated-tag>]]` occurrence
+ * in `body`. Pure — no rewrite is applied here (the rewrite happens in
+ * `rewriteBody` after same-name page collisions have been resolved
+ * per-occurrence).
+ */
+export declare function detectRecoverable(body: string): RecoverableOccurrence[];
+/**
+ * Rewrite `body`, reverting `[[/<x>]]` → `</x>` for every recoverable element.
+ * Elements in `skip` (those that collide with a live same-named page) are left
+ * untouched. Returns the input by reference when nothing changed so callers can
+ * cheap-skip.
+ */
+export declare function rewriteBody(body: string, skip: ReadonlySet<string>): string;
+/**
+ * A skipped (collision) occurrence: the deprecated tag that was left as
+ * `[[/<element>]]` because a live same-named page exists, plus the page that
+ * holds the corrupted markup so an operator can open it from the report.
+ */
+export interface CollisionRecord {
+    /** The deprecated tag name left untouched, e.g. `font`. */
+    element: string;
+    /** `_id` of the page whose body still carries `[[/<element>]]`. */
+    pageId: string;
+    /** Path of that holding page (from the current revision), if available. */
+    pagePath?: string;
+}
+/**
+ * Render collision records into an operator-actionable string that names the
+ * holding page(s) per element, e.g.
+ * `/font (in /docs/setup, /guide); /center (in /notes)`. The element→pages
+ * mapping is preserved so the operator knows exactly which pages to open from
+ * the `migrate plan` output / boot warn log. Elements are sorted; per-element
+ * pages prefer the page path, falling back to the page id when the revision
+ * carried no path.
+ */
+export declare function formatCollisions(collisions: readonly CollisionRecord[]): string;
+export declare const wikilinkHtmlRecover: import("../types").MigrationDefinition;

package/dist/migration/migrations/wikilink-html-recover.js

@@ -0,0 +1,314 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wikilinkHtmlRecover = exports.WIKILINK_HTML_CANDIDATE_REGEX = exports.RECOVERABLE_DEPRECATED_TAGS = void 0;
+exports.shouldRecoverSegment = shouldRecoverSegment;
+exports.detectRecoverable = detectRecoverable;
+exports.rewriteBody = rewriteBody;
+exports.formatCollisions = formatCollisions;
+const page_1 = require("../../models/page");
+const types_1 = require("../types");
+const published_current_revision_1 = require("./published-current-revision");
+const helpers_1 = require("../helpers");
+/**
+ * `wikilink-html-recover` (preflight layer) — undo the `wikilink-format`
+ * close-tag misfire.
+ *
+ * Before `font` / `center` / `marquee` / `blink` / `applet` were added to
+ * `KNOWN_HTML_ELEMENTS`, `wikilink-format` mistook the deprecated HTML close
+ * tags `</font>` etc. for v1 angle-bracket wikilinks and rewrote them to
+ * `[[/font]]` (§A). `wikilink-format` is recorded as applied and never
+ * re-runs, and the corrupted `[[/font]]` form no longer matches its detection
+ * regex, so it does not self-heal. This migration walks every published page
+ * and reverts the corrupted form `[[/<x>]]` back to the close tag `</x>` when:
+ *
+ *   - `x` is a single path segment (no `/` inside), AND
+ *   - `x` has no `|alias` segment, AND
+ *   - `x` is one of the FIVE deprecated tags the misfire could have produced.
+ *
+ * Scope is the 5 tags, NOT every known HTML element: those 5 were the ONLY
+ * names absent from `KNOWN_HTML_ELEMENTS` when `wikilink-format` ran, so they
+ * are the only `</x>` that could ever have been mis-rewritten to `[[/x]]`.
+ * `section` / `div` / `br` / `img` / etc. were always known and never rewritten,
+ * so a `[[/section]]` in real data is a GENUINE wikilink and must be preserved.
+ *
+ * Genuine wikilinks are otherwise preserved too: `[[/foo/bar]]` (multi-segment),
+ * `[[/font|alias]]` (aliased), `[[/Font]]` (uppercase → case-sensitive page
+ * name), and `[[/wiki-page]]` (non-recoverable name) are all left untouched.
+ *
+ * ── Inherent ambiguity ───────────────────────────────────────────────
+ * `[[/font]]` could be a corrupted `</font>` OR a genuine wikilink to a real
+ * page literally at `/font`. They are indistinguishable from the text alone.
+ * We resolve this conservatively: a `[[/<x>]]` whose `/<x>` matches a **live
+ * content page** (published, not a redirect stub) is NOT reverted — it is
+ * reported by `detect` so an operator can decide manually. The revert therefore
+ * only touches occurrences that have no same-named live page to be mistaken for.
+ * Pages literally named after a deprecated tag (`/font`, `/center`, …) are very
+ * rare, but an absent-page `[[/font]]` is still reverted — see the docs Caution.
+ * ─────────────────────────────────────────────────────────────────────
+ *
+ * Like `wikilink-format`, every body rewrite routes through
+ * `ctx.rewritePageBody` (the `updatePage`-equivalent path) so `yjsState` /
+ * `yjsCheckpointAt` are nulled and an active editor's stale `Y.Doc` cannot
+ * silently revert the recovery (RFC-0008 §4.3.1).
+ *
+ * Idempotent: once reverted, `</x>` no longer matches this migration's
+ * detection regex (it scans for `[[/...]]`, not `</...>`), and a re-run of
+ * `wikilink-format` leaves `</x>` alone because `x` is now in
+ * `KNOWN_HTML_ELEMENTS`.
+ */
+/**
+ * The five deprecated/obsolete presentational tags absent from
+ * `KNOWN_HTML_ELEMENTS` when `wikilink-format` first ran — the ONLY close tags
+ * the misfire could have rewritten to `[[/x]]`. Recovery is scoped to exactly
+ * these so a genuine single-segment wikilink to any other element-named page
+ * (`[[/section]]`, `[[/div]]`, `[[/br]]`) is never destroyed.
+ */
+exports.RECOVERABLE_DEPRECATED_TAGS = new Set(['font', 'center', 'marquee', 'blink', 'applet']);
+/**
+ * Matches a corrupted-wikilink candidate `[[/<segment>]]` with a single
+ * path segment and no alias. The capture group grabs the bare segment
+ * (`font` in `[[/font]]`). The `[^[\]|/]+` class excludes `[`, `]`, `|`, and
+ * `/`, so multi-segment (`[[/foo/bar]]`) and aliased (`[[/font|x]]`) forms
+ * never match here — only `shouldRecoverSegment` then filters by tag name.
+ */
+exports.WIKILINK_HTML_CANDIDATE_REGEX = /\[\[\/([^[\]|/]+)\]\]/g;
+/**
+ * True iff `[[/<segment>]]` should be reverted to `</segment>`: the segment is
+ * a lowercase-ASCII identifier that is one of the FIVE deprecated tags the
+ * misfire could have produced. Uppercase (`/Font`), non-deprecated element
+ * names (`/section`, `/div`), and non-HTML names (`/wiki`) are genuine
+ * wikilinks and are left alone.
+ */
+function shouldRecoverSegment(segment) {
+    if (!/^[a-z][a-z0-9]*$/.test(segment))
+        return false;
+    return exports.RECOVERABLE_DEPRECATED_TAGS.has(segment);
+}
+/**
+ * Single-pass scan: locate every recoverable `[[/<deprecated-tag>]]` occurrence
+ * in `body`. Pure — no rewrite is applied here (the rewrite happens in
+ * `rewriteBody` after same-name page collisions have been resolved
+ * per-occurrence).
+ */
+function detectRecoverable(body) {
+    const occurrences = [];
+    exports.WIKILINK_HTML_CANDIDATE_REGEX.lastIndex = 0;
+    let match = exports.WIKILINK_HTML_CANDIDATE_REGEX.exec(body);
+    while (match !== null) {
+        const segment = match[1];
+        if (shouldRecoverSegment(segment)) {
+            occurrences.push({ raw: match[0], element: segment });
+        }
+        match = exports.WIKILINK_HTML_CANDIDATE_REGEX.exec(body);
+    }
+    return occurrences;
+}
+/**
+ * Rewrite `body`, reverting `[[/<x>]]` → `</x>` for every recoverable element.
+ * Elements in `skip` (those that collide with a live same-named page) are left
+ * untouched. Returns the input by reference when nothing changed so callers can
+ * cheap-skip.
+ */
+function rewriteBody(body, skip) {
+    let changed = false;
+    const rewritten = body.replace(exports.WIKILINK_HTML_CANDIDATE_REGEX, (whole, segment) => {
+        if (!shouldRecoverSegment(segment))
+            return whole;
+        if (skip.has(segment))
+            return whole;
+        changed = true;
+        return `</${segment}>`;
+    });
+    return changed ? rewritten : body;
+}
+/**
+ * A memoised live-content `/<element>` existence probe. The probe restricts to
+ * a **published, non-redirect** page so a leftover redirect stub (deleting
+ * `/font` leaves a published `redirect /trash/font` at `/font`) does NOT shadow
+ * a genuinely corrupted `[[/font]]`. `{ redirectTo: null }` matches both a
+ * missing field and an explicit null. `Page.exists` results are cached per
+ * element so a widely-used corrupted tag costs one probe across the whole walk.
+ *
+ * The status filter mirrors the walk itself (`forEachPublishedCurrentRevision`
+ * + `Page.isPublished`): `status: published` OR legacy `status: null`. As a
+ * PREFLIGHT run against a raw v1 DB (before any v2 boot writes `status`),
+ * a genuine `/font` page still carries `status: null`; matching only
+ * `STATUS_PUBLISHED` would miss it and let a real collision's `[[/font]]` be
+ * destroyed. The looser `$or` keeps the collision-skip firing in that window.
+ */
+function makePageExistsProbe(Page) {
+    const cache = new Map();
+    return async (element) => {
+        const cached = cache.get(element);
+        if (cached !== undefined)
+            return cached;
+        const exists = Boolean(await Page.exists({ path: `/${element}`, redirectTo: null, $or: [{ status: page_1.STATUS_PUBLISHED }, { status: null }] }));
+        cache.set(element, exists);
+        return exists;
+    };
+}
+/**
+ * Walk every published page's current revision body, detect corrupted
+ * `[[/<deprecated-tag>]]` occurrences, and for each candidate element check
+ * whether a live same-named page (`/<element>`) exists. Colliding elements are
+ * reported (not reverted); the rest are staged for rewrite.
+ */
+async function scan(ctx) {
+    const Page = ctx.crowi.model('Page');
+    const pageExists = makePageExistsProbe(Page);
+    const work = [];
+    const collidingElements = new Set();
+    const collisions = [];
+    let revertibleOccurrences = 0;
+    await (0, published_current_revision_1.forEachPublishedCurrentRevision)(ctx, { projection: 'body path' }, async ({ revision, pageId }) => {
+        const body = revision.body;
+        if (typeof body !== 'string' || !body.includes('[[/'))
+            return;
+        const pagePath = typeof revision.path === 'string' ? revision.path : undefined;
+        const occurrences = detectRecoverable(body);
+        if (occurrences.length === 0)
+            return;
+        // Partition this page's elements into collide-skip vs revertible. Each
+        // colliding element is recorded once per holding page so the report can
+        // name the page(s) an operator has to resolve by hand (a page may hold
+        // several colliding tags — dedupe within this page).
+        const skip = new Set();
+        let pageReverted = 0;
+        for (const occ of occurrences) {
+            if (await pageExists(occ.element)) {
+                if (!skip.has(occ.element))
+                    collisions.push({ element: occ.element, pageId, pagePath });
+                skip.add(occ.element);
+                collidingElements.add(occ.element);
+            }
+            else {
+                pageReverted += 1;
+            }
+        }
+        if (pageReverted === 0)
+            return;
+        const newBody = rewriteBody(body, skip);
+        work.push({ pageId, newBody });
+        revertibleOccurrences += pageReverted;
+    });
+    return { work, revertibleOccurrences, collidingElements, collisions };
+}
+/**
+ * Render collision records into an operator-actionable string that names the
+ * holding page(s) per element, e.g.
+ * `/font (in /docs/setup, /guide); /center (in /notes)`. The element→pages
+ * mapping is preserved so the operator knows exactly which pages to open from
+ * the `migrate plan` output / boot warn log. Elements are sorted; per-element
+ * pages prefer the page path, falling back to the page id when the revision
+ * carried no path.
+ */
+function formatCollisions(collisions) {
+    const byElement = new Map();
+    for (const c of collisions) {
+        const label = c.pagePath ?? c.pageId;
+        const list = byElement.get(c.element);
+        if (list) {
+            if (!list.includes(label))
+                list.push(label);
+        }
+        else {
+            byElement.set(c.element, [label]);
+        }
+    }
+    return [...byElement.entries()]
+        .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+        .map(([element, pages]) => `/${element} (in ${pages.join(', ')})`)
+        .join('; ');
+}
+exports.wikilinkHtmlRecover = (0, types_1.defineMigration)({
+    id: 'wikilink-html-recover',
+    fromVersion: '2.1',
+    toVersion: '2.1',
+    layer: 'preflight',
+    // `fromVersion: '2.1'` already sequences this after `wikilink-format`
+    // (`fromVersion: '1.x'`) — the registry orders by `fromVersion` FIRST
+    // (registry.ts compareMigrations), so the misfire's source is registered
+    // before this recovery regardless of `order`. No other `2.1` migration
+    // exists today, so `order` is cosmetic here.
+    order: 100,
+    description: 'Recover deprecated HTML close tags (</font> etc.) corrupted to wikilinks by the wikilink-format misfire',
+    /**
+     * Pending iff at least one published page's current revision body still
+     * carries a revertible `[[/<deprecated-tag>]]` whose element has no live
+     * same-named page. There is no index on `revision.body`, so this walks
+     * published pages (projecting `body`) and short-circuits at the first
+     * revertible occurrence.
+     *
+     * Colliding occurrences (`[[/font]]` with a live `/font` page) do NOT count
+     * as pending: this migration will never revert them, so reporting pending
+     * for them would block boot forever under preflight + `block`.
+     */
+    isPending: async (ctx) => {
+        const Page = ctx.crowi.model('Page');
+        const pageExists = makePageExistsProbe(Page);
+        let pending = false;
+        await (0, published_current_revision_1.forEachPublishedCurrentRevision)(ctx, { projection: 'body' }, async ({ revision }) => {
+            const body = revision.body;
+            if (typeof body !== 'string' || !body.includes('[[/'))
+                return;
+            for (const occ of detectRecoverable(body)) {
+                if (!(await pageExists(occ.element))) {
+                    pending = true;
+                    return published_current_revision_1.STOP;
+                }
+            }
+        });
+        return pending;
+    },
+    /**
+     * Full scan for `plan`: report how many pages / occurrences would be
+     * reverted plus, separately, the deprecated-tag names that were left alone
+     * because a live same-named page exists (the operator must resolve those
+     * by hand). Not called at boot.
+     */
+    detect: async (ctx) => {
+        const { work, revertibleOccurrences, collidingElements, collisions } = await scan(ctx);
+        const colliding = [...collidingElements].sort();
+        const collisionNote = colliding.length > 0 ? `; ${colliding.length} element(s) skipped due to same-named pages: ${formatCollisions(collisions)}` : '';
+        return {
+            summary: `${work.length} page(s) hold ${revertibleOccurrences} recoverable HTML close tag(s)${collisionNote}`,
+            counts: {
+                pages: work.length,
+                occurrences: revertibleOccurrences,
+                collisions: colliding.length,
+            },
+        };
+    },
+    stages: [
+        {
+            name: 'recover-html-close-tags',
+            fn: async (ctx) => {
+                if (ctx.dryRun) {
+                    const { work, revertibleOccurrences, collidingElements } = await scan(ctx);
+                    return {
+                        name: 'recover-html-close-tags',
+                        transformed: 0,
+                        stats: { wouldRevert: work.length, occurrences: revertibleOccurrences, collisions: collidingElements.size },
+                    };
+                }
+                const actingUserId = await (0, helpers_1.resolveActingUserId)(ctx, 'wikilink-html-recover');
+                const { work, collidingElements, collisions } = await scan(ctx);
+                ctx.progress.setTotal(work.length);
+                let reverted = 0;
+                for (const page of work) {
+                    await ctx.rewritePageBody(page.pageId, page.newBody, { userId: actingUserId });
+                    reverted += 1;
+                    ctx.progress.increment();
+                }
+                if (reverted > 0) {
+                    ctx.logger.info(`wikilink-html-recover: reverted HTML close tags on ${reverted} page(s) via the updatePage path (yjsState invalidated)`);
+                }
+                if (collidingElements.size > 0) {
+                    ctx.logger.warn(`wikilink-html-recover: left ${collidingElements.size} element(s) untouched because a same-named page exists: ${formatCollisions(collisions)} — open these pages and resolve them manually`);
+                }
+                return { name: 'recover-html-close-tags', transformed: reverted, stats: { collisions: collidingElements.size } };
+            },
+        },
+    ],
+});
+//# sourceMappingURL=wikilink-html-recover.js.map