project-librarian 0.2.1 → 0.3.0

package/dist/migration.js

@@ -33,11 +33,18 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.generatedMigrationInboxFiles = void 0;
 exports.classifyMarkdown = classifyMarkdown;
+exports.formOnlyMigrationDocumentReason = formOnlyMigrationDocumentReason;
 exports.extractMigrationUnits = extractMigrationUnits;
 exports.collectMigrationCoverageDiagnostics = collectMigrationCoverageDiagnostics;
+exports.collectMigrationUnitMapDiagnostics = collectMigrationUnitMapDiagnostics;
+exports.collectMigrationSplitPlanDiagnostics = collectMigrationSplitPlanDiagnostics;
 exports.markdownTableRows = markdownTableRows;
 exports.buildInbox = buildInbox;
+exports.isPrunableGeneratedMigrationInbox = isPrunableGeneratedMigrationInbox;
+exports.migrationSemanticReviewComplete = migrationSemanticReviewComplete;
+exports.buildMigrationBulkReviewPlan = buildMigrationBulkReviewPlan;
 exports.timestampSuffix = timestampSuffix;
 exports.prepareMigrationMode = prepareMigrationMode;
 exports.migrationTargetForKind = migrationTargetForKind;
@@ -45,9 +52,11 @@ exports.runMigrationMode = runMigrationMode;
 exports.normalizeMigrationStatus = normalizeMigrationStatus;
 exports.isMigrationInboxStatus = isMigrationInboxStatus;
 exports.migrationInboxStatusMap = migrationInboxStatusMap;
+exports.migrationCoverageStatusMap = migrationCoverageStatusMap;
 exports.semanticStatusForInboxStatus = semanticStatusForInboxStatus;
 exports.runReviewMigrationMode = runReviewMigrationMode;
 const fs = __importStar(require("node:fs"));
+const taxonomy_1 = require("./taxonomy");
 const workspace_1 = require("./workspace");
 const templates_1 = require("./templates");
 const wiki_files_1 = require("./wiki-files");
