ekp/.phrase/phases/phase-kp-overhaul-20260726/change_text_property_layout_implementation_20260729.md

Change Log: Text-Property Layout Implementation 2026-07-29

2026-07-29 — Complete task027

• Modify ekp-buffer.el.
  • Makes native soft wrapping a mode-owned precondition by temporarily setting both truncate-lines and truncate-partial-width-windows buffer-locally to nil before the first reflow.
  • Restores exact prior values and local/global ownership on normal disable, major-mode teardown, and failed activation. An activation error rolls back the full lifecycle and then remains visible.
  • Centralizes installation and removal of the auto-mode hook set; no source character, overlay, synthetic live break, or wrapping algorithm was added.
• Modify buffer/GUI tests and bilingual user/developer documentation.
  • Adds public lifecycle regressions for normal disable, forced reflow failure, and major-mode teardown.
  • Adds a deterministic 44-column split-window scenario and records the native-wrap requirement in the spec, plan, issue, changelog, and decision history.
• Validation: focused lifecycle ERT 3/3; buffer ERT 77/77; default, seed-20260729, and isolated full ERT 166/166; C/Elisp fuzz 300/300; warning-as-error compilation; checkdoc; pinned package-lint; release, dictionary, pinned-source, no-overlay, stale-name, conflict, artifact, and diff gates.
• Dynamic evidence: /private/tmp/ekp-soft-wrap-final-pass-PIUigY retains a reviewed per-character Emacs 30.2 recording in an intentional two-window frame. The 44-column selected window advances from one to two visual rows with hscroll=0, exact source text, zero overlays, zero live replacing breaks, and no pending edit. Manifest/report/recording/contact SHA-256: 53cd23f8e1be1f29545edb6daa80184d438ca87d4d7068a182faf691a8437ad8, a97a74cc5a6255c2eb5992c266c727e3ed5d5556f37672ca319373a65a110e4d, 2b3f7c155d1f0e2feeca2bb79a86aafe612cc1489c486121491ec6268bc1de0a, 21a78ae849e3a1d5cda1d80ee375cd655e49b221b5192a219ac6ab11d9122d53.
• Behavior/Risk: Narrow split windows now follow normal Emacs soft wrapping while auto mode is active. A buffer that deliberately requested truncation gets that exact setting back when the mode ends. issue015 stays open pending user-visible confirmation.

2026-07-29 — Plan task027

• Add issue_native_soft_wrap_20260729.md.
  • Records issue015: Emacs's default narrow partial-window policy horizontally truncates the active paragraph, so the native progressive engine never observes a completed visual row.
• Modify phase spec, task list, and global issue/change indexes.
  • Makes native soft wrapping an explicit auto-mode lifecycle precondition with exact restoration on teardown.
• Behavior/Risk: Planning and red-test preparation only. Runtime behavior is unchanged at this entry.

2026-07-29 — Complete task025 and task026

• Modify ekp-buffer.el.
  • Deletes partial-KP live lookahead, stable anchors, line signatures, convergence, and push/pull repair.
  • Makes Emacs native redisplay own the active tail. EKP projects only internal gap widths on completed native visual rows and reserves full KP breaks, prefixes, and discretionary hyphens for completed hard paragraphs.
  • Invalidates a committed prefix before edits cross back into it, defers IME composition, rejects stale generations, respects narrowing, and keeps foreign display ownership isolated.
• Modify ekp.el, buffer tests, and GUI verification.
  • Removes the now-unused partial live-flow API and replaces its implementation-shaped tests with the approved three-state behavioral contract.
  • Adds dynamic actions for native wrap, deletion restoration, and hard paragraph completion.
• Modify bilingual user/developer docs, phase spec/plan/tasks/issue, changelog, and the live-layout decision history.
  • Records the native progressive model as the current workflow without rewriting the earlier partial-flow decision as if it never existed.
• Validation: focused live contract ERT 4/4; buffer ERT 75/75; default, seed-20260729, and isolated ERT 164/164; fuzz 300/300; warning-as-error compilation; checkdoc; pinned package-lint; release, dictionary, pinned-source, ownership, no-overlay, stale-name, and diff gates. Exact 1–64px ASCII/CJK probes and all seven GUI variants pass.
• Dynamic evidence: /private/tmp/ekp-native-live-2dYu2U retains a 14.82-second fullscreen single-window Emacs 30.2 recording. It proves native mixed-text wrap with zero live owned breaks, exact deletion back to the original three native rows, and full KP only after hard newline. Every immediate/redisplay assertion passes; the recording contains no black segment or non-Emacs frame. Manifest/report/recording SHA-256: cc3a626c7f8fb68f1ef1ea4ba0dd1e276281afee7a56fb88835f49bd86f239e1, 0be9337a95469c6fe710518dbfa27432b4abcd511f623182021776f911887ab0, f87c3adbf16e5d17860471c1a85c89dc688b24c8e08ad82172291fc87483562e.
• Behavior/Risk: Underfilled editing performs no layout planning and looks native. Completed native rows receive gap-only alignment. A hard paragraph receives full KP only after completion or exit. Native visual row discovery still depends on one authoritative graphical window; alternate-width simultaneous plans remain intentionally unsupported. issue014 stays open pending user-visible confirmation.

