---
created: 2026-03-26T02:54:53.069Z
title: Product unit ownership audit trail via GH issue timeline comments
area: integrations
files:
  - crates/integrations/src/github/issues_client.rs
  - crates/app/src/live_client.rs
---

## Problem

When product units transition between ownership states (departed factory, recipient received, departed recipient, factory received), there is no audit trail recording who had what and when. This lifecycle tracking is critical for serialized units that move between the factory and recipients.

## Solution

- On each ownership state transition, post a comment on the `ww-product-unit` GH Issue documenting the event
- Each comment uses native GH issue linking to reference the associated `ww-recipient` issue (e.g., `BigscreenVR/beyond-outgoing#42`)
- State transitions to track:
  - **Departed factory** — unit left the factory heading to a recipient (link recipient issue)
  - **Recipient received** — unit arrived at recipient (link recipient issue)
  - **Departed recipient** — unit left the recipient heading back to factory (link recipient issue)
  - **Factory received** — unit returned to factory
- Comment format should be structured enough for future parsing but human-readable in the GH UI
- Requires `ww-recipient` issues to exist first (see companion todo: auto-promote recipient rows)
- Add `gh issue comment` support to GhIssuesClient