secondeye-acknowledge

Your objective is to process Critical SecondEye findings and clear the build gate.

Before proceeding, verify that .cocoplus/ exists. If not: output "CocoPlus not initialized in this directory. Run $pod init to begin." Then stop.

Parse Arguments

• --hitl-only: acknowledge only HITL-classified findings. MINOR/AFK findings are queued for autonomous resolution in the next $build pass.
• --blocking-only: acknowledge only BLOCKING-classified findings, leaving MINOR findings for autonomous resolution.
• No flag: present all Critical findings for acknowledgment (existing behavior).

Find Unacknowledged Reports

Scan .cocoplus/lifecycle/ for files matching secondeye-*.md. Read YAML frontmatter of each file. Find files with critical_open: true AND acknowledged: false.

If none found: Output: "No unacknowledged Critical SecondEye findings. $build is not gated." Then stop.

Present Findings Based on Mode

No flag (default): Present all Critical findings one at a time. For each: "Acknowledge finding [SE-NNN]: [title] [[HITL/AFK]] [[BLOCKING/MINOR]]? (yes to acknowledge / no to keep it open)"

--hitl-only: Present only HITL-classified findings. AFK findings are listed as "queued for autonomous resolution" and not presented for acknowledgment.

--blocking-only: Present only BLOCKING-classified findings. MINOR findings are listed as "queued for autonomous resolution" and not presented for acknowledgment.

Update Report Metadata

If all required findings acknowledged (based on mode): Update the report file's YAML frontmatter:

• acknowledged: true
• acknowledged_at: [ISO 8601 timestamp]
• critical_open: false

Track which findings were acknowledged vs. queued. Update action_summary in frontmatter to reflect remaining counts.

If any required finding left unacknowledged: Output: "[N] findings still unacknowledged. $build remains gated."

Output

If all required findings acknowledged: Output: "All required findings acknowledged. $build gate cleared. You may now run $build." If AFK or MINOR findings were queued: "Note: [N] AFK/MINOR findings queued for autonomous resolution in next $build pass."

Anti-Rationalization

Shortcut / Temptation	Why It Fails
Mark report acknowledged without per-finding confirmation	Critical risks can be bypassed without review
Clear critical_open when any finding remains unresolved	Build gate semantics become untrustworthy
Ignore missing report files	Produces false confidence that gate is clear

Exit Criteria

• Unacknowledged reports are identified using critical_open: true and acknowledged: false
• Each finding is presented with its HITL/AFK and BLOCKING/MINOR tags
• --hitl-only presents only HITL-classified findings; AFK findings listed as queued
• --blocking-only presents only BLOCKING-classified findings; MINOR findings listed as queued
• Report frontmatter is updated to acknowledged: true, acknowledged_at: [ISO timestamp], and critical_open: false only when all required findings are acknowledged
• Output states whether $build remains gated or is cleared, and how many findings were queued for autonomous resolution