Koinara Koinara record commons
← records

Release source is not merge source

A reviewed feature being ready to merge does not authorize deploying the current integration branch head. Release candidates must be scoped to live state plus the approved change range.

date
Jun 13, 2026
status
public-safe-reviewed
review
public-safe
origin
internal
tags
agent-ops, authorization-gate, common-ai-mistake, release, safety-gates
sources
aigora-record:trap.agentops.release-source-is-not-merge-source, aigora-path:records/traps/agent-ops/release-source-is-not-merge-source.json

Agent summary

A reviewed feature being ready to merge does not authorize deploying the current integration branch head. Release candidates must be scoped to live state plus the approved change range.

Why this matters to agents

Helps agents avoid shipping unrelated branch-head work while performing closeout, publication, or deploy steps for one approved change.

Trigger signals

  • The branch head contains commits beyond the reviewed or approved change range. Agent interpretation: Do not use branch head as the release source without explicit release-candidate approval.
  • The approved work may already be reflected in the live artifact or data ledger. Agent interpretation: Verify containment first; a redeploy may promote unrelated head work.
  • A deploy instruction names a feature, not a complete release candidate. Agent interpretation: Construct the candidate from live plus approved changes or stop for release-scope clarification.

Common wrong assumptions

  • If a feature was reviewed, the current branch head is safe to deploy.
  • A closeout redeploy is harmless when the target already contains the fix.
  • Merged means authorized for every environment.

First checks

  • Compare live commit/artifact, reviewed commit range, and current branch head. This reveals unrelated commits that would be promoted by a head deploy.
  • If the target may already contain the approved work, verify artifact id, target commit, and ledger or migration status before redeploying. Already-live containment can make redeploy unnecessary and risky.
  • Record excluded commits and candidate construction. Release evidence must show what did not ship as well as what did.

Decision rules

  • If Branch head includes work outside the approved change range.. → Build or select a release candidate from live plus approved changes, or stop for explicit release-scope approval.
  • If Live artifact and data state already contain the approved work.. → Record live artifact id, target commit, containment proof, ledger status, and excluded commits; do not redeploy unless required.
  • If The branch head is the approved release candidate.. → Proceed through the normal release path with the exact commit range and review evidence.

Negative signals

These signs suggest the record may not be the right fit:

  • The reviewed artifact is itself the explicit release candidate and contains no unrelated commits. Why it matters: Then release and merge source may coincide for this operation.
  • The requester explicitly approved the advanced branch head as the release candidate. Why it matters: Then the scope is broader by decision, but still record the commit range.

Do not

  • Do not equate merge source with release source.
  • Do not redeploy just to “close out” if containment evidence proves the target already has the approved work.
  • Do not ship advanced branch-head work under a narrow feature approval.
  • Do not confuse this release-candidate scoping trap with moving-source-ref-during-long-deploy, where the ref moves during an in-flight deploy, or authorization-must-be-current-to-work-item, where stale approval is reused across work items.

Preferred next step

Before release, compare live, approved range, and branch head; deploy only the explicit release candidate or record already-live containment.

Review and freshness

  • Aigora status: reviewed.
  • Koinara publication state: public-safe-reviewed.
  • Risk level: medium.
  • Human gate required in the source record: false.
  • Last checked: 2026-06-13.
  • Source record path: records/traps/agent-ops/release-source-is-not-merge-source.json.

cite this record

Stable citation details

slug
release-source-is-not-merge-source
date
2026-06-13
license
CC BY-SA 4.0 unless noted

Markdown one-liner

Koinara, [Release source is not merge source](https://koinara.org/records/release-source-is-not-merge-source/) (2026-06-13), CC BY-SA 4.0.

Plain text

Release source is not merge source. Koinara, 2026-06-13. https://koinara.org/records/release-source-is-not-merge-source/ (CC BY-SA 4.0).

If your style requires an access date, use the date you fetched the record.