Function cmd_forward_port

dev-tools/scripts/logchange.py:301–476

(args, git_root)

# ---------------------------------------------------------------------------

def cmd_forward_port(args, git_root):
    dry_run = args.dry_run
    do_push = args.push
    version = args.version
    release_branch = args.release_branch
    stable_branch = args.stable_branch
    latest_lts_stable_branch = args.latest_lts_stable_branch
    release_date_str = args.release_date or date.today().isoformat()

    version_dir = git_root / "changelog" / f"v{version}"

    print(f"\n=== Changelog forward-port for v{version} ===")
    print(f"    Release date   : {release_date_str}")
    print(f"    release_branch : {release_branch}")
    print(f"    stable_branch  : {stable_branch}")
    print(f"    also targets   : main")
    if latest_lts_stable_branch:
        print(f"    lts also targets: {latest_lts_stable_branch}")
    if dry_run:
        print("    (dry-run — no changes will be made)")
    elif not do_push:
        print("    (push disabled — run with --push when ready)")
    print()

    # Step 1: checkout release branch and write release-date.txt
    print(f"[1] Checking out {release_branch} and writing release-date.txt")
    git(["checkout", release_branch], cwd=git_root, dry_run=dry_run)

    if not dry_run and not version_dir.exists():
        print(f"Error: version folder {version_dir} does not exist. "
              f"Run 'prepare' first.", file=sys.stderr)
        sys.exit(1)

    date_file = version_dir / "release-date.txt"
    print(f"  Writing {date_file.relative_to(git_root)}: {release_date_str}")
    if not dry_run:
        date_file.write_text(release_date_str + "\n", encoding="utf-8")

    version_summary = f"changelog/v{version}/version-summary.md"

    # Step 2: commit A — release-date.txt only (before generate)
    print(f"\n[2] Committing release-date.txt to {release_branch} (commit A)")
    git(["add", f"changelog/v{version}/release-date.txt"], cwd=git_root, dry_run=dry_run)

    if not dry_run and not has_staged_changes(git_root, [f"changelog/v{version}/release-date.txt"]):
        print("  Nothing staged — release-date.txt was already up to date.")
    else:
        msg_a = f"Set release date {release_date_str} for v{version}"
        print(f"  Committing: {msg_a!r}")
        git(["commit", "-m", msg_a], cwd=git_root, dry_run=dry_run)

    # Step 3: commit B — regenerate, then stage CHANGELOG.md + version-summary.md
    print(f"\n[3] Running logchangeGenerate (with release date {release_date_str})")
    run_logchange_generate(args.gradle_cmd, git_root, dry_run=dry_run)

    print(f"\n[3b] Staging CHANGELOG.md and version-summary.md to {release_branch} (commit B)")
    git(["add", "CHANGELOG.md", version_summary], cwd=git_root, dry_run=dry_run)