Function _postprocess_plan

core/orchestrator.py:135–174

Post-process plan steps: merge same-file steps and cap count. Recursive planning (Phase 4) self-corrects waste steps and quality, so this only handles structural deduplication. Run: steps are never merged — running the same file twice is intentional (e.g. "run it again to veri

(tasks)

def _postprocess_plan(tasks):
    """
    Post-process plan steps: merge same-file steps and cap count.

    Recursive planning (Phase 4) self-corrects waste steps and quality,
    so this only handles structural deduplication.

    Run: steps are never merged — running the same file twice is intentional
    (e.g. "run it again to verify"). Only Create/Write/Update steps are
    deduplicated by shared filename.
    """
    if not tasks:
        return tasks

    # Merge steps targeting the same file — keep the longer description.
    # Run: steps are passed through unchanged so intentional duplicate runs
    # (e.g. "run wordcount.py twice") are preserved.
    merged = []
    seen_files = {}  # filename -> index in merged list
    for t in tasks:
        if _RUN_STEP_RE.match(t):
            # Shell-command steps: always keep as-is, never deduplicate
            merged.append(t)
            continue
        files_in_step = _FILE_RE.findall(t)
        merged_into = None
        for f in files_in_step:
            if f in seen_files:
                merged_into = seen_files[f]
                break
        if merged_into is not None:
            if len(t) > len(merged[merged_into]):
                merged[merged_into] = t
        else:
            idx = len(merged)
            merged.append(t)
            for f in files_in_step:
                seen_files[f] = idx

    return merged[:8]

def plan_tasks(user_message, project_context=''):
    """