2026-07-29 — Plan task025 and task026

• Add issue_natural_live_editing_20260729.md.
  • Records issue014: partial KP breaks and hyphens appear while typing near the right edge.
• Modify the phase spec, plan, task list, and global issue/change indexes.
  • Replaces the live product contract with the approved three-state model: native active tail, gap-only completed native rows, and full KP after hard-paragraph completion.
• Behavior/Risk: Planning and red-test preparation only. Runtime behavior is unchanged at this entry.

2026-07-29 — Complete task023 and task024

• Modify ekp-buffer.el.
  • Restores the mark marker without activating it, then restores mark-active as independent editor state.
  • Keeps static paragraph-edge whitespace hiding off the active live line and clears from the source span beginning when its first line becomes active.
• Modify buffer tests and GUI verification evidence.
  • Adds inactive/active mark, same-turn leading/trailing space and tab, CJK space, deletion-exposed whitespace, consecutive space/backspace, yank, newline, and undo regressions through public command paths.
  • Retains the existing overflow/pullback, paragraph transition, resize, IME, foreign-owner, teardown, and bounded-work matrix.
• Modify bilingual user/developer docs, phase spec/plan/tasks/issues, changelog, and postmortem/20260729-active-line-edge-state.md.
  • Records the editor-state and active-line ownership rules at their durable documentation boundaries.
• Validation: focused red 0/3 → green 3/3; buffer ERT 79/79; full default and seed-20260729 ERT 170/170; isolated fresh-process ERT 170/170; C/Elisp fuzz 300/300; warning-as-error compilation; checkdoc; pinned package-lint; release, dictionary, shell, artifact, stale-name, no-overlay, and diff gates.
• Dynamic evidence: /private/tmp/ekp-interaction-clean-rdZhdD records three actions: showcase width change, one-space insertion, and deletion exposing that space. Every immediate and redisplay assertion passes, with no region, pending transaction, replacing display, overlay, black segment, or non-Emacs window. Manifest/report/recording SHA-256: 0eaeebd1697d69304cfd70189d7381a026b761333ab46ab1e2c5923a6e2db0c9, 940efdb923a831dcd4b098cafee33b9a67c472f227be1897bd54cab0693f8b68, 519a4ba2757b453e54a2518c83784bfed26317eae4c3e246a984f38a2d30b2f5.
• Behavior/Risk: The two regressions are fixed at shared projection owners rather than showcase keys or self-insert advice. Static committed lines retain edge cleanup. issue012 and issue013 remain open only for required user-visible acceptance.

2026-07-29 — Plan task023 and task024

• Add issue_live_editing_interaction_20260729.md.
  • Records issue012 for inactive-mark activation during reprojection and issue013 for hidden active-line edge whitespace.
• Modify the phase spec, plan, task list, and global issue/change indexes.
  • Makes same-turn whitespace visibility and independent mark-active preservation explicit product contracts.
  • Adds a bounded adjacent-interaction audit instead of treating the two reported symptoms as isolated key-handler patches.
• Behavior/Risk: Planning and red-test records only; runtime behavior is unchanged at this entry.

2026-07-29 — Complete task022

• Add spec_text_property_layout_engine_20260729.md.
  • Records the current user-visible contract, command and live-edit flows, display-property mapping, failure/rollback behavior, edge cases, and acceptance criteria.
  • Corrects a completion-audit gap: the objective required a phase spec, but the implementation phase had only plan/technical records.
• Modify implementation, tests, automation, bilingual documentation, phase records, changelog, and the live-layout postmortem.
  • Links the spec from the plan, tasks, issue, and change trace.
  • Closes the repository-wide text-property architecture gate after a full diff and ownership review.
  • Removes the dead ekp-buffer--justified-spans and ekp--para-glue-shrink functions; adds no wrapper, compatibility shim, dependency, overlay path, or source-character fallback.
• Validation: buffer ERT 71/71; full default and seeded-permuted ERT 162/162; isolated fresh-process ERT 162/162; C/Elisp fuzz 300/300; warning-as-error byte compilation; checkdoc; pinned package-lint; release, dictionary, pinned-upstream dictionary, shell, diff, stale-name, no-overlay, and dead-private-function scans; portable/native/debug/ sanitizer C builds; exact 1–64px GUI glue; seven-case GUI matrix; and dynamic overflow/type/delete temporal verification.
• Retained GUI/dynamic evidence:
  • /tmp/ekp-live-final-029c-fOG8xp/manifest.jsonl (sha256:727305251edf07e4cee43bc6b8b25610a384e7d4f071656de388ec6e23913fd9) records one live Emacs window, source/projection hashes, zero overlays, exact overflow/pullback assertions, immediate/redisplay equality, and a completed 31,707ms run.
  • The clean first and final screenshots are frames/000001-setup-setup.png (sha256:5e324e25f278867b57c31b825c7d56c87d15b18f7fd1e99e276857127c0ddab8) and frames/000008-completion-final.png (sha256:f5e28d98190b8a494d7f010b423c217b104e76f8c79cc792a8359a328ae1797d).
  • report.md (sha256:fec75f10a851f220a937456fa17900c178f9466874340d1e178ca6e333693904) returns PASS with no incomplete or black segments; recording.mov (sha256:2e31a13b70c2387a0e9a08a1b87947180a46310e3f1becb8c445c768998ac347) is the 4,875,735-byte temporal source.
• Independent review: code reviewer APPROVE, zero findings; architecture reviewer CLEAR, no unresolved architectural blocker.
• Evidence correction: replaces the stale duration in phase records with 31.71 seconds, matching the retained dynamic manifest's 31,707ms run-end.
• Strengthen tests/ekp-buffer-tests.el.
  • Replaces presence-only display checks with exact structural assertions for ASCII ((space-width FACTOR) (min-width ((PIXELS)))), zero-source CJK (min-width ((PIXELS))), and the line-prefix pixel-space value.
  • Focused exact-property ERT passed 3/3; the current full suite passed 162/162. Warning-as-error compilation of the strengthened test file, production checkdoc, release checks, artifact cleanliness, and git diff --check passed.
• Behavior/Risk: The runtime and repository gates are complete. issue011 intentionally remains open until the user accepts the visible editing behavior, as required by the issue lifecycle.

2026-07-29 — Complete task021

• Modify ekp-buffer.el.
  • Adds synchronous bounded live flow with a natural unfinished line, minimal overflow push, deletion pullback, stable-line convergence, generation-checked IME/resize work, and automatic paragraph limits.
  • Keeps one source-marker anchor for a continuous editing flow so repeated deletion cannot move the recomputation boundary into the stable prefix.
  • Releases the active anchor on paragraph exit, explicit refill, hard-boundary reflow, conflict abandonment, and mode teardown.
• Modify tests/ekp-buffer-tests.el, tests/ekp-gui-verify.el.
  • Adds public-hook live-edit regressions, bounded-work tests, exact type/delete break restoration, anchor lifecycle checks, and before/immediate/settled source/projection hash assertions.
• Modify bilingual user/developer docs, current plan/test specification, changelog, and postmortem/20260729-text-property-live-layout.md.
• Behavior/Risk: Ordinary edits never run a delayed whole-paragraph formatter. The unfinished point line remains natural; overflow and pullback publish synchronously. Buffer ERT passed 71/71. The final 31.71s dynamic artifact passed every checkpoint with zero overlays, no immediate/settled hash drift, and exact deletion restoration.

2026-07-29 — Complete task020

• Delete ekp-region.el, tests/ekp-region-tests.el.
• Add ekp-buffer.el, tests/ekp-buffer-tests.el.
  • Replaces delete/insert physical layout with owned text properties on existing source characters only.
  • Maps ASCII glue to combined space-width/absolute-pixel min-width, zero-source glue to min-width, indentation to line-prefix, and breaks/hyphens to replacing display strings.
  • Preserves foreign property owners, direct logical text APIs, copy/save/ search semantics, point, undo, modified state, and external hooks.
• Modify GUI verification and bilingual user/developer documentation.
• Behavior/Risk: Buffer ERT passed 71/71. The clean Emacs 30.2 static probe passed exact 1–64px ASCII/CJK targets, display-only break/hyphen, point/vertical motion/region/mouse, unchanged source, and zero overlays; the 7-case scale/remap/fringe/width matrix passed.

2026-07-29 — Complete task019

• Modify ekp.el.
  • Adds semantic ekp-layout-plan, ekp-layout-line, and ekp-layout-gap records with source offsets, exact glue targets, break kinds, and discretionary-hyphen decisions.
  • Makes the existing reversible string renderer consume the shared plan.
• Modify tests/ekp-tests.el.
  • Adds source mapping, hyphen decision, and public-dispatch regressions.
• Modify DEVELOPER.md, DEVELOPER_ZH.md.
  • Documents the layout/rendering representation boundary.
• Behavior/Risk: Public string formatting remains compatible. The new plan is the single source for the upcoming buffer display projection. Validation: focused red 0/3 → green 3/3; full ERT 133/133; fuzz 300/300; warning-as-error compilation, checkdoc, and diff checks clean.

2026-07-29 — Plan task019 through task022

• Add plan_text_property_layout_engine_20260729.md.
  • Locks the shared core-plan architecture, text-property-only buffer mapping, live active-line state machine, narrowest-window policy, display ownership, verification gates, and rollback boundary.
• Modify task_repository_audit_20260728.md.
  • Adds atomic task019 through task022 for core extraction, static projection, live editing, and final closure.
• Behavior/Risk: Planning records only. Runtime behavior is unchanged. The main risk is Emacs display-property interaction; each milestone has a stop gate before downstream implementation.