Release changelog agent that publishes GitHub PRs to Confluence and Notion

previous_tag, current_tag = resolve_release_range(
    github, cfg.github_owner, cfg.github_repo, cfg.previous_tag, cfg.current_tag,
)   # github_release_get_latest, then github_tags_list for the tag before it

if not cfg.release_version:
    cfg.release_version = current_tag
    logger.info(f"  RELEASE_VERSION not set -- using the current tag '{current_tag}'")

comparison = github.compare(cfg.github_owner, cfg.github_repo, previous_tag, current_tag)
commits = comparison.get("commits") or []
numbers = extract_pr_numbers_from_commits(commits)          # "(#123)" at end of subject

for sha in unresolved[:25]:                                  # merge commits, direct pushes
    for pr in github.pull_requests_for_commit(cfg.github_owner, cfg.github_repo, sha):
        if int(pr["number"]) not in numbers:
            numbers.append(int(pr["number"]))

if len(unresolved) > 25:
    logger.warning(f"  {len(unresolved) - 25} commit(s) not resolved; omitted from the changelog")

head_ref = str((pr.get("head") or {}).get("ref") or "")
haystack = " ".join([raw_title, str(pr.get("body") or "")[:2000], head_ref])
linear_ids = extract_linear_ids(haystack, team_prefixes)     # ENG-412 in title, body or branch

issue = linear.execute_tool("linear_issue_get", issueId=identifier)
if issue:                       # a miss is normal: typos, deleted issues, other trackers
    entry.linear_issues.append(issue)

if cached := state.get_published(owner, repo, version):
    logger.info(f"  Already published to Confluence: {cached} -- skipping")
    return

if existing := confluence.find_page_by_title(cfg.confluence_space_key, title):
    return                                    # remote guard, survives state-file loss

page = confluence.create_page(
    space_id=resolve_confluence_space(confluence, cfg.confluence_space_key),
    title=title, body=render_confluence_storage(**render_args),
)
state.mark_published(owner, repo, version, "confluence", _confluence_url(page))

def mark_published(self, owner, repo, version, target, url):
    """Record that `version` was published to `target` ("confluence"/"notion")."""
    versions = self._versions(owner, repo)
    entry = versions.setdefault(version, {})
    entry[target] = url                       # per target, so a partial run is resumable
    self.save()                               # atomic replace, never a half-written file