CONTEXT.md

Rama main · réplica de lectura del repositorio original.

# Domain Context

## Clean Planning

The domain process that turns a video and cleanup request into a deterministic
`WipePlan`. It owns request interpretation, detection configuration and
execution, candidate selection, and plan construction/refinement.

Interactive confirmation, progress presentation, artifact persistence, and
inpainting execution stay in their adapters.

## Clean Plan Draft

The reviewable intermediate result of Clean Planning. It contains detected
candidates, the resolved request, and the proposed remove selection together
with the runtime evidence needed for final refinement. It is not executable.

An adapter may present or override the proposed selection. Finalizing the draft
produces the deterministic `WipePlan`.

The draft and its planning interface are internal. `WipeEngine.plan()` remains
the public planning interface.

## WipePlan Execution

The deterministic projection of a `WipePlan` into the static spatial mask and,
for segmented remove tracks, the per-frame temporal mask. It owns precise-mask
validation, binary normalization, union, feathering, segment activation, and
the bounded immutable frame cache. Inpainting adapters consume the projection;
they do not reinterpret tracks.

## Quality Acceptance

**Playback Quality Acceptance（正常播放画质验收）**: Normal-speed playback has no
obvious target-text residue, smearing, or flicker. Minor texture differences
visible only when paused and enlarged are acceptable; this does not imply
pixel-perfect restoration.

**False Removal（误擦）**: Altering content the user intends to retain, including
protected regions. It is distinct from target-text residue（待移除文字残留）.

**Headless Operation（无图形界面运行）**: Completing video processing without
requiring the user to configure graphical-interface dependencies. It is distinct
from a dependency being compiled without any GUI capability.