Commit 1d22097f14
Verified · cmc
Layout: unified · split
docs/plans/2026-10-05-fill.md added +33
| @@ -0,0 +1,33 @@ | ||
| 1 | # Fill Paragraph Implementation Plan | |
| 2 | ||
| 3 | > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. | |
| 4 | ||
| 5 | **Goal:** M-q as `org-fill-paragraph`: paragraphs (also in items and greater blocks), comments and comment blocks, byte- and caret-exact against Emacs. | |
| 6 | ||
| 7 | **Architecture:** `Fill.swift` ports `org-fill-element` and Emacs's `fill-region-as-paragraph` (fill.el): adaptive prefixes (`fill-context-prefix`, `fill-match-adaptive-prefix`, `org-adaptive-fill-function`, `org-adaptive-fill-paragraph-function`), `fill-delete-prefix`, `fill-delete-newlines`, `canonically-space-region`, `fill-move-to-break-point`, `fill-nobreak-p` with org's `paragraph-start` and its three no-break predicates, `fill-newline`. Elements come from the parser; quote, center and special blocks are parsed into their elements on demand, since the tree keeps blocks opaque. | |
| 8 | ||
| 9 | **Tech Stack:** Swift 6.2 tools, Swift Testing, Emacs 31.1 / Org 9.8.7 oracle. | |
| 10 | ||
| 11 | **Spec:** `docs/design.md`, "Goals" (`M-q` fill). | |
| 12 | ||
| 13 | ## Global Constraints | |
| 14 | ||
| 15 | - `sentence-end-double-space` nil (the user's Doom setting), `colon-double-space` nil, `left-margin` 0, left justification, `adaptive-fill-mode` t. | |
| 16 | - `fill-column` is an option: Emacs's 70 in the oracle's first pass, Doom's 80 in the second and as the app default. | |
| 17 | - Src blocks are left alone: Emacs fills them through the language's mode and re-indents them on the way. | |
| 18 | ||
| 19 | ## Defaults chosen (user may change) | |
| 20 | ||
| 21 | - Fill column 80 (Doom). Mac preset: ⌃⌘P. | |
| 22 | - No CJK line breaking rules (kinsoku), no justification with C-u. | |
| 23 | ||
| 24 | --- | |
| 25 | ||
| 26 | ### Task 1: Fill | |
| 27 | ||
| 28 | - [ ] Port; oracle over 16 variants (items, comments, quotes, line breaks, timestamps, links, captions, markup at line start, extra spaces) at both fill columns, and over corpus paragraphs (src blocks excluded). | |
| 29 | - [ ] Commit "Port fill paragraph". | |
| 30 | ||
| 31 | ### Task 2: App | |
| 32 | ||
| 33 | - [ ] M-q / ⌃⌘P; Settings fill column. | |