hyv-profile

Build a portable VoiceDNA profile from at least two writing samples. Samples stay in memory and are not saved into the profile; only measured voice features are written. The output path must be supplied first, followed by two or more sample paths. Use --avoid=phrase to add phrases that must never appear in later output.

Usage

hyv profile profile.json sample-a.md sample-b.md [sample-c.md] [--avoid=phrase]

Behavior

• Deterministic and local-first: this command never calls a provider and never sends drafts, samples, profiles, or telemetry to a service.
• This command writes the stable Profile v2 shape. For channel-specific V3 profiles use hyv profile v3 profile.json --id=writer.email --channel=email sample-a.md sample-b.md [--tone=0,0,0,0,0] [--avoid=phrase]; it signs policy and sample allowances without retaining raw prose. To blend approved V3 profiles locally, use hyv profile compose --ratio 70:30 profile-a.json profile-b.json.
• To rebuild a V3 profile after explicit sample changes, use hyv profile watch /absolute/profile.json --id=writer.email --channel=email sample-a.md sample-b.md. The watcher debounces named local files and writes only to an existing, non-Git absolute directory; stop it with Ctrl-C.
• Commands that write use an explicit output path. Confirm that path before running the command.
• This agent describes how to invoke the command and what it returns. It does not change command behavior or exit codes.

Handoff

Run hyv profile directly to execute the operation. Follow-on agents: hyv-analyze, hyv-rewrite-prompt.