hyv-ingest

Files (3)

• SKILL.md
• agent.json
• openai.yaml · agents/

SKILL.md (first lines)

# hyv-ingest

Turn an explicitly authorized local Gmail Sent.mbox or Telegram Desktop JSON export into redacted writing samples. This is opt-in local preprocessing, not background collection, training, synchronization, or network access.

## Usage

```text
hyv ingest <gmail-sent-mbox|telegram-desktop-json> export --owner=owner --output=/absolute/safe-directory [--blocked=word]
```

## Preconditions

- Confirm the source is authorized by its owner and select the source type exactly.
- Use an existing absolute output directory outside every Git checkout. The command creates new `samples.jsonl` and text-free `receipt.json`; it refuses existing files and never overwrites exports.
- Add `--blocked=word` for each user-supplied term that must drop its entire sentence. Do not put secrets or sample prose in command output or a status message.

## Behavior

- Only messages attributable to the explicit owner are retained.
- Email addresses, phone numbers, card-like values, IP addresses, and URLs are deterministically redacted before `samples.jsonl` is created. The receipt records counts and digests, never raw prose, paths, or source content.
- Presidio is optional. If no approved adapter ran, report `NOT_CONFIGURED`; do not imply it was installed.
- This command makes no provider call, telemetry event, network request, profile, or model. It cannot open a socket.

## Handoff

Inspect the new samples locally, then use `hyv-profile` to build a profile or `hyv-score` with a separately held-out set. Do not add the redacted export to a repository without separate approval.

From shashank-sn/holdyourvoice, MIT.

More from shashank-sn/holdyourvoice