@@ -69,6 +78,9 @@ function classifyMarkdown(relativePath, text) {
 function markdownTableCell(value) {
     return String(value).replace(/\|/g, "\\|").replace(/\r?\n/g, "<br>");
 }
+function plainMarkdownTableCell(value) {
+    return markdownTableCell(String(value).replace(/\[/g, "&#91;").replace(/\]/g, "&#93;"));
+}
 function slugPart(value) {
     return value.toLowerCase().replace(/[^a-z0-9가-힣ぁ-んァ-ン一-龥]+/g, "-").replace(/^-|-$/g, "").slice(0, 40) || "unit";
 }
@@ -78,24 +90,65 @@ function unitSummary(value) {
 function nextUnitId(legacyPath, index, summary) {
     return `${legacyPath}#u${String(index).padStart(3, "0")}-${slugPart(summary)}`;
 }
+const generatedEmptyStarterPaths = new Map([
+    ["canonical/project-brief.md", "wiki/canonical/project-brief.md"],
+    ["canonical/open-questions.md", "wiki/canonical/open-questions.md"],
+    ["canonical/assumptions.md", "wiki/canonical/assumptions.md"],
+    ["canonical/risks.md", "wiki/canonical/risks.md"],
+]);
+function normalizedTemplateBody(value) {
+    return (0, workspace_1.stripMetadataHeader)(value).replace(/\r\n/g, "\n").trim().replace(/[ \t]+/g, " ");
+}
+function isGeneratedEmptyStarterDocument(legacyPath, text) {
+    const starterPath = generatedEmptyStarterPaths.get(legacyPath.replace(/^wiki\//, ""));
+    if (!starterPath)
+        return false;
+    const starter = templates_1.starterFiles[starterPath];
+    if (!starter)
+        return false;
+    return normalizedTemplateBody(text) === normalizedTemplateBody(starter);
+}
+function formOnlyMigrationDocumentReason(legacyPath, text) {
+    if ((0, workspace_1.metadataValue)(text, "status").toLowerCase() === "template")
+        return "metadata status is template";
+    if (isGeneratedEmptyStarterDocument(legacyPath, text))
+        return "matches generated empty starter page";
+    return "";
+}
+function isFormOnlyTemplateRouteUnit(legacyPath, value) {
+    if (legacyPath.replace(/^wiki\//, "") !== "index.md")
+        return false;
+    return /\bdecisions\/(?:decision-pack-template|full-adr-template)\b/.test(value);
+}
 function extractMigrationUnits(legacyPath, text) {
+    if (formOnlyMigrationDocumentReason(legacyPath, text))
+        return [];
     const body = (0, workspace_1.stripMetadataHeader)(text);
     const lines = body.split(/\r?\n/);
     const units = [];
     let heading = "";
+    let headingPath = [];
     let paragraph = [];
     let inCodeFence = false;
     let codeBlock = [];
+    let sourceUnitIndex = 0;
     const pushUnit = (type, value) => {
         const summary = unitSummary(value);
         if (!summary)
             return;
+        sourceUnitIndex += 1;
+        if (isFormOnlyTemplateRouteUnit(legacyPath, value))
+            return;
+        const unitHeadingPath = [...headingPath];
         units.push({
-            id: nextUnitId(legacyPath, units.length + 1, summary),
+            id: nextUnitId(legacyPath, sourceUnitIndex, summary),
             legacyPath,
             type,
             heading,
+            headingPath: unitHeadingPath,
+            content: value,
             summary,
+            classification: (0, taxonomy_1.classifyMigrationUnit)({ legacyPath, heading, headingPath: unitHeadingPath, content: value, summary }),
         });
     };
     const flushParagraph = () => {
@@ -132,6 +185,8 @@ function extractMigrationUnits(legacyPath, text) {
         if (headingMatch?.[2]) {
             flushParagraph();
             heading = headingMatch[2].trim();
+            const level = headingMatch[1]?.length ?? 1;
+            headingPath = [...headingPath.slice(0, level - 1), heading];
             pushUnit("heading", heading);
             continue;
         }
@@ -154,8 +209,89 @@ function extractMigrationUnits(legacyPath, text) {
 }
 function coverageTableRows(units) {
     if (units.length === 0)
-        return "| none | - | - | - | - | pending | - | - |\n";
-    return units.map((unit) => `| ${markdownTableCell(unit.id)} | ${markdownTableCell(unit.legacyPath)} | ${unit.type} | ${markdownTableCell(unit.heading || "-")} | ${markdownTableCell(unit.summary)} | pending | - | - |`).join("\n") + "\n";
+        return "| none | - | - | - | - | pending | - | - | - | - | - |\n";
+    return units.map((unit) => {
+        const status = unit.classification.confidence === "low" ? "needs-human-review" : "pending";
+        return `| ${markdownTableCell(unit.id)} | ${markdownTableCell(unit.legacyPath)} | ${unit.type} | ${plainMarkdownTableCell(unit.heading || "-")} | ${plainMarkdownTableCell(unit.summary)} | ${status} | ${markdownTableCell(unit.classification.target)} | - | ${markdownTableCell(unit.classification.label)} | ${unit.classification.confidence} | ${plainMarkdownTableCell(unit.classification.reason)} |`;
+    }).join("\n") + "\n";
+}
+function coverageRowsFromUnits(units) {
+    return units.map((unit) => ({
+        unitId: unit.id,
+        legacySource: unit.legacyPath,
+        type: unit.type,
+        heading: unit.heading || "-",
+        summary: unit.summary,
+        status: unit.classification.confidence === "low" ? "needs-human-review" : "pending",
+        target: unit.classification.target,
+        note: "-",
+        area: unit.classification.label,
+        confidence: unit.classification.confidence,
+        reason: unit.classification.reason,
+    }));
+}
+function normalizeCoverageStatus(value) {
+    const status = String(value || "").trim().toLowerCase();
+    if (isMigrationCoverageStatus(status))
+        return status;
+    return "pending";
+}
+function normalizeConfidence(value) {
+    const confidence = String(value || "").trim().toLowerCase();
+    if (isMigrationConfidence(confidence))
+        return confidence;
+    return "low";
+}
+function parseMigrationCoverageRows(text) {
+    return (0, wiki_files_1.parseMarkdownTableRows)(text, 11)
+        .filter((cells) => cells[0] !== "Unit ID")
+        .filter((cells) => !isMarkdownTableSeparatorRow(cells))
+        .map((cells) => ({
+        unitId: cells[0] ?? "",
+        legacySource: cells[1] ?? "",
+        type: cells[2] ?? "",
+        heading: cells[3] ?? "",
+        summary: cells[4] ?? "",
+        status: normalizeCoverageStatus(cells[5]),
+        target: cells[6] ?? "",
+        note: cells[7] ?? "",
+        area: cells[8] ?? "",
+        confidence: normalizeConfidence(cells[9]),
+        reason: cells[10] ?? "",
+    }))
+        .filter((row) => row.unitId);
+}
+function unitMapRows(units) {
+    if (units.length === 0)
+        return "| none | - | - | - | - | - | - | - | - | - |\n";
+    return units.map((unit) => {
+        const status = unit.classification.confidence === "low" ? "needs-human-review" : "pending";
+        return `| ${markdownTableCell(unit.id)} | ${markdownTableCell(unit.legacyPath)} | ${plainMarkdownTableCell(unit.headingPath.join(" > ") || "-")} | ${markdownTableCell(unit.classification.label)} | ${unit.classification.storage} | ${unit.classification.confidence} | ${markdownTableCell(unit.classification.target)} | ${plainMarkdownTableCell(unit.classification.reason)} | ${plainMarkdownTableCell(unit.summary)} | ${status} |`;
+    }).join("\n") + "\n";
+}
+function confidenceRank(value) {
+    if (value === "high")
+        return 3;
+    if (value === "medium")
+        return 2;
+    return 1;
+}
+function splitPlanRows(units) {
+    if (units.length === 0)
+        return "| none | - | - | - | 0 | - |\n";
+    const groups = new Map();
+    for (const unit of units) {
+        const key = unit.classification.target;
+        groups.set(key, [...(groups.get(key) ?? []), unit]);
+    }
+    return Array.from(groups.entries())
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([target, group]) => {
+        const first = group[0];
+        const confidence = group.map((unit) => unit.classification.confidence).sort((left, right) => confidenceRank(left) - confidenceRank(right))[0] ?? "low";
+        const unitIds = group.map((unit) => unit.id).join("<br>");
+        return `| ${markdownTableCell(target)} | ${markdownTableCell(first?.classification.label ?? "-")} | ${first?.classification.storage ?? "-"} | ${confidence} | ${group.length} | ${markdownTableCell(unitIds)} |`;
+    }).join("\n") + "\n";
 }
 function isMigrationCoverageStatus(value) {
     return ["adopted", "merged", "superseded", "rejected", "resolved", "needs-human-review", "pending"].includes(value);
@@ -168,11 +304,55 @@ function legacyWikiRoots() {
         .map((entry) => entry.name)
         .sort();
 }
+function migrationVerificationLegacyRoot() {
+    if (!(0, workspace_1.exists)("wiki/migration/verification.md"))
+        return null;
+    const legacyRoot = ((0, workspace_1.read)("wiki/migration/verification.md").match(/^- legacy root:\s*(.+)$/m) || [])[1]?.trim();
+    if (!legacyRoot || ["none", "unknown"].includes(legacyRoot))
+        return null;
+    return (0, workspace_1.exists)(legacyRoot) ? legacyRoot : null;
+}
+function activeMigrationLegacyRoots() {
+    const verifiedRoot = migrationVerificationLegacyRoot();
+    return verifiedRoot ? [verifiedRoot] : legacyWikiRoots();
+}
 function expectedMigrationUnits() {
-    return legacyWikiRoots()
+    return activeMigrationLegacyRoots()
         .flatMap((legacyRoot) => (0, wiki_files_1.walkMarkdownFiles)((0, workspace_1.abs)(legacyRoot), [], (0, workspace_1.abs)(legacyRoot)))
         .flatMap((file) => extractMigrationUnits(file.basePath, (0, workspace_1.read)(file.path)));
 }
+function isMigrationConfidence(value) {
+    return ["high", "medium", "low"].includes(value);
+}
+function isMigrationStorage(value) {
+    return ["canonical", "decisions", "sources", "meta"].includes(value);
+}
+exports.generatedMigrationInboxFiles = [
+    "wiki/canonical/migration-inbox.md",
+    "wiki/decisions/migration-inbox.md",
+    "wiki/sources/migration-inbox.md",
+];
+function isNewWikiTarget(value) {
+    return /^wiki\/(canonical|decisions|sources|meta)\//.test(value);
+}
+function expectedUnitMap(units) {
+    return new Map(units.map((unit) => [unit.id, unit]));
+}
+function splitLegacyUnitsCell(value) {
+    return value
+        .split(/<br\s*\/?>|,/i)
+        .map((item) => item.trim())
+        .filter(Boolean);
+}
+function isMarkdownTableSeparatorRow(cells) {
+    return cells.every((cell) => /^:?-+:?$/.test(cell.replace(/\s/g, "")));
+}
+function isReviewedCoverageRetarget(cells) {
+    const note = String(cells[7] || "").toLowerCase();
+    const reason = String(cells[10] || "").toLowerCase();
+    return note.includes("reviewed low-confidence content; retargeted")
+        || reason.includes("reviewed source context; taxonomy target assigned");
+}
 function collectMigrationCoverageDiagnostics() {
     const units = expectedMigrationUnits();
     if (units.length === 0)
@@ -187,12 +367,20 @@ function collectMigrationCoverageDiagnostics() {
     }
     const diagnostics = [];
     const expectedIds = new Set(units.map((unit) => unit.id));
+    const unitsById = expectedUnitMap(units);
     const seenIds = new Set();
-    const rows = (0, wiki_files_1.parseMarkdownTableRows)((0, workspace_1.read)("wiki/migration/coverage.md"), 8).filter((cells) => cells[0] !== "Unit ID");
+    const rows = (0, wiki_files_1.parseMarkdownTableRows)((0, workspace_1.read)("wiki/migration/coverage.md"), 8)
+        .filter((cells) => cells[0] !== "Unit ID")
+        .filter((cells) => !isMarkdownTableSeparatorRow(cells));
     for (const cells of rows) {
         const id = cells[0] || "";
         const status = String(cells[5] || "").trim().toLowerCase();
         const target = String(cells[6] || "").trim();
+        const confidence = String(cells[9] || "").trim().toLowerCase();
+        const expectedUnit = unitsById.get(id);
+        if (cells.length < 11) {
+            diagnostics.push({ code: "migration-coverage-schema-drift", severity: "error", file: "wiki/migration/coverage.md", message: `coverage row for ${id || "(blank)"} is missing Area, Confidence, or Reason columns; rerun --migrate` });
+        }
         if (seenIds.has(id)) {
             diagnostics.push({ code: "migration-duplicate-unit", severity: "error", file: "wiki/migration/coverage.md", message: `duplicate migration unit row: ${id}` });
         }
@@ -203,9 +391,18 @@ function collectMigrationCoverageDiagnostics() {
         if (!isMigrationCoverageStatus(status)) {
             diagnostics.push({ code: "migration-invalid-status", severity: "error", file: "wiki/migration/coverage.md", message: `unit ${id} has invalid status: ${status || "(blank)"}` });
         }
-        if (["adopted", "merged"].includes(status) && !/^wiki\/(canonical|decisions|sources|meta)\//.test(target)) {
+        if (confidence && !isMigrationConfidence(confidence)) {
+            diagnostics.push({ code: "migration-invalid-confidence", severity: "error", file: "wiki/migration/coverage.md", message: `unit ${id} has invalid confidence: ${confidence}` });
+        }
+        if (["adopted", "merged"].includes(status) && !isNewWikiTarget(target)) {
             diagnostics.push({ code: "migration-missing-target", severity: "error", file: "wiki/migration/coverage.md", message: `unit ${id} is ${status} but target is not a new wiki page` });
         }
+        if (status === "pending" && expectedUnit && target && target !== expectedUnit.classification.target && !isReviewedCoverageRetarget(cells)) {
+            diagnostics.push({ code: "migration-pending-target-drift", severity: "warn", file: "wiki/migration/coverage.md", message: `pending unit ${id} target differs from generated taxonomy target ${expectedUnit.classification.target}` });
+        }
+        if (["adopted", "merged"].includes(status) && confidence === "low") {
+            diagnostics.push({ code: "migration-low-confidence-adopted", severity: "warn", file: "wiki/migration/coverage.md", message: `unit ${id} is ${status} despite low confidence classification; verify the target manually` });
+        }
         if (/\bwiki_legacy(?:_|\b|\/)/.test(target)) {
             diagnostics.push({ code: "migration-legacy-target", severity: "error", file: "wiki/migration/coverage.md", message: `unit ${id} targets wiki_legacy* instead of migrated new-wiki truth` });
         }
@@ -220,10 +417,150 @@ function collectMigrationCoverageDiagnostics() {
     }
     return diagnostics.sort((a, b) => a.file.localeCompare(b.file) || a.code.localeCompare(b.code) || a.message.localeCompare(b.message));
 }
+function collectMigrationUnitMapDiagnostics() {
+    const units = expectedMigrationUnits();
+    if (units.length === 0)
+        return [];
+    const file = "wiki/migration/unit-map.md";
+    if (!(0, workspace_1.exists)(file)) {
+        return [{
+                code: "migration-unit-map-missing",
+                severity: "error",
+                file,
+                message: "migration unit map is missing; run --migrate to classify legacy meaning units",
+            }];
+    }
+    const diagnostics = [];
+    const unitsById = expectedUnitMap(units);
+    const seenIds = new Set();
+    const rows = (0, wiki_files_1.parseMarkdownTableRows)((0, workspace_1.read)(file), 10)
+        .filter((cells) => cells[0] !== "Unit ID")
+        .filter((cells) => !isMarkdownTableSeparatorRow(cells));
+    for (const cells of rows) {
+        const id = cells[0] || "";
+        const area = String(cells[3] || "").trim();
+        const storage = String(cells[4] || "").trim();
+        const confidence = String(cells[5] || "").trim().toLowerCase();
+        const target = String(cells[6] || "").trim();
+        const status = String(cells[9] || "").trim().toLowerCase();
+        const expectedUnit = unitsById.get(id);
+        if (seenIds.has(id)) {
+            diagnostics.push({ code: "migration-unit-map-duplicate-unit", severity: "error", file, message: `duplicate unit-map row: ${id}` });
+        }
+        seenIds.add(id);
+        if (!expectedUnit) {
+            diagnostics.push({ code: "migration-unit-map-stale-unit", severity: "warn", file, message: `unit-map row does not match current migration batch: ${id}` });
+        }
+        if (!isMigrationStorage(storage)) {
+            diagnostics.push({ code: "migration-unit-map-invalid-storage", severity: "error", file, message: `unit ${id} has invalid storage: ${storage || "(blank)"}` });
+        }
+        if (!isMigrationConfidence(confidence)) {
+            diagnostics.push({ code: "migration-unit-map-invalid-confidence", severity: "error", file, message: `unit ${id} has invalid confidence: ${confidence || "(blank)"}` });
+        }
+        if (!isMigrationCoverageStatus(status)) {
+            diagnostics.push({ code: "migration-unit-map-invalid-status", severity: "error", file, message: `unit ${id} has invalid status: ${status || "(blank)"}` });
+        }
+        if (!isNewWikiTarget(target)) {
+            diagnostics.push({ code: "migration-unit-map-invalid-target", severity: "error", file, message: `unit ${id} target is not under wiki/canonical, wiki/decisions, wiki/sources, or wiki/meta` });
+        }
+        if (expectedUnit) {
+            if (area !== expectedUnit.classification.label) {
+                diagnostics.push({ code: "migration-unit-map-area-drift", severity: "warn", file, message: `unit ${id} area differs from generated classification ${expectedUnit.classification.label}` });
+            }
+            if (storage !== expectedUnit.classification.storage) {
+                diagnostics.push({ code: "migration-unit-map-storage-drift", severity: "warn", file, message: `unit ${id} storage differs from generated classification ${expectedUnit.classification.storage}` });
+            }
+            if (confidence !== expectedUnit.classification.confidence) {
+                diagnostics.push({ code: "migration-unit-map-confidence-drift", severity: "warn", file, message: `unit ${id} confidence differs from generated classification ${expectedUnit.classification.confidence}` });
+            }
+            if (target !== expectedUnit.classification.target) {
+                diagnostics.push({ code: "migration-unit-map-target-drift", severity: "warn", file, message: `unit ${id} target differs from generated classification ${expectedUnit.classification.target}` });
+            }
+        }
+    }
+    for (const unit of units) {
+        if (!seenIds.has(unit.id)) {
+            diagnostics.push({ code: "migration-unit-map-unaccounted-unit", severity: "error", file: unit.legacyPath, message: `legacy meaning unit missing from unit map: ${unit.id}` });
+        }
+    }
+    return diagnostics.sort((a, b) => a.file.localeCompare(b.file) || a.code.localeCompare(b.code) || a.message.localeCompare(b.message));
+}
+function collectMigrationSplitPlanDiagnostics() {
+    const units = expectedMigrationUnits();
+    if (units.length === 0)
+        return [];
+    const file = "wiki/migration/split-plan.md";
+    if (!(0, workspace_1.exists)(file)) {
+        return [{
+                code: "migration-split-plan-missing",
+                severity: "error",
+                file,
+                message: "migration split plan is missing; run --migrate to group legacy units by target page",
+            }];
+    }
+    const diagnostics = [];
+    const unitsById = expectedUnitMap(units);
+    const seenTargets = new Set();
+    const seenUnitIds = new Set();
+    const rows = (0, wiki_files_1.parseMarkdownTableRows)((0, workspace_1.read)(file), 6)
+        .filter((cells) => cells[0] !== "Suggested Target")
+        .filter((cells) => !isMarkdownTableSeparatorRow(cells));
+    for (const cells of rows) {
+        const target = String(cells[0] || "").trim();
+        const area = String(cells[1] || "").trim();
+        const storage = String(cells[2] || "").trim();
+        const confidence = String(cells[3] || "").trim().toLowerCase();
+        const count = Number(String(cells[4] || "").trim());
+        const unitIds = splitLegacyUnitsCell(cells[5] || "");
+        const targetStorage = target.match(/^wiki\/([^/]+)\//)?.[1] ?? "";
+        if (seenTargets.has(target)) {
+            diagnostics.push({ code: "migration-split-plan-duplicate-target", severity: "error", file, message: `duplicate split-plan target row: ${target}` });
+        }
+        seenTargets.add(target);
+        if (!isNewWikiTarget(target)) {
+            diagnostics.push({ code: "migration-split-plan-invalid-target", severity: "error", file, message: `split-plan target is not under wiki/canonical, wiki/decisions, wiki/sources, or wiki/meta: ${target || "(blank)"}` });
+        }
+        if (!isMigrationStorage(storage)) {
+            diagnostics.push({ code: "migration-split-plan-invalid-storage", severity: "error", file, message: `target ${target || "(blank)"} has invalid storage: ${storage || "(blank)"}` });
+        }
+        if (isMigrationStorage(storage) && targetStorage && storage !== targetStorage) {
+            diagnostics.push({ code: "migration-split-plan-storage-target-mismatch", severity: "error", file, message: `target ${target} is under wiki/${targetStorage}/ but split-plan storage is ${storage}` });
+        }
+        if (!isMigrationConfidence(confidence)) {
+            diagnostics.push({ code: "migration-split-plan-invalid-confidence", severity: "error", file, message: `target ${target || "(blank)"} has invalid confidence: ${confidence || "(blank)"}` });
+        }
+        if (!Number.isInteger(count) || count !== unitIds.length) {
+            diagnostics.push({ code: "migration-split-plan-count-mismatch", severity: "error", file, message: `target ${target || "(blank)"} says ${Number.isFinite(count) ? count : "(blank)"} units but lists ${unitIds.length}` });
+        }
+        for (const unitId of unitIds) {
+            const expectedUnit = unitsById.get(unitId);
+            if (seenUnitIds.has(unitId)) {
+                diagnostics.push({ code: "migration-split-plan-duplicate-unit", severity: "error", file, message: `unit appears in more than one split-plan row: ${unitId}` });
+            }
+            seenUnitIds.add(unitId);
+            if (!expectedUnit) {
+                diagnostics.push({ code: "migration-split-plan-stale-unit", severity: "warn", file, message: `split-plan unit does not match current migration batch: ${unitId}` });
+                continue;
+            }
+            if (expectedUnit.classification.target !== target) {
+                diagnostics.push({ code: "migration-split-plan-target-drift", severity: "warn", file, message: `unit ${unitId} is listed under ${target} but generated classification targets ${expectedUnit.classification.target}` });
+            }
+            if (expectedUnit.classification.label !== area) {
+                diagnostics.push({ code: "migration-split-plan-area-drift", severity: "warn", file, message: `unit ${unitId} row area differs from generated classification ${expectedUnit.classification.label}` });
+            }
+        }
+    }
+    for (const unit of units) {
+        if (!seenUnitIds.has(unit.id)) {
+            diagnostics.push({ code: "migration-split-plan-unaccounted-unit", severity: "error", file: unit.legacyPath, message: `legacy meaning unit missing from split plan: ${unit.id}` });
+        }
+    }
+    return diagnostics.sort((a, b) => a.file.localeCompare(b.file) || a.code.localeCompare(b.code) || a.message.localeCompare(b.message));
+}
 function markdownTableRows(items) {
     if (items.length === 0)
         return "| none | - | - | - |\n";
-    return items.map((item) => `| ${markdownTableCell(item.path)} | ${markdownTableCell(item.title)} | ${markdownTableCell(item.summary)} | pending |`).join("\n") + "\n";
+    return items.map((item) => `| ${markdownTableCell(item.path)} | ${plainMarkdownTableCell(item.title)} | ${plainMarkdownTableCell(item.summary)} | pending |`).join("\n") + "\n";
 }
 function buildInbox(title, description, items) {
     return `${(0, templates_1.metadata)("migration-inbox", "medium", "wiki/meta/wiki-ops-v1-decisions.md", "migration candidates are adopted or rescanned")}
@@ -240,6 +577,34 @@ function buildInbox(title, description, items) {
 | --- | --- | --- | --- |
 ${markdownTableRows(items)}`;
 }
+function wikiLinkForMigrationPath(relativePath) {
+    return `[[${relativePath.replace(/^wiki\//, "").replace(/\.(md|mdx)$/i, "")}]]`;
+}
+function isGeneratedFileLevelMigrationInboxText(text) {
+    if ((0, workspace_1.metadataValue)(text, "scope") !== "migration-inbox")
+        return false;
+    const body = (0, workspace_1.stripMetadataHeader)(text).trim();
+    if (!body.includes("| Source | Title | Summary | Status |"))
+        return false;
+    if (!body.includes("Status values: pending, adopted, rejected, resolved, needs-human-review."))
+        return false;
+    const headings = Array.from(body.matchAll(/^#{1,6}\s+(.+)$/gm)).map((match) => match[1]?.trim() ?? "");
+    if (headings.length !== 2)
+        return false;
+    return (headings[0]?.endsWith("Migration Inbox") ?? false) && headings[1] === "TL;DR";
+}
+function isPrunableGeneratedMigrationInbox(relativePath) {
+    if (!exports.generatedMigrationInboxFiles.includes(relativePath))
+        return false;
+    if (!(0, workspace_1.exists)(relativePath))
+        return false;
+    return isGeneratedFileLevelMigrationInboxText((0, workspace_1.read)(relativePath));
+}
+function migrationSemanticReviewComplete() {
+    if (!(0, workspace_1.exists)("wiki/migration/verification.md"))
+        return false;
+    return /^- semantic migration complete:\s*yes, for\b/m.test((0, workspace_1.read)("wiki/migration/verification.md"));
+}
 function migrationBatchScope(legacyRoot) {
     return `${workspace_1.today} migration batch${legacyRoot && legacyRoot !== "none" ? ` from ${legacyRoot}` : ""}`;
 }
@@ -256,6 +621,325 @@ function completionScopeSection(batchScope) {
 - For a fresh rebuild request, treat current \`wiki/\` as the legacy source unless the user says otherwise: preserve it as \`wiki_legacy*\`, create a fresh standard \`wiki/\`, migrate/adopt content from the preserved legacy source, then refresh routing and diagnostics.
 `;
 }
+function completedMigrationStartupBlock(legacyRoot, remainingInboxes) {
+    const retainedInboxLine = remainingInboxes.length === 0
+        ? "- Generated file-level migration inboxes were pruned after semantic completion."
+        : `- Generated file-level migration inboxes were pruned where safe; retained inbox-like pages: ${remainingInboxes.map((file) => `\`${file}\``).join(", ")}.`;
+    return `<!-- PROJECT-WIKI-MIGRATION:START -->
+## Migration State
+
+- ${workspace_1.today}: migration review is complete for \`${legacyRoot || "wiki_legacy"}\`; pending 0 and needs-human-review 0.
+${retainedInboxLine}
+- Migration ledgers under \`wiki/migration/\` remain as audit evidence.
+- \`${legacyRoot || "wiki_legacy"}\` remains preserved as source/rollback archive and is not deleted automatically.
+- Migration completion status is scoped to this batch only. For a future fresh rebuild request, treat current \`wiki/\` as the legacy source unless the user says otherwise.
+<!-- PROJECT-WIKI-MIGRATION:END -->`;
+}
+function completedMigrationIndexBlock(remainingInboxes) {
+    const inboxLine = remainingInboxes.length === 0
+        ? "- Generated file-level migration inboxes were pruned after semantic completion."
+        : `- Retained inbox-like pages: ${remainingInboxes.map(wikiLinkForMigrationPath).join(", ")}.`;
+    return `<!-- PROJECT-WIKI-MIGRATION:START -->
+## Migration
+
+- Core ledgers: [[migration/coverage]], [[migration/review]], [[migration/verification]], [[migration/bulk-review]].
+- Planning ledgers: [[migration/plan]], [[migration/inventory]], [[migration/unit-map]], [[migration/split-plan]].
+${inboxLine}
+- Keep \`wiki_legacy*\` only as source/rollback archive after semantic completion; it is not deleted automatically.
+<!-- PROJECT-WIKI-MIGRATION:END -->`;
+}
+function pruneCompletedMigrationJunk(legacyRoot) {
+    const results = [];
+    for (const file of exports.generatedMigrationInboxFiles) {
+        if (!isPrunableGeneratedMigrationInbox(file))
+            continue;
+        fs.unlinkSync((0, workspace_1.abs)(file));
+        results.push([file, "removed"]);
+    }
+    const remainingInboxes = exports.generatedMigrationInboxFiles.filter((file) => (0, workspace_1.exists)(file));
+    if ((0, workspace_1.exists)("wiki/startup.md")) {
+        results.push(["wiki/startup.md migration state", (0, workspace_1.upsertMarkedSection)("wiki/startup.md", "<!-- PROJECT-WIKI-MIGRATION:START -->", "<!-- PROJECT-WIKI-MIGRATION:END -->", completedMigrationStartupBlock(legacyRoot, remainingInboxes))]);
+    }
+    if ((0, workspace_1.exists)("wiki/index.md")) {
+        results.push(["wiki/index.md migration router", (0, workspace_1.upsertMarkedSection)("wiki/index.md", "<!-- PROJECT-WIKI-MIGRATION:START -->", "<!-- PROJECT-WIKI-MIGRATION:END -->", completedMigrationIndexBlock(remainingInboxes))]);
+    }
+    return results;
+}
+function isOpenMigrationRow(row) {
+    return row.inboxStatus === "pending" || row.inboxStatus === "needs-human-review" || row.semanticStatus === "pending semantic rewrite";
+}
+function sourceLooksGeneratedOrRouter(source) {
+    return /^(AGENTS|CLAUDE|GEMINI|README|startup|index)\.md$/.test(source)
+        || /^meta\/(operating-model|decision-policy|wiki-ops-v1-decisions|document-taxonomy)\.md$/.test(source);
+}
+const structuralHumanReviewHeadings = new Set([
+    "Active",
+    "Audience",
+    "Claim Boundary",
+    "Code-Proven Behavior",
+    "Code-proven behavior",
+    "Constraints",
+    "Core Scenarios",
+    "Current State",
+    "Diagnostics And Search",
+    "Discovery Rules",
+    "Evidence",
+    "Generated Output Ownership",
+    "Incremental Update Behavior",
+    "Inference",
+    "Mode Surface",
+    "Parser Backend Registry",
+    "Product",
+    "Product Direction",
+    "Project State",
+    "Query And Staleness",
+    "Read On Demand",
+    "Related Canonical Pages",
+    "Resolved",
+    "Retired",
+    "Routing And Inbox",
+    "Skill Installation",
+    "Success Criteria",
+    "TL;DR",
+    "Token Discipline",
+    "Tree-Sitter Mode",
+    "Workspace And Ownership Adapters",
+]);
+function normalizedReviewText(value) {
+    return value.replace(/\\\|/g, "|").replace(/<br>/g, " ").replace(/\s+/g, " ").trim();
+}
+function isMarkdownTableDividerSummary(summary) {
+    return /^\|?\s*:?-{3,}:?\s*(\|\s*:?-{3,}:?\s*)+\|?$/.test(summary);
+}
+function isMarkdownTableHeaderSummary(summary) {
+    if (!/^\|.+\|$/.test(summary))
+        return false;
+    if (summary.includes("`"))
+        return false;
+    if (isMarkdownTableDividerSummary(summary))
+        return true;
+    const cells = summary.split("|").map((cell) => cell.trim()).filter(Boolean);
+    return cells.length > 1 && cells.every((cell) => /^[A-Z가-힣][A-Za-z가-힣 /-]{0,40}$/.test(cell));
+}
+function isStructuralHumanReviewRow(row) {
+    const summary = normalizedReviewText(row.summary);
+    const heading = normalizedReviewText(row.heading);
+    if (row.unitType === "heading" && (summary === heading || structuralHumanReviewHeadings.has(summary)))
+        return true;
+    if (row.unitType === "paragraph" && /^(Code-proven facts:|Code-proven behavior:|Evidence:|Inference:|Product framing:)$/i.test(summary))
+        return true;
+    if (isMarkdownTableDividerSummary(summary) || isMarkdownTableHeaderSummary(summary))
+        return true;
+    return false;
+}
+function confidenceCounts(rows) {
+    return {
+        high: rows.filter((row) => row.confidence === "high").length,
+        medium: rows.filter((row) => row.confidence === "medium").length,
+        low: rows.filter((row) => row.confidence === "low").length,
+    };
+}
+function groupBulkRows(rows, keyForRow) {
+    const groups = new Map();
+    for (const row of rows) {
+        const key = keyForRow(row);
+        groups.set(key, [...(groups.get(key) ?? []), row]);
+    }
+    return Array.from(groups.entries())
+        .map(([key, groupRows]) => {
+        const counts = confidenceCounts(groupRows);
+        return {
+            key,
+            rows: groupRows.length,
+            ...counts,
+            sources: Array.from(new Set(groupRows.map((row) => row.legacySource))).sort(),
+            targets: Array.from(new Set(groupRows.map((row) => row.target))).sort(),
+            areas: Array.from(new Set(groupRows.map((row) => row.area))).sort(),
+            sampleUnitIds: groupRows.slice(0, 5).map((row) => row.unitId),
+            sampleSummaries: groupRows.slice(0, 3).map((row) => row.summary),
+        };
+    })
+        .sort((left, right) => right.rows - left.rows || left.key.localeCompare(right.key));
+}
+function groupList(values, limit = 4) {
+    const shown = values.slice(0, limit).map((value) => markdownTableCell(value));
+    const hidden = values.length - shown.length;
+    return hidden > 0 ? `${shown.join("<br>")}<br>+${hidden} more` : shown.join("<br>") || "-";
+}
+function sampleList(values, limit = 3) {
+    const shown = values.slice(0, limit).map((value) => plainMarkdownTableCell(value));
+    const hidden = values.length - shown.length;
+    return hidden > 0 ? `${shown.join("<br>")}<br>+${hidden} more` : shown.join("<br>") || "-";
+}
+function confidenceMix(group) {
+    return `high ${group.high}, medium ${group.medium}, low ${group.low}`;
+}
+function renderTargetGroupRows(groups, suggestedStatus, limit = Number.POSITIVE_INFINITY) {
+    const selected = groups.slice(0, limit);
+    if (selected.length === 0)
+        return "| none | - | 0 | - | - | - |\n";
+    return selected.map((group) => `| ${markdownTableCell(group.key)} | ${group.rows} | ${confidenceMix(group)} | ${groupList(group.sources)} | ${groupList(group.areas)} | ${markdownTableCell(suggestedStatus)} |`).join("\n") + "\n";
+}
+function renderSourceGroupRows(groups, suggestedStatus, limit = Number.POSITIVE_INFINITY) {
+    const selected = groups.slice(0, limit);
+    if (selected.length === 0)
+        return "| none | 0 | - | - | - | - |\n";
+    return selected.map((group) => `| ${markdownTableCell(group.key)} | ${group.rows} | ${confidenceMix(group)} | ${groupList(group.targets, 3)} | ${groupList(group.areas)} | ${markdownTableCell(suggestedStatus)} |`).join("\n") + "\n";
+}
+function renderHumanReviewGroupRows(groups, suggestedStatus, limit = Number.POSITIVE_INFINITY) {
+    const selected = groups.slice(0, limit);
+    if (selected.length === 0)
+        return "| none | 0 | - | - | - | - | - |\n";
+    return selected.map((group) => `| ${markdownTableCell(group.key)} | ${group.rows} | ${confidenceMix(group)} | ${groupList(group.targets, 3)} | ${sampleList(group.sampleSummaries)} | ${groupList(group.sampleUnitIds, 3)} | ${markdownTableCell(suggestedStatus)} |`).join("\n") + "\n";
+}
+function buildMigrationBulkReviewPlan(rows) {
+    const openRows = rows.filter(isOpenMigrationRow);
+    const humanRows = openRows.filter((row) => row.inboxStatus === "needs-human-review" || row.confidence === "low");
+    const humanStructuralRows = humanRows.filter(isStructuralHumanReviewRow);
+    const humanContentRows = humanRows.filter((row) => !isStructuralHumanReviewRow(row));
+    const highRows = openRows.filter((row) => row.inboxStatus === "pending" && row.confidence === "high");
+    const mediumRows = openRows.filter((row) => row.inboxStatus === "pending" && row.confidence === "medium");
+    const sourceGroups = groupBulkRows(openRows, (row) => row.legacySource);
+    const singleTargetSourceGroups = sourceGroups.filter((group) => group.targets.length === 1 && group.low === 0);
+    const generatedSourceGroups = sourceGroups.filter((group) => sourceLooksGeneratedOrRouter(group.key));
+    return {
+        totalRows: rows.length,
+        openRows: openRows.length,
+        completedRows: rows.length - openRows.length,
+        highConfidenceRows: highRows.length,
+        mediumConfidenceRows: mediumRows.length,
+        humanReviewRows: humanRows.length,
+        humanReviewStructuralRows: humanStructuralRows.length,
+        humanReviewContentRows: humanContentRows.length,
+        highTargetGroups: groupBulkRows(highRows, (row) => row.target),
+        mediumTargetGroups: groupBulkRows(mediumRows, (row) => row.target),
+        singleTargetSourceGroups,
+        humanReviewSourceGroups: groupBulkRows(humanRows, (row) => row.legacySource),
+        humanReviewStructuralSourceGroups: groupBulkRows(humanStructuralRows, (row) => row.legacySource),
+        humanReviewContentSourceGroups: groupBulkRows(humanContentRows, (row) => row.legacySource),
+        generatedSourceGroups,
+    };
+}
+function bulkReviewRowsFromCoverage(coverageRows, reviewedRows = []) {
+    const reviewedByUnit = new Map(reviewedRows.map((row) => [row.legacyPath, row]));
+    return coverageRows.map((row) => {
+        const reviewed = reviewedByUnit.get(row.unitId);
+        const inboxStatus = reviewed?.inboxStatus ?? normalizeCoverageStatusForReview(row.status);
+        const semanticStatus = reviewed?.semanticStatus ?? semanticStatusForInboxStatus(inboxStatus);
+        return {
+            unitId: row.unitId,
+            legacySource: row.legacySource,
+            unitType: row.type,
+            heading: row.heading,
+            summary: row.summary,
+            target: reviewed?.target || row.target,
+            area: row.area,
+            confidence: row.confidence,
+            inboxStatus,
+            semanticStatus,
+            reason: row.reason,
+        };
+    });
+}
+function bulkReviewSummarySection(plan) {
+    return `## Bulk Review Summary
+
+- Do not review all ${plan.totalRows} rows one by one; use [[migration/bulk-review]] to process batches.
+- Completed rows: ${plan.completedRows}
+- Open rows: ${plan.openRows}
+- High-confidence bulk candidates: ${plan.highConfidenceRows} rows across ${plan.highTargetGroups.length} target groups.
+- Medium-confidence batch candidates: ${plan.mediumConfidenceRows} rows across ${plan.mediumTargetGroups.length} target groups.
+- Human-review priority: ${plan.humanReviewContentSourceGroups.length} content-bearing source batches (${plan.humanReviewContentRows} rows), plus ${plan.humanReviewStructuralRows} structural/layout rows handled with the same source review.
+
+| Queue | Rows | Groups | Recommended handling |
+| --- | ---: | ---: | --- |
+| High-confidence target batches | ${plan.highConfidenceRows} | ${plan.highTargetGroups.length} | Rewrite or confirm target page, then bulk mark rows adopted or merged. |
+| Medium-confidence target batches | ${plan.mediumConfidenceRows} | ${plan.mediumTargetGroups.length} | Review by target page, sample source evidence, then bulk mark rows. |
+| Human-review content batches | ${plan.humanReviewContentRows} | ${plan.humanReviewContentSourceGroups.length} | Inspect by source page; do not handle as isolated rows unless a batch remains ambiguous. |
+| Human-review structural/layout rows | ${plan.humanReviewStructuralRows} | ${plan.humanReviewStructuralSourceGroups.length} | Close with the source rewrite when headings, table headers, or boilerplate carry no standalone project truth. |
+| Single-target source shortcuts | ${plan.singleTargetSourceGroups.reduce((sum, group) => sum + group.rows, 0)} | ${plan.singleTargetSourceGroups.length} | One source maps to one target; a file-level inbox decision can close the batch. |
+| Generated/router source candidates | ${plan.generatedSourceGroups.reduce((sum, group) => sum + group.rows, 0)} | ${plan.generatedSourceGroups.length} | Compare against regenerated operating docs; mark superseded or resolved only when no project truth remains. |
+`;
+}
+function renderMigrationBulkReviewDocument(plan, batchScope) {
+    return `${(0, templates_1.metadata)("migration-bulk-review", "on-demand", "wiki/meta/wiki-ops-v1-decisions.md", "migration coverage or confidence grouping changes")}
+# Migration Bulk Review Plan
+
+## TL;DR
+
+- Scope: ${batchScope}
+- Total rows: ${plan.totalRows}
+- Open rows: ${plan.openRows}
+- Completed rows: ${plan.completedRows}
+- The low-confidence queue is ${plan.humanReviewContentSourceGroups.length} content-bearing source batches, not ${plan.humanReviewRows} isolated row decisions.
+- Structural/layout low rows: ${plan.humanReviewStructuralRows}; content-bearing low rows: ${plan.humanReviewContentRows}.
+- This page is advisory. It never changes \`wiki/migration/coverage.md\` statuses by itself.
+
+${bulkReviewSummarySection(plan)}
+
+## Human-Review Triage
+
+Low-confidence rows are not intended to be reviewed one by one. Start with content-bearing source batches, then close structural/layout rows while rewriting or rejecting that same source.
+
+| Queue | Rows | Source batches | What to do |
+| --- | ---: | ---: | --- |
+| Content-bearing low rows | ${plan.humanReviewContentRows} | ${plan.humanReviewContentSourceGroups.length} | Review the legacy source page once, adopt/retarget/reject the useful meaning, then mark its low rows together. |
+| Structural/layout low rows | ${plan.humanReviewStructuralRows} | ${plan.humanReviewStructuralSourceGroups.length} | Treat headings, TL;DR labels, table headers, and separators as source-structure evidence; usually close them with the source page decision. |
+| Total low/needs-human-review rows | ${plan.humanReviewRows} | ${plan.humanReviewSourceGroups.length} | Escalate to row-level review only when a source batch mixes unrelated truths that cannot be split safely. |
+
+## Single-Target Source Shortcuts
+
+Use these when a legacy source maps to one target and has no low-confidence rows. A compatible file-level inbox status can close the whole source batch.
+
+| Legacy Source | Rows | Confidence Mix | Target | Areas | Suggested status |
+| --- | ---: | --- | --- | --- | --- |
+${renderSourceGroupRows(plan.singleTargetSourceGroups, "adopted or merged after target rewrite")}
+
+## High-Confidence Target Batches
+
+| Suggested Target | Rows | Confidence Mix | Sources | Areas | Suggested status |
+| --- | ---: | --- | --- | --- | --- |
+${renderTargetGroupRows(plan.highTargetGroups, "adopted or merged after target rewrite")}
+
+## Medium-Confidence Target Batches
+
+| Suggested Target | Rows | Confidence Mix | Sources | Areas | Suggested status |
+| --- | ---: | --- | --- | --- | --- |
+${renderTargetGroupRows(plan.mediumTargetGroups, "review by target page before adopting")}
+
+## Content-Bearing Human-Review Batches
+
+These are the practical manual review units. Review each legacy source page once; use the sample rows to find the relevant evidence quickly.
+
+| Legacy Source | Rows | Confidence Mix | Targets | Sample summaries | Sample unit ids | Suggested status |
+| --- | ---: | --- | --- | --- | --- | --- |
+${renderHumanReviewGroupRows(plan.humanReviewContentSourceGroups, "source-batch adopt, retarget, resolve, or reject")}
+
+## Structural Human-Review Batches
+
+These rows are low-confidence because they are headings, table scaffolding, or boilerplate labels. They rarely require standalone decisions.
+
+| Legacy Source | Rows | Confidence Mix | Targets | Sample summaries | Sample unit ids | Suggested status |
+| --- | ---: | --- | --- | --- | --- | --- |
+${renderHumanReviewGroupRows(plan.humanReviewStructuralSourceGroups, "close with the same source-page decision")}
+
+## All Human-Review Source Groups
+
+These rows have low confidence or are explicitly marked needs-human-review.
+
+| Legacy Source | Rows | Confidence Mix | Targets | Areas | Suggested status |
+| --- | ---: | --- | --- | --- | --- |
+${renderSourceGroupRows(plan.humanReviewSourceGroups, "manual adopt, resolve, reject, or retarget")}
+
+## Generated Or Router Source Candidates
+
+These sources often overlap with regenerated bootstrap/wiki operating documents. Do not discard them automatically; compare for project-specific truth first.
+
+| Legacy Source | Rows | Confidence Mix | Targets | Areas | Suggested status |
+| --- | ---: | --- | --- | --- | --- |
+${renderSourceGroupRows(plan.generatedSourceGroups, "superseded or resolved only after comparison")}
+`;
+}
 function timestampSuffix() {
     return new Date().toISOString().replace(/[-:]/g, "").replace(/\..+$/, "").replace("T", "_");
 }
@@ -287,13 +971,19 @@ function migrationTargetForKind(kind) {
         return "wiki/decisions/migration-inbox.md";
     if (kind === "source")
         return "wiki/sources/migration-inbox.md";
+    if (kind === "meta")
+        return "wiki/meta/migration-inbox.md";
     return "wiki/canonical/migration-inbox.md";
 }
 function runMigrationMode(migrationState) {
     const legacyPath = migrationState.legacyPath;
     const markdownFiles = legacyPath && (0, workspace_1.exists)(legacyPath) ? (0, wiki_files_1.walkMarkdownFiles)((0, workspace_1.abs)(legacyPath), [], (0, workspace_1.abs)(legacyPath)) : [];
-    const items = markdownFiles.map((file) => {
+    const fileRecords = markdownFiles.map((file) => {
         const text = (0, workspace_1.read)(file.path);
+        return { file, text, formOnlyReason: formOnlyMigrationDocumentReason(file.basePath, text) };
+    });
+    const skippedFormOnlyFiles = fileRecords.filter((record) => record.formOnlyReason);
+    const items = fileRecords.filter((record) => !record.formOnlyReason).map(({ file, text }) => {
         return {
             path: file.path,
             legacyPath: file.basePath,
@@ -307,11 +997,15 @@ function runMigrationMode(migrationState) {
         canonical: items.filter((item) => item.kind === "canonical"),
         decision: items.filter((item) => item.kind === "decision"),
         source: items.filter((item) => item.kind === "source"),
+        meta: items.filter((item) => item.kind === "meta"),
         other: items.filter((item) => item.kind === "other"),
     };
     const inventoryRows = items.length === 0
         ? "| none | - | - | 0 | - |\n"
-        : items.map((item) => `| ${markdownTableCell(item.path)} | ${item.kind} | ${markdownTableCell(item.title)} | ${item.bytes} | ${markdownTableCell(item.summary)} |`).join("\n") + "\n";
+        : items.map((item) => `| ${markdownTableCell(item.path)} | ${item.kind} | ${plainMarkdownTableCell(item.title)} | ${item.bytes} | ${plainMarkdownTableCell(item.summary)} |`).join("\n") + "\n";
+    const skippedRows = skippedFormOnlyFiles.length === 0
+        ? "| none | - | - |\n"
+        : skippedFormOnlyFiles.map((record) => `| ${markdownTableCell(record.file.path)} | ${markdownTableCell(record.formOnlyReason)} | ${plainMarkdownTableCell((0, wiki_files_1.firstHeading)(record.text, record.file.path))} |`).join("\n") + "\n";
     const inventory = `${(0, templates_1.metadata)("migration-inventory", "on-demand", "wiki/meta/wiki-ops-v1-decisions.md", "migration scan is rerun")}
 # Migration Inventory
 
@@ -319,13 +1013,31 @@ function runMigrationMode(migrationState) {
 
 - Generated: ${workspace_1.today}
 - Legacy root: ${legacyPath || "none"}
-- Markdown files: ${items.length}
+- Legacy markdown files: ${markdownFiles.length}
+- Migratable markdown files: ${items.length}
+- Skipped form-only/template files: ${skippedFormOnlyFiles.length}
 - Legacy files are not copied directly into the new wiki; they are mapped to rewrite inboxes.
 
+## Migratable Files
+
 | Legacy Source | Classification | Title | Size (bytes) | Summary |
 | --- | --- | --- | ---: | --- |
-${inventoryRows}`;
+${inventoryRows}
+## Skipped Form-Only Files
+
+| Legacy Source | Reason | Title |
+| --- | --- | --- |
+${skippedRows}`;
     const units = items.flatMap((item) => extractMigrationUnits(item.legacyPath, (0, workspace_1.read)(item.path)));
+    const unitsByStorage = {
+        canonical: units.filter((unit) => unit.classification.storage === "canonical"),
+        decisions: units.filter((unit) => unit.classification.storage === "decisions"),
+        sources: units.filter((unit) => unit.classification.storage === "sources"),
+        meta: units.filter((unit) => unit.classification.storage === "meta"),
+    };
+    const batchScope = migrationBatchScope(legacyPath || "none");
+    const initialBulkPlan = buildMigrationBulkReviewPlan(bulkReviewRowsFromCoverage(coverageRowsFromUnits(units)));
+    const bulkReview = renderMigrationBulkReviewDocument(initialBulkPlan, batchScope);
     const coverage = `${(0, templates_1.metadata)("migration-coverage", "on-demand", "wiki/meta/wiki-ops-v1-decisions.md", "migration unit coverage statuses change")}
 # Migration Coverage Ledger
 
@@ -338,9 +1050,34 @@ ${inventoryRows}`;
 - Status values: pending, adopted, merged, superseded, rejected, resolved, needs-human-review.
 - \`adopted\` and \`merged\` rows require a new-wiki target under \`wiki/canonical/\`, \`wiki/decisions/\`, \`wiki/sources/\`, or \`wiki/meta/\`.
 
-| Unit ID | Legacy Source | Type | Heading | Summary | Status | Target | Note |
-| --- | --- | --- | --- | --- | --- | --- | --- |
+| Unit ID | Legacy Source | Type | Heading | Summary | Status | Target | Note | Area | Confidence | Reason |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
 ${coverageTableRows(units)}`;
+    const unitMap = `${(0, templates_1.metadata)("migration-unit-map", "on-demand", "wiki/meta/wiki-ops-v1-decisions.md", "migration classification or target suggestions change")}
+# Migration Unit Map
+
+## TL;DR
+
+- Generated: ${workspace_1.today}
+- Legacy meaning units: ${units.length}
+- Each row classifies one legacy meaning unit against the service/product document taxonomy.
+- Low-confidence rows start as needs-human-review.
+
+| Unit ID | Legacy Source | Heading Path | Area | Storage | Confidence | Suggested Target | Reason | Summary | Status |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+${unitMapRows(units)}`;
+    const splitPlan = `${(0, templates_1.metadata)("migration-split-plan", "on-demand", "wiki/meta/wiki-ops-v1-decisions.md", "migration split grouping changes")}
+# Migration Split Plan
+
+## TL;DR
+
+- Generated: ${workspace_1.today}
+- Suggested target pages: ${new Set(units.map((unit) => unit.classification.target)).size}
+- Use this as the rewrite plan when one legacy page mixes API specs, features, UX, policy, QA, operations, or source evidence.
+
+| Suggested Target | Area | Storage | Lowest Confidence | Unit Count | Legacy Units |
+| --- | --- | --- | --- | ---: | --- |
+${splitPlanRows(units)}`;
     const plan = `${(0, templates_1.metadata)("migration-plan", "short", "wiki/meta/wiki-ops-v1-decisions.md", "migration procedure or status changes")}
 # Migration Plan
 
@@ -349,6 +1086,7 @@ ${coverageTableRows(units)}`;
 - Generated: ${workspace_1.today}
 - Preparation: ${migrationState.note}
 - The new \`./wiki\` uses the standard structure.
+- Form-only/template files are recorded in inventory but excluded from meaning-unit migration.
 - Next step: review inbox items and absorb useful meaning into canonical, decisions, sources, or meta docs.
 
 ## Counts
@@ -358,83 +1096,92 @@ ${coverageTableRows(units)}`;
 | canonical candidates | ${byKind.canonical.length} |
 | decision candidates | ${byKind.decision.length} |
 | source candidates | ${byKind.source.length} |
+| meta candidates | ${byKind.meta.length} |
 | other candidates | ${byKind.other.length} |
+| skipped form-only/template files | ${skippedFormOnlyFiles.length} |
+| canonical units | ${unitsByStorage.canonical.length} |
+| decision units | ${unitsByStorage.decisions.length} |
+| source units | ${unitsByStorage.sources.length} |
+| meta units | ${unitsByStorage.meta.length} |
 `;
-    const verificationRows = items.length === 0
+    const verificationRows = units.length === 0
         ? "| none | - | - | pass | - |\n"
-        : items.map((item) => `| ${markdownTableCell(item.path)} | ${item.kind} | ${migrationTargetForKind(item.kind)} | mapped | pending semantic rewrite |`).join("\n") + "\n";
+        : units.map((unit) => {
+            const semanticStatus = unit.classification.confidence === "low" ? "needs-human-review" : "pending semantic rewrite";
+            return `| ${markdownTableCell(unit.id)} | ${(0, taxonomy_1.storageToMigrationKind)(unit.classification.storage)} | ${markdownTableCell(unit.classification.target)} | mapped | ${semanticStatus} |`;
+        }).join("\n") + "\n";
     const verification = `${(0, templates_1.metadata)("migration-verification", "on-demand", "wiki/meta/wiki-ops-v1-decisions.md", "migration inbox items are adopted, rejected, or rescanned")}
 # Migration Verification
 
 ## TL;DR
 
 - legacy root: ${legacyPath || "none"}
-- legacy markdown files: ${items.length}
-- mapped files: ${items.length}
-- coverage: ${items.length === markdownFiles.length ? "pass" : "fail"}
-- This verifies file coverage only. Semantic completeness is confirmed after inbox statuses are resolved.
+- legacy markdown files: ${markdownFiles.length}
+- skipped form-only/template files: ${skippedFormOnlyFiles.length}
+- mapped units: ${units.length}
+- coverage: ${items.length + skippedFormOnlyFiles.length === markdownFiles.length ? "pass" : "fail"}
+- This verifies unit coverage. Semantic completeness is confirmed after coverage or inbox statuses are resolved.
 
-${completionScopeSection(migrationBatchScope(legacyPath || "none"))}
+${completionScopeSection(batchScope)}
 
 | Legacy Source | Classification | New Wiki Target | Coverage | Semantic Status |
 | --- | --- | --- | --- | --- |
 ${verificationRows}`;
+    const review = `${(0, templates_1.metadata)("migration-review", "on-demand", "wiki/meta/wiki-ops-v1-decisions.md", "migration inbox statuses change")}
+# Migration Review
+
+## TL;DR
+
+- generated: ${workspace_1.today}
+- total legacy rows: ${units.length}
+- skipped form-only/template files: ${skippedFormOnlyFiles.length}
+- semantic migration complete: no, the ${batchScope} still has unresolved rows
+- Run \`--review-migration\` after updating coverage or migration inbox statuses.
+
+${completionScopeSection(batchScope)}
+
+${bulkReviewSummarySection(initialBulkPlan)}
+
+| Legacy Source | Classification | Inbox Status | Semantic Status | Evidence |
+| --- | --- | --- | --- | --- |
+${units.length === 0 ? "| none | - | - | - | - |\n" : units.map((unit) => `| ${markdownTableCell(unit.id)} | ${(0, taxonomy_1.storageToMigrationKind)(unit.classification.storage)} | ${unit.classification.confidence === "low" ? "needs-human-review" : "pending"} | ${unit.classification.confidence === "low" ? "needs-human-review" : "pending semantic rewrite"} | ${plainMarkdownTableCell(unit.classification.reason)} |`).join("\n") + "\n"}`;
     const migrationStartupBlock = `<!-- PROJECT-WIKI-MIGRATION:START -->
 ## Migration State
 
 - ${workspace_1.today}: preserved existing wiki at \`${legacyPath || "no wiki_legacy"}\` and regenerated the standard wiki structure.
-- Scanned ${items.length} legacy markdown files and created migration inventory, plan, verification, and inbox files.
+- Scanned ${markdownFiles.length} legacy markdown files, skipped ${skippedFormOnlyFiles.length} form-only/template files, and mapped ${units.length} meaning units; created inventory, unit map, split plan, coverage, verification, review, and inbox files.
 - Do not delete \`${legacyPath || "wiki_legacy"}\` until all migration inbox items are adopted/rejected/resolved and needs-human-review is 0.
 - Migration completion status is scoped to this batch only. For a future fresh rebuild request, treat current \`wiki/\` as the legacy source unless the user says otherwise.
 <!-- PROJECT-WIKI-MIGRATION:END -->`;
     const migrationIndexBlock = `<!-- PROJECT-WIKI-MIGRATION:START -->
 ## Migration
 
-- [[migration/plan]]
-  - Read when: migration procedure, fresh rebuild procedure, or status matters.
-  - Update when: migration procedure or state changes.
-  - Token budget: short.
-- [[migration/inventory]]
-  - Read when: legacy markdown file list and classification matter.
-  - Update when: migration is rescanned.
-  - Token budget: on-demand.
-- [[migration/verification]]
-  - Read when: legacy file coverage or semantic migration status matters.
-  - Update when: migration inbox statuses change.
-  - Token budget: on-demand.
-- [[migration/coverage]]
-  - Read when: checking whether legacy meaning units were adopted, merged, superseded, rejected, resolved, or marked for review.
-  - Update when: unit-level migration coverage statuses, targets, or notes change.
-  - Token budget: on-demand.
-- [[migration/review]]
-  - Read when: semantic migration review status matters.
-  - Update when: \`--review-migration\` syncs migration state.
-  - Token budget: on-demand.
-- [[canonical/migration-inbox]]
-  - Read when: absorbing legacy canonical candidates.
-  - Update when: candidates are adopted/rejected/resolved/needs-human-review.
-  - Token budget: medium.
-- [[decisions/migration-inbox]]
-  - Read when: absorbing legacy decision candidates.
-  - Update when: candidates are adopted/rejected/resolved/needs-human-review.
-  - Token budget: medium.
-- [[sources/migration-inbox]]
-  - Read when: absorbing legacy source candidates.
-  - Update when: candidates are adopted/rejected/resolved/needs-human-review.
-  - Token budget: medium.
+- [[migration/plan]]: migration procedure, fresh rebuild procedure, and counts.
+- [[migration/inventory]]: legacy file list and file-level classification.
+- [[migration/unit-map]]: meaning-unit taxonomy classification and suggested target pages.
+- [[migration/split-plan]]: target-page grouping for mixed legacy pages.
+- [[migration/coverage]]: editable unit status, target, and note ledger.
+- [[migration/verification]]: current unit coverage and semantic status.
+- [[migration/review]]: regenerated summary from coverage/inbox status.
+- [[migration/bulk-review]]: batch review queues so humans do not inspect every unit one by one.
+- [[canonical/migration-inbox]], [[decisions/migration-inbox]], [[sources/migration-inbox]]: file-level adoption inboxes.
 <!-- PROJECT-WIKI-MIGRATION:END -->`;
     const results = [];
     (0, workspace_1.mkdirp)("wiki/migration");
     results.push(["wiki/migration/inventory.md", (0, workspace_1.writeManaged)("wiki/migration/inventory.md", inventory)]);
+    results.push(["wiki/migration/unit-map.md", (0, workspace_1.writeManaged)("wiki/migration/unit-map.md", unitMap)]);
+    results.push(["wiki/migration/split-plan.md", (0, workspace_1.writeManaged)("wiki/migration/split-plan.md", splitPlan)]);
     results.push(["wiki/migration/coverage.md", (0, workspace_1.writeManaged)("wiki/migration/coverage.md", coverage)]);
     results.push(["wiki/migration/plan.md", (0, workspace_1.writeManaged)("wiki/migration/plan.md", plan)]);
+    results.push(["wiki/migration/review.md", (0, workspace_1.writeManaged)("wiki/migration/review.md", review)]);
     results.push(["wiki/migration/verification.md", (0, workspace_1.writeManaged)("wiki/migration/verification.md", verification)]);
+    results.push(["wiki/migration/bulk-review.md", (0, workspace_1.writeManaged)("wiki/migration/bulk-review.md", bulkReview)]);
     results.push(["wiki/canonical/migration-inbox.md", (0, workspace_1.writeManaged)("wiki/canonical/migration-inbox.md", buildInbox("Canonical Migration Inbox", "Legacy content that may belong in current project truth.", byKind.canonical.concat(byKind.other)))]);
     results.push(["wiki/decisions/migration-inbox.md", (0, workspace_1.writeManaged)("wiki/decisions/migration-inbox.md", buildInbox("Decision Migration Inbox", "Legacy content that may belong in project decision history.", byKind.decision))]);
     results.push(["wiki/sources/migration-inbox.md", (0, workspace_1.writeManaged)("wiki/sources/migration-inbox.md", buildInbox("Source Migration Inbox", "Legacy content that may belong in source summaries.", byKind.source))]);
     results.push(["wiki/startup.md migration state", (0, workspace_1.upsertMarkedSection)("wiki/startup.md", "<!-- PROJECT-WIKI-MIGRATION:START -->", "<!-- PROJECT-WIKI-MIGRATION:END -->", migrationStartupBlock)]);
     results.push(["wiki/index.md migration router", (0, workspace_1.upsertMarkedSection)("wiki/index.md", "<!-- PROJECT-WIKI-MIGRATION:START -->", "<!-- PROJECT-WIKI-MIGRATION:END -->", migrationIndexBlock)]);
-    return { results, total: items.length, legacyPath };
+    return { results, total: markdownFiles.length, legacyPath };
 }
 function normalizeMigrationStatus(status) {
     const value = String(status || "").trim().toLowerCase();
@@ -463,11 +1210,69 @@ function migrationInboxStatusMap() {
             const source = cells[0];
             if (!source)
                 continue;
-            statuses.set(source, { status: normalizeMigrationStatus(cells[3]), inbox: file });
+            const entry = { status: normalizeMigrationStatus(cells[3]), inbox: file };
+            statuses.set(source, entry);
+            const rootStripped = source.replace(/^wiki_legacy(?:_[^/]+)?\//, "");
+            if (rootStripped !== source)
+                statuses.set(rootStripped, entry);
         }
     }
     return statuses;
 }
+function normalizeCoverageStatusForReview(status) {
+    const value = String(status || "").trim().toLowerCase();
+    if (value === "merged")
+        return "adopted";
+    if (value === "superseded")
+        return "resolved";
+    if (isMigrationInboxStatus(value))
+        return value;
+    return "pending";
+}
+function migrationCoverageStatusMap() {
+    const statuses = new Map();
+    if (!(0, workspace_1.exists)("wiki/migration/coverage.md"))
+        return statuses;
+    for (const cells of (0, wiki_files_1.parseMarkdownTableRows)((0, workspace_1.read)("wiki/migration/coverage.md"), 8).filter((row) => row[0] !== "Unit ID")) {
+        const source = cells[0];
+        if (!source)
+            continue;
+        statuses.set(source, { status: normalizeCoverageStatusForReview(cells[5]), inbox: "wiki/migration/coverage.md" });
+    }
+    return statuses;
+}
+function legacySourceFromUnitId(value) {
+    return value.split("#u", 1)[0] ?? value;
+}
+function sourcesSafeForFileLevelFallback(rows) {
+    const targetsBySource = new Map();
+    for (const row of rows) {
+        const source = legacySourceFromUnitId(row.legacyPath);
+        const targets = targetsBySource.get(source) ?? new Set();
+        targets.add(row.target);
+        targetsBySource.set(source, targets);
+    }
+    return new Set(Array.from(targetsBySource.entries()).filter(([, targets]) => targets.size === 1).map(([source]) => source));
+}
+function migrationStatusForRow(row, coverageStatuses, inboxStatuses, fileLevelFallbackSources) {
+    const coverage = coverageStatuses.get(row.legacyPath);
+    if (coverage && coverage.status !== "pending")
+        return coverage;
+    const exactInbox = inboxStatuses.get(row.legacyPath);
+    if (exactInbox)
+        return exactInbox;
+    const source = legacySourceFromUnitId(row.legacyPath);
+    const sourceInbox = inboxStatuses.get(source);
+    if (sourceInbox && fileLevelFallbackSources.has(source))
+        return sourceInbox;
+    if (sourceInbox) {
+        const note = `file-level inbox row ignored for mixed-target legacy source: ${sourceInbox.inbox}`;
+        return coverage ? { status: coverage.status, inbox: `${note}; using ${coverage.inbox}` } : { status: "needs-human-review", inbox: note };
+    }
+    if (coverage)
+        return coverage;
+    return { status: "needs-human-review", inbox: "missing migration coverage or inbox row" };
+}
 function semanticStatusForInboxStatus(status) {
     if (["adopted", "rejected", "resolved", "needs-human-review"].includes(status))
         return status;
@@ -485,11 +1290,12 @@ function runReviewMigrationMode() {
         target: cells[2] ?? "",
         coverage: cells[3] ?? "",
     }));
+    const coverageStatuses = migrationCoverageStatusMap();
     const inboxStatuses = migrationInboxStatusMap();
+    const fileLevelFallbackSources = sourcesSafeForFileLevelFallback(verificationRows);
     const reviewedRows = verificationRows.map((row) => {
-        const inbox = inboxStatuses.get(row.legacyPath);
-        const status = inbox ? inbox.status : "needs-human-review";
-        return { ...row, inboxStatus: status, semanticStatus: semanticStatusForInboxStatus(status), note: inbox ? inbox.inbox : "missing migration inbox row" };
+        const statusEntry = migrationStatusForRow(row, coverageStatuses, inboxStatuses, fileLevelFallbackSources);
+        return { ...row, inboxStatus: statusEntry.status, semanticStatus: semanticStatusForInboxStatus(statusEntry.status), note: statusEntry.inbox };
     });
     const counts = reviewedRows.reduce((acc, row) => {
         acc[row.inboxStatus] = (acc[row.inboxStatus] || 0) + 1;
@@ -501,6 +1307,9 @@ function runReviewMigrationMode() {
     const legacyRoot = (verificationText.match(/^- legacy root:\s*(.+)$/m) || [])[1] || "unknown";
     const batchScope = migrationBatchScope(legacyRoot);
     const completionValue = semanticCompletionValue(complete, batchScope);
+    const coverageRows = (0, workspace_1.exists)("wiki/migration/coverage.md") ? parseMigrationCoverageRows((0, workspace_1.read)("wiki/migration/coverage.md")) : [];
+    const bulkPlan = buildMigrationBulkReviewPlan(bulkReviewRowsFromCoverage(coverageRows, reviewedRows));
+    const bulkReview = renderMigrationBulkReviewDocument(bulkPlan, batchScope);
     const reviewRows = reviewedRows.length === 0
         ? "| none | - | - | - | - |\n"
         : reviewedRows.map((row) => `| ${markdownTableCell(row.legacyPath)} | ${row.kind} | ${row.inboxStatus} | ${row.semanticStatus} | ${markdownTableCell(row.note)} |`).join("\n") + "\n";
@@ -520,6 +1329,8 @@ function runReviewMigrationMode() {
 
 ${completionScopeSection(batchScope)}
 
+${bulkReviewSummarySection(bulkPlan)}
+
 | Legacy Source | Classification | Inbox Status | Semantic Status | Evidence |
 | --- | --- | --- | --- | --- |
 ${reviewRows}`;
@@ -532,8 +1343,8 @@ ${reviewRows}`;
 ## TL;DR
 
 - legacy root: ${legacyRoot}
-- legacy markdown files: ${reviewedRows.length}
-- mapped files: ${reviewedRows.filter((row) => row.coverage === "mapped").length}
+- legacy rows: ${reviewedRows.length}
+- mapped rows: ${reviewedRows.filter((row) => row.coverage === "mapped").length}
 - coverage: ${reviewedRows.every((row) => row.coverage === "mapped") ? "pass" : "fail"}
 - semantic migration complete: ${completionValue}
 - pending: ${pending}
@@ -547,7 +1358,11 @@ ${verificationRowsText}`;
     const results = [
         ["wiki/migration/review.md", (0, workspace_1.writeManaged)("wiki/migration/review.md", review)],
         ["wiki/migration/verification.md", (0, workspace_1.writeManaged)("wiki/migration/verification.md", verification)],
+        ["wiki/migration/bulk-review.md", (0, workspace_1.writeManaged)("wiki/migration/bulk-review.md", bulkReview)],
     ];
+    if (complete) {
+        results.push(...pruneCompletedMigrationJunk(legacyRoot));
+    }
     console.log("Project wiki migration review complete.");
     for (const [relativePath, status] of results)
         console.log(`${String(status).padEnd(7)} ${relativePath}`);