Skip to content

REQ 005

sergio velderrain edited this page Nov 9, 2026 · 1 revision

REQ-005: New-HumanEscalation.ps1 idempotent update-in-place

Requirement

New-HumanEscalation.ps1 shall be idempotent for a given -EscalationId: re-invoking it against the same repo and ID updates the existing open issue in place rather than creating a duplicate, verifying the match against the real issue body client-side (not trusting GitHub's search index alone), and surfacing (not silently swallowing) a search failure.

Rationale

Lets an agent re-confirm a blocker is still unresolved without accumulating duplicate issues, and without a flaky/eventually-consistent search silently producing a false match or a hidden duplicate.

Fit Criterion

A second invocation with the same -Repo/-EscalationId but different -Context results in exactly one open issue, with the updated body and the original title preserved; a search failure emits a visible warning rather than silently falling through.

Verification

Live-verified this round: real create (VITechnologies/projectbuddy#83) then real update-in-place with the same -EscalationId (same issue number, body content genuinely changed, confirmed via gh issue view), test issue closed after. Builds on an earlier session's svelderrainruiz/projectbuddy#18 verification (title preserved, assignee added).

Source

Software-Requirements-Specification

Priority

High

TestID

TEST-005

TestArtifact

Live smoke test, svelderrainruiz/projectbuddy#18

CodeRef

New-HumanEscalation.ps1 module

Status

Verified (live)

Clone this wiki locally