paperfit-cli 1.0.0

package/skills/consistency-polisher/SKILL.md

@@ -0,0 +1,337 @@
+# Consistency Polisher Skill
+
+## 概述
+
+本技能专门处理 **Category C：排版一致性缺陷**，包括：
+
+- **C1**：表格字号不统一（`\resizebox` 滥用导致字号参差）
+- **C2**：图片分辨率/风格不一致
+- **C3**：Caption 格式不统一
+
+该技能由 `code-surgeon-agent` 调用，通过对表格字号、图片尺寸策略、标题格式的统一化处理，消除全篇排版风格割裂，使论文呈现出专业、一致的视觉形象。
+
+一致性缺陷通常不致命，但严重影响审稿人对论文专业度的第一印象。本技能的目标是建立并强制执行全篇统一的排版规范。
+
+---
+
+## 适用场景
+
+| 缺陷 ID | 描述 | 优先级 | 是否自动修复 |
+|---------|------|--------|-------------|
+| C1 | 表格字号不统一 | Medium | 是 |
+| C2 | 图片分辨率/风格不一致 | Low | 否（仅诊断并建议） |
+| C3 | Caption 格式不统一 | Medium | 是 |
+
+---
+
+## 输入规范
+
+| 输入项 | 来源 | 说明 |
+|--------|------|------|
+| 主 `.tex` 文件路径 | 项目上下文 | 需修改的源文件 |
+| 排版侦探报告 | `layout-detective-agent` 输出 | 包含 C 类缺陷的具体描述 |
+| 模板信息 | `templates.yaml` 或上下文 | 会议/期刊模板的字号、栏宽等默认参数 |
+
+---
+
+## 输出规范
+
+```json
+{
+  "skill": "consistency-polisher",
+  "status": "success | partial | failed",
+  "modified_files": ["main.tex", "tables/experiments.tex"],
+  "changes": [
+    {
+      "defect_id": "C1",
+      "object": "Table 2",
+      "action": "移除 \\resizebox，改用 tabularx 并统一使用 \\small",
+      "before_snippet": "\\resizebox{\\linewidth}{!}{\\begin{tabular}{...}",
+      "after_snippet": "{\\small\\begin{tabularx}{\\linewidth}{...}}"
+    }
+  ],
+  "suggestions": [
+    {
+      "defect_id": "C2",
+      "object": "Figure 5",
+      "message": "图片分辨率过低（72 DPI），建议替换为至少 300 DPI 的矢量图或高分辨率位图"
+    }
+  ],
+  "unresolved": []
+}
+```
+
+---
+
+## 修复策略
+
+### 通用原则
+
+1. **建立风格锚点**：从全篇中自动识别或由用户指定一个“最佳实践”表格/图片/Caption 作为模板，其余向它看齐。
+2. **最小破坏**：修改仅限于样式层面，不改变表格内容、图片信息或标题文本。
+3. **模板优先**：若会议/期刊模板提供了官方样式文件，优先遵循模板预设，而非自定义样式。
+
+---
+
+### C1：表格字号不统一
+
+**问题特征**：
+- 不同表格使用了差异明显的字号（如一个 `\small`，另一个 `\tiny`）。
+- 使用 `\resizebox{\linewidth}{!}{...}` 整体缩放表格，导致文字被非线性缩放而变形，且与其他表格字号不一致。
+
+**修复策略（按优先级）**：
+
+#### 策略 1：移除 `\resizebox`，改用 `tabularx` 自适应宽度
+
+`\resizebox` 是表格一致性的头号杀手，必须无条件移除。
+
+```latex
+% 修改前
+\begin{table}
+\centering
+\resizebox{\linewidth}{!}{
+  \begin{tabular}{|l|c|c|c|}
+  \hline
+  Method & Metric1 & Metric2 & Metric3 \\
+  \hline
+  Ours & 95.2 & 87.3 & 78.1 \\
+  \hline
+  \end{tabular}
+}
+\caption{Results}
+\end{table}
+
+% 修改后
+\begin{table}
+\centering
+\small  % 统一字号
+\begin{tabularx}{\linewidth}{|l|X|X|X|}
+\hline
+Method & Metric1 & Metric2 & Metric3 \\
+\hline
+Ours & 95.2 & 87.3 & 78.1 \\
+\hline
+\end{tabularx}
+\caption{Results}
+\end{table}
+```
+
+*注意*：确保导言区已加载 `tabularx` 宏包。若未加载，需添加 `\usepackage{tabularx}`。
+
+#### 策略 2：统一全篇表格字号
+
+检查全篇表格的字号设置，确定一个“锚点字号”（通常是模板默认的正文字号，或 `\small`），将所有表格统一为该字号。
+
+**识别当前字号**：
+- 搜索 `\begin{table}` 后的 `\small`、`\footnotesize`、`\scriptsize`、`\tiny` 等命令。
+- 搜索 `\resizebox` 并评估其实际视觉字号。
+
+**统一方法**：
+- 若表格无字号声明，且模板默认表格字号与正文相同，则不加字号命令（让模板决定）。
+- 若需缩小，优先使用 `\small`；若仍超宽，考虑改为 `tabularx` 而非进一步缩小字号。
+- 绝对禁止使用 `\tiny` 或 `\scriptsize`（不可阅读）。
+
+```latex
+% 统一风格示例：在每个 table 环境内首行添加 \small
+\begin{table}
+\small
+\centering
+\begin{tabularx}{\linewidth}{...}
+...
+\end{tabularx}
+\end{table}
+```
+
+#### 策略 3：检测并修复列宽失衡导致的字号误用
+
+有时作者使用超小字号是因为表格列太多、内容太宽。此时应优先重构列格式（如合并相似列、使用缩写表头、改为跨栏表），而非暴力缩小字号。
+
+```latex
+% 修改前（滥用 \tiny）
+\begin{table}
+\tiny
+\begin{tabular}{|l|c|c|c|c|c|c|c|c|}
+...
+\end{tabular}
+\end{table}
+
+% 修改后（合并为关键列 + 缩写表头 + 跨栏宽表）
+\begin{table*}
+\small
+\begin{tabularx}{\textwidth}{|l|X|X|X|}
+\hline
+\textbf{Method} & \textbf{Prec.} & \textbf{Rec.} & \textbf{F1} \\
+\hline
+...
+\end{tabularx}
+\end{table*}
+```
+
+---
+
+### C2：图片分辨率/风格不一致
+
+**问题特征**：
+- 不同图片清晰度差异大（矢量图 vs 低分辨率截图）。
+- 图片中的字体、配色、线条风格不统一。
+- 同一论文中混用 `.pdf`、`.png`、`.jpg`，且质量参差。
+
+**本技能的定位**：**仅诊断和建议，不自动修改图片内容**。
+
+#### 诊断与建议生成
+
+1. **检查图片文件格式**：
+   - 推荐：`.pdf`（矢量图）、`.eps`（矢量图）。
+   - 可接受：高分辨率 `.png`（≥300 DPI）。
+   - 避免：低分辨率 `.jpg`、屏幕截图。
+
+2. **生成逐图建议**：
+
+```json
+{
+  "defect_id": "C2",
+  "object": "Figure 5 (figures/ablation.png)",
+  "issue": "图片分辨率约 72 DPI，放大后锯齿明显",
+  "suggestion": "请使用原始矢量图导出为 PDF，或以至少 300 DPI 重新渲染位图"
+}
+```
+
+3. **风格一致性建议**：
+   - 若检测到多张图来自不同工具（如 Matplotlib、Excel、draw.io），提示用户统一绘图工具和导出设置。
+   - 建议使用统一的配色方案（如 ColorBrewer）和字体（如 Times New Roman 或 Helvetica）。
+
+#### 输出示例
+
+```json
+"suggestions": [
+  {
+    "defect_id": "C2",
+    "object": "Figure 1, Figure 3, Figure 5",
+    "message": "三张图使用了三种不同的配色风格，建议统一使用会议模板推荐的配色方案。"
+  }
+]
+```
+
+---
+
+### C3：Caption 格式不统一
+
+**问题特征**：
+- 图表标题的字体不一致（有的加粗，有的未加粗）。
+- 标题结尾标点不一致（有的有句号，有的无）。
+- 表格标题位置不一致（有的在表格上方，有的在下方）。
+- 标题与图表主体的间距不一致。
+
+**修复策略**：
+
+#### 策略 1：统一使用 `caption` 宏包配置
+
+在导言区加载 `caption` 宏包并设置全局样式，一次性统一全篇标题格式。
+
+```latex
+\usepackage{caption}
+\captionsetup{
+  font=small,           % 字号
+  labelfont=bf,         % 标签加粗（"Figure 1:" 中的 "Figure 1" 部分）
+  textfont=it,          % 标题文本斜体（可选）
+  labelsep=period,      % 标签与文本分隔符：period = 句点，colon = 冒号
+  justification=raggedright,  % 左对齐（或 justified 两端对齐）
+  singlelinecheck=false % 即使单行也应用设置
+}
+```
+
+*针对表格和图片的差异化设置*：
+
+```latex
+% 表格标题默认在上方，图片在下方，无需额外设置，LaTeX 自动处理。
+% 若需微调间距：
+\captionsetup[table]{position=above, skip=6pt}
+\captionsetup[figure]{position=below, skip=6pt}
+```
+
+#### 策略 2：检查并修复手动设置的标题样式
+
+搜索 `.tex` 文件中的 `\caption` 命令，移除其前后的手动字体设置（如 `\textbf{\caption{...}}`），因为这些手动设置会覆盖全局配置。
+
+```latex
+% 修改前
+\caption{\textbf{This is a bold caption.}}
+
+% 修改后（依赖全局 caption 设置）
+\caption{This is a caption with unified style.}
+```
+
+#### 策略 3：统一结尾标点
+
+检查所有 `\caption{}` 的内容，确保标点风格一致。推荐：
+- 学术论文标题通常**不加句号**。
+- 若标题包含完整句子，可保留句号，但全篇统一。
+
+```latex
+% 统一移除标题末尾的句号
+\caption{Results on the validation set.}  →  \caption{Results on the validation set}
+```
+
+#### 策略 4：修复表格标题位置错误
+
+LaTeX 中表格标题应放在 `\begin{tabular}` 之前，图片标题应放在 `\includegraphics` 之后。
+
+```latex
+% 正确的表格标题位置
+\begin{table}
+\centering
+\caption{Table caption here}  % 在上方
+\begin{tabular}{...}
+...
+\end{tabular}
+\end{table}
+
+% 错误的表格标题位置（标题在表格下方）
+\begin{table}
+\centering
+\begin{tabular}{...}
+...
+\end{tabular}
+\caption{This caption is misplaced.}
+\end{table}
+```
+
+若发现位置错误，将 `\caption` 命令移动到正确位置。
+
+---
+
+## 全局一致性检查清单
+
+在修复 C 类缺陷时，应同时对全篇进行以下检查：
+
+| 检查项 | 目标状态 | 修复方法 |
+|--------|----------|----------|
+| 所有表格是否使用相同字号？ | 全篇统一（通常 `\small` 或模板默认） | 移除 `\resizebox`，添加统一的字号命令 |
+| 所有图片是否使用 `\linewidth`？ | 是（单栏）或 `\textwidth`（跨栏） | 替换固定宽度为相对宽度 |
+| 所有 Caption 字体是否一致？ | 是 | 使用 `caption` 宏包全局配置 |
+| 表格标题是否都在表格上方？ | 是 | 移动 `\caption` 命令 |
+| 图片标题是否都在图片下方？ | 是 | 移动 `\caption` 命令 |
+| 标题结尾标点是否统一？ | 全篇统一（推荐无句号） | 移除或添加标点 |
+| 是否使用了 `booktabs` 绘制三线表？ | 推荐 | 将 `\hline` 替换为 `\toprule`、`\midrule`、`\bottomrule` |
+
+---
+
+## 与其它技能的协作
+
+- **表格修复 (overflow-repair)**：C1 的 `\resizebox` 移除常与 D1 的表格溢出修复联动，可合并处理。
+- **浮动体优化 (float-optimizer)**：B2 的宽度适配与 C1 的表格字号统一通常同时进行。
+- **模板迁移 (template-migrator)**：在跨模板迁移后，本技能确保新模板下的样式一致性。
+
+---
+
+## 修复验证
+
+每完成一项修复后：
+
+1. **重新编译**。
+2. **渲染页图**，逐页对比修改前后的表格字号、标题格式。
+3. 检查是否引入新的不一致（如某个表格因移除 `\resizebox` 而超宽），若有，转交 `overflow-repair` 处理。
+
+---
+
+**Consistency Polisher Skill 就绪。** 等待调用，消除排版风格割裂，交付视觉统一的作品。

package/skills/float-optimizer/SKILL.md

@@ -0,0 +1,284 @@
+# Float Optimizer Skill
+
+## 概述
+
+本技能专门处理 **Category B：浮动体缺陷**，包括：
+
+- **B1**：浮动体远离首次引用（Float-Reference Distance）
+- **B2**：浮动体大小不适配栏宽（Float Width Mismatch）
+- **B3**：连续多个浮动体堆叠无正文间隔（Float Clustering）
+- **B4**：浮动体跨页分裂（Float Page Orphaning）
+
+该技能由 `code-surgeon-agent` 调用，通过对浮动体位置参数、尺寸设置和周围正文结构的精确调整，实现图表与正文的和谐共处。浮动体优化是视觉排版中最具挑战性的环节之一，必须结合页图反馈迭代验证。
+
+---
+
+## 适用场景
+
+当 `layout-detective-agent` 报告中出现以下缺陷 ID 时，路由至本技能：
+
+| 缺陷 ID | 描述 | 优先级 |
+|---------|------|--------|
+| B1 | 浮动体远离首次引用 | High |
+| B2 | 浮动体大小不适配栏宽 | High |
+| B3 | 浮动体连续堆叠 | Medium |
+| B4 | 浮动体跨页分裂 | Medium |
+
+---
+
+## 输入规范
+
+| 输入项 | 来源 | 说明 |
+|--------|------|------|
+| 主 `.tex` 文件路径 | 项目上下文 | 需修改的源文件 |
+| 排版侦探报告 | `layout-detective-agent` 输出 | 包含缺陷对象（图表标签）、页码、描述 |
+| 当前 PDF 页图 | `visual-inspector` 输出 | 用于验证修复后视觉效果 |
+| 模板类型 | 用户上下文或 `templates.yaml` | 单栏/双栏，影响浮动体宽度策略 |
+
+---
+
+## 输出规范
+
+修改完成后，必须返回以下信息：
+
+```json
+{
+  "skill": "float-optimizer",
+  "status": "success | partial | failed",
+  "modified_files": ["main.tex"],
+  "changes": [
+    {
+      "defect_id": "B1",
+      "object": "Figure 3",
+      "action": "调整浮动体位置参数为 [htbp]",
+      "before": "\\begin{figure}[t]",
+      "after": "\\begin{figure}[htbp]"
+    },
+    {
+      "defect_id": "B2",
+      "object": "Table 1",
+      "action": "将 tabular 宽度设为 \\linewidth",
+      "before": "\\begin{tabular}{|l|c|c|}",
+      "after": "\\begin{tabularx}{\\linewidth}{|l|X|X|}"
+    }
+  ],
+  "unresolved": []
+}
+```
+
+---
+
+## 修复策略
+
+### 通用原则
+
+1. **浮动体是“浮动”的**：LaTeX 的浮动体放置算法具有不确定性，同一份源码在不同编译中可能产生不同输出。因此，修复后必须多次编译以验证稳定性。
+2. **最小侵入**：优先调整位置参数 `[htbp]`，其次调整尺寸，最后才考虑移动浮动体在源码中的位置。
+3. **视觉验证必须**：浮动体修复的效果必须在页图上肉眼确认，不能仅凭日志判断。
+
+---
+
+### B1：浮动体远离首次引用
+
+**问题特征**：
+- 图表出现在距离其首次引用页码 ≥ 2 页的位置。
+- 读者需翻页才能找到对应图表，打断阅读流。
+
+**修复策略（按优先级）**：
+
+1. **调整位置参数**  
+   将浮动体环境的参数从限制性强的 `[t]` 或 `[b]` 改为更宽松的 `[htbp]`，给 LaTeX 更多放置自由度。
+   ```latex
+   % 修改前
+   \begin{figure}[t]
+   % 修改后
+   \begin{figure}[htbp]
+   ```
+   *参数含义*：`h` = here（尽可能在此处），`t` = top（页顶），`b` = bottom（页底），`p` = float page（独立浮动页）。
+
+2. **使用 `\FloatBarrier` 强制放置**  
+   在引用点之后、期望图表出现的位置之前插入 `\FloatBarrier`（需 `placeins` 宏包），阻止浮动体越过此边界。
+   ```latex
+   \usepackage{placeins}
+   ...
+   As shown in Figure~\ref{fig:result}, ...
+   \FloatBarrier  % 确保图不会漂到更后
+   ```
+
+3. **移动浮动体源码位置**  
+   将整个 `figure` 或 `table` 环境在 `.tex` 源码中向上移动，使其更接近首次引用点。
+   *注意*：移动源码可能改变上下文，需确保不影响前后文语义。
+
+4. **拆分大型浮动体**  
+   若一个浮动体包含多个子图且过大，考虑拆分为两个独立的浮动体，或将其部分内容移至附录。
+
+5. **调整前后正文数量**  
+   在浮动体前后增删少量文本（由 `semantic-polish-agent` 协助），改变分页位置，使浮动体自然落在引用附近。
+
+---
+
+### B2：浮动体大小不适配栏宽
+
+**问题特征**：
+- 过窄：图表宽度明显小于栏宽，两侧留白过多。
+- 超宽：图表超出栏宽，内容被截断或溢出到页边。
+
+**修复策略（按优先级）**：
+
+1. **图片宽度标准化**  
+   将所有图片的 `\includegraphics` 宽度设为 `\linewidth`（单栏）或 `\textwidth`（跨栏）。
+   ```latex
+   % 修改前
+   \includegraphics[width=0.6\textwidth]{figure.pdf}
+   % 修改后
+   \includegraphics[width=\linewidth]{figure.pdf}
+   ```
+
+2. **区分单栏与跨栏图表**  
+   - 单栏模板：所有图表默认使用 `\linewidth`。
+   - 双栏模板：单栏图表用 `\columnwidth` 或 `\linewidth`；跨栏图表使用 `figure*` / `table*` 环境，宽度用 `\textwidth`。
+   ```latex
+   % 双栏中的跨栏图
+   \begin{figure*}
+   \includegraphics[width=\textwidth]{wide_figure.pdf}
+   \end{figure*}
+   ```
+
+3. **表格宽度自适应**  
+   使用 `tabularx` 将表格宽度设为 `\linewidth`，并由 `X` 列自动分配多余空间。
+   ```latex
+   \begin{tabularx}{\linewidth}{|l|X|X|}
+   ```
+
+4. **旋转超宽表格**  
+   对于列数过多的宽表，使用 `sidewaystable` 环境旋转 90 度展示。
+   ```latex
+   \usepackage{rotating}
+   ...
+   \begin{sidewaystable}
+   \centering
+   \begin{tabular}{...}
+   ...
+   \end{tabular}
+   \end{sidewaystable}
+   ```
+
+5. **缩小超大图片**  
+   若原图本身尺寸过大，可使用 `width=\linewidth` 自动缩放；若仍需保持比例，可同时设置 `height` 和 `keepaspectratio`。
+   ```latex
+   \includegraphics[width=\linewidth,height=0.3\textheight,keepaspectratio]{figure.pdf}
+   ```
+
+---
+
+### B3：浮动体连续堆叠
+
+**问题特征**：
+- 同一页或连续两页出现 ≥ 3 个图表，且中间正文极少（≤ 2 行）。
+
+**修复策略（按优先级）**：
+
+1. **分散浮动体位置参数**  
+   为不同浮动体分配不同的位置偏好，如第一个用 `[t]`，第二个用 `[b]`，第三个用 `[p]`，避免它们挤在同一页。
+   ```latex
+   \begin{figure}[t] ... \end{figure}
+   \begin{table}[b] ... \end{table}
+   \begin{figure}[p] ... \end{figure}
+   ```
+
+2. **在浮动体之间插入正文**  
+   若浮动体在源码中连续出现，可在其间补充或前移若干行正文（需确保语义连贯）。
+   ```latex
+   \begin{figure} ... \end{figure}
+   % 在此处插入一段正文，哪怕只有 2-3 行
+   The above results demonstrate...
+   \begin{table} ... \end{table}
+   ```
+
+3. **使用 `\FloatBarrier` 控制浮动页**  
+   在适当位置插入 `\FloatBarrier`，迫使之前的浮动体在下一页之前全部输出，避免后续浮动体继续堆积。
+
+4. **将部分图表移至附录**  
+   若正文中图表过多，可将非核心的图表或消融实验移至附录，并在正文中引用。
+
+---
+
+### B4：浮动体跨页分裂
+
+**问题特征**：
+- 一个长表格跨页断开，且第二页未重复表头。
+- 一个图片（含子图）被分页符切开。
+
+**修复策略（按优先级）**：
+
+1. **长表格使用 `longtable` 环境**  
+   将普通 `table` + `tabular` 替换为 `longtable`，支持跨页并自动重复表头。
+   ```latex
+   \usepackage{longtable}
+   ...
+   \begin{longtable}{|l|c|c|}
+   \caption{Long table caption} \label{tab:long} \\
+   \hline
+   \textbf{Header1} & \textbf{Header2} & \textbf{Header3} \\
+   \hline
+   \endfirsthead
+   \hline
+   \textbf{Header1} & \textbf{Header2} & \textbf{Header3} \\
+   \hline
+   \endhead
+   % 表格内容
+   \end{longtable}
+   ```
+
+2. **强制表格不跨页**  
+   若表格并非特别长，可用 `\begin{table}[!h]` 配合 `\centering` 强制放在一页内。
+   ```latex
+   \begin{table}[!h]
+   \centering
+   \begin{tabular}{...}
+   ...
+   \end{tabular}
+   \end{table}
+   ```
+
+3. **拆分过大的图片组**  
+   若一个 `figure` 包含多个子图且总高度过大，拆分为两个独立的 `figure` 环境。
+
+---
+
+## 双栏模板的特殊处理
+
+双栏布局下的浮动体优化更加复杂，需额外注意：
+
+| 场景 | 策略 |
+|------|------|
+| 单栏图过窄 | 判断图片宽高比：若宽度 > 高度 * 1.5，考虑改为跨栏 `figure*` |
+| 跨栏图位置不受控 | 跨栏图只能放在页顶或单独浮动页，使用 `[t]` 或 `[p]` |
+| 跨栏图导致正文留白 | 若跨栏图后下一页大片空白，考虑缩小图尺寸或在其后补充内容 |
+| 双栏末页浮动体堆积 | 使用 `\balance` 或 `\flushend` 平衡末页两栏高度（见 `space-util-fixer`） |
+
+---
+
+## 修复验证
+
+每完成一项修复后：
+
+1. 重新编译至少 **两次** 以稳定交叉引用和浮动体位置。
+2. 渲染新的 PDF 页图，对照缺陷报告逐项检查：
+   - B1：浮动体页码与引用页码差值是否 ≤ 1？
+   - B2：图表宽度是否充分利用栏宽且无溢出？
+   - B3：堆叠是否分散，页面上图表数量是否 ≤ 2？
+   - B4：表格跨页是否带有重复表头？
+3. 若未通过，尝试下一策略，直至所有策略用尽或缺陷消除。
+
+---
+
+## 注意事项
+
+- **避免过度使用 `[H]`**：`float` 宏包提供的 `[H]` 参数强制图表“在此处”，会破坏 LaTeX 的浮动机制，容易导致大面积留白。仅作为最后手段使用。
+- **跨栏图顺序**：双栏中 `figure*` 总是出现在下一页顶部，这是 LaTeX 的固有行为，不可改变。若引用与图表跨页不可避免，接受并记录。
+- **与 `space-util-fixer` 协同**：浮动体调整可能影响页数预算和末页留白，需联动 `space-util-fixer` 综合优化。
+
+---
+
+**Float Optimizer Skill 就绪。** 等待 `code-surgeon-agent` 调用，执行浮动体优化任务。

package/skills/latex_fixers/__init__.py

@@ -0,0 +1,82 @@
+"""
+PaperFit LaTeX Fixers - 可执行的 LaTeX 排版修复函数库
+
+本模块将 SKILL.md 中的修复策略转化为可执行、可测试的 Python 函数。
+供 code-surgeon-agent 直接调用，实现自动化修复。
+"""
+
+from .overflow_fixers import (
+    fix_overfull_hbox,
+    fix_paragraph_overflow,
+    fix_table_overflow,
+    fix_long_formula,
+    fix_url_overflow,
+)
+from .float_fixers import (
+    fix_float_placement,
+    fix_float_width,
+    fix_float_fullwidth,
+    fix_float_clustering,
+    fix_split_float,
+    fix_table_width,
+)
+from .space_util_fixers import (
+    fix_widow_orphan,
+    fix_trailing_whitespace,
+    fix_page_budget,
+    fix_unbalanced_columns,
+)
+from .fullwidth_fixers import (
+    fix_figure_fullwidth,
+    fix_table_fullwidth,
+    fix_all_floats_fullwidth,
+    ensure_reference_newpage,
+    fix_body_last_page,
+)
+from .semantic_micro_tuning import (
+    minimalist_shorten,
+    deep_expand,
+    semantic_intervention,
+)
+from .utils import (
+    add_package_to_preamble,
+    add_to_preamble,
+    find_paragraph_start,
+    find_paragraph_end,
+)
+
+__all__ = [
+    # Overflow fixes
+    "fix_overfull_hbox",
+    "fix_paragraph_overflow",
+    "fix_table_overflow",
+    "fix_long_formula",
+    "fix_url_overflow",
+    # Float fixes
+    "fix_float_placement",
+    "fix_float_width",
+    "fix_float_fullwidth",
+    "fix_float_clustering",
+    "fix_split_float",
+    "fix_table_width",
+    # Full-width fixes (absolute priority)
+    "fix_figure_fullwidth",
+    "fix_table_fullwidth",
+    "fix_all_floats_fullwidth",
+    "ensure_reference_newpage",
+    "fix_body_last_page",
+    # Space utilization fixes
+    "fix_widow_orphan",
+    "fix_trailing_whitespace",
+    "fix_page_budget",
+    "fix_unbalanced_columns",
+    # Utilities
+    "add_package_to_preamble",
+    "add_to_preamble",
+    "find_paragraph_start",
+    "find_paragraph_end",
+    # Semantic micro-tuning
+    "minimalist_shorten",
+    "deep_expand",
+    "semantic_intervention",
+]