Update release intake manifest automation

[telard-pixel]

Maintenance PR for release automation. This is not a release PR and intentionally has no release markers. It updates release-intake so future release tags automatically update manifest.json from the tag version.

Summary by CodeRabbit

• Documentation

  • Updated release workflow documentation to clarify accepted tag formats and process flow.

• Chores

  • Enhanced automated release intake workflow to synchronize manifest versioning with tag versions.
  • Improved tag and manifest validation logic in the release process.

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

Release intake workflow is automated to synchronize manifest.json with pushed release tags. A new manifest version helper function updates the manifest file, and the intake workflow detects mismatches, auto-updates the manifest on dev, force-pushes the corrected tag, and skips duplicate PRs via marker extraction.

Changes

Release Workflow Manifest Synchronization

Layer / File(s)	Summary
Manifest version update helper .github/scripts/release-policy.sh	New set_manifest_version function parses and updates the manifest.json version field via inline JSON manipulation, enabling programmatic version synchronization.
Release intake workflow manifest synchronization .github/workflows/release-intake.yml	Early assertion check is removed; new logic extracts release-tag and release-source-sha markers from existing PR bodies to detect duplicates. When manifest and tag versions differ, the workflow checks out dev, updates manifest.json, commits/pushes the change, force-updates the annotated tag to include the new manifest commit, and re-computes SHAs before PR creation. If versions already match, the workflow asserts alignment and continues to PR creation.
Updated release workflow documentation docs/release-workflow.md	Clarifies that pushed tags (vX.Y.Z or vX.Y.Z-beta) define the integration version; the workflow automatically updates manifest.json on dev by stripping the leading v. Operator flow is simplified to remove manual manifest.json updates; the workflow handles synchronization. Historical tags caveat is generalized to acknowledge that old tags may lack the v prefix while new validation applies to future tags.

Sequence Diagram

sequenceDiagram
    participant Git as Git / GitHub
    participant Intake as release-intake.yml
    participant Helper as set_manifest_version
    participant Dev as dev branch
    participant Main as main branch
    
    Git->>Intake: Tag pushed (vX.Y.Z)
    Intake->>Git: Fetch existing open PR
    alt PR has matching markers
        Intake-->>Git: Exit (duplicate)
    else No matching markers
        Intake->>Intake: Extract RELEASE_VERSION from tag
        Intake->>Git: Read manifest @ TAG_SHA
        Intake->>Intake: Compare CURRENT_VERSION
        alt Versions differ
            Intake->>Dev: Checkout dev branch
            Intake->>Helper: set_manifest_version(RELEASE_VERSION)
            Helper->>Dev: Update manifest.json
            Intake->>Dev: Commit & push manifest change
            Intake->>Git: Force-update tag to new TAG_SHA
        else Versions match
            Intake->>Intake: Assert manifest alignment
        end
        Intake->>Git: Create PR (dev → main)
    end

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

• telard-pixel/haier_hon#2: Bootstrap release workflow introduces tag↔manifest validation; this PR extends that foundation to automate manifest synchronization within the intake workflow.

Poem

🐰 A tag is pushed, the workflow springs alive,
Manifest and version now in perfect sync—
No more manual edits, the script takes the drive,
One truth from the tag, and the PR's in a blink! ✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'Update release intake manifest automation' directly describes the main change—adding manifest version synchronization logic to the release intake workflow.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch dev

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}