pp-function-health

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/other/function-health/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# Function Health — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `function-health-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer:
   ```bash
   npx -y @mvanhorn/printing-press-library install function-health --cli-only
   ```
2. Verify: `function-health-pp-cli --version`
3. Ensure `$GOPATH/bin` (or `$HOME/go/bin`) is on `$PATH`.

If the `npx` install fails before this CLI has a public-library category, install Node or use the category-specific Go fallback after publish.

If `--version` reports "command not found" after install, the install step did not put the binary on `$PATH`. Do not proceed with skill commands until verification succeeds.

Function Health gives you a great single-round dashboard but no way to see what's drifting across years of draws — and no way to share a clean, branded lab history with your physician. function-health-pp-cli pulls every round into a local SQLite store with FTS5, exposes cross-round trend analysis nobody else offers (`goat`, `biomarker trend`, `biomarkers trending`, `biomarkers oscillating`), and renders a Function-branded PDF with your name and date of birth that an MD can read in 30 seconds.

## When to Use This CLI

Reach for function-health-pp-cli whenever an agent is asked to reason about lab trends over time, to prioritize which biomarker the user should worry about, or to produce an artifact a clinician will actually read. It is the right tool when the question requires joining data across multiple test rounds, when the user wants a branded PDF for a doctor, or when an agent needs a focused Markdown context block for one biomarker rather than the entire JSON export. It is the wrong tool for one-off single-result lookups on a draw that hasn't been synced yet — for those, run `sync` first or query the Function web app directly.

## When Not to Use This CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.

## Unique Capabilities

These capabilities aren't available in any other tool for this API.

### Doctor-ready outputs
- **`export pdf-for-doctor`** — Render a Function-branded multi-round lab report PDF with your name and date of birth, suitable for emailing to your personal physician.

  _When an agent needs to produce something the user will hand to a third party, this is the durable artifact — not a JSON blob._

  ```bash
  function-health-pp-cli export pdf-for-doctor --out ~/Downloads/function-history.pdf
  ```

### Local-SQL trend analysis
- **`biomarker trend`** — Every value of a biomarker across every round you've ever drawn, with the delta from Function's optimal range, an ASCII sparkline in the terminal, and structured JSON for agents.

  _When the agent is asked 'how has X changed', this is the one query that answers it without re-fetching anything._

  ```bash
  function-health-pp-cli biomarker trend ApoB --json
  ```
- **`goat`** — Ranks every biomarker by distance-from-optimal multiplied by its slope-away-from-optimal across the last 3 rounds; returns the single most worrying biomarker right now with reasoning fields.

  _When the agent is asked 'what should I worry about', this is the one-call answer._

  ```bash
  function-health-pp-cli goat --agent
  ```
- **`biomarkers trending`** — Lists every biomarker whose slope across the last N rounds points away from Function's optimal range, sorted by magnitude.

  _Lets the agent prioritize a long biomarker list without burning the user's context window on every reading._

  ```bash
  function-health-pp-cli biomarkers trending --direction worse --last 3 --json
  ```
- **`category trend`** — For one of the ~13 categories, returns a per-round aggregate score (percent of biomarkers inside Function's optimal range) over time.

  _Rolls up 100+ biomarkers into a single trajectory per body system, so the agent can summarize organ-level changes._

  ```bash
  function-health-pp-cli category trend cardiovascular --json
  ```
- **`biomarkers oscillating`** — Biomarkers that crossed the optimal-range boundary at least twice in the last N rounds — flags instability separate from trend.

  _Distinguishes 'unstable measurement noise' from 'consistently bad' — important when the agent is reasoning about whether a single high reading matters._

  ```bash
  function-health-pp-cli biomarkers oscillating --rounds 4
  ```
- **`recommendations stale`** — Recommendations (supplements / foods) whose target biomarker is STILL outside Function's optimal range, joined by Quest code. The /recommendations endpoint has no issued-date, so staleness is by outcome not age; --min-rounds tightens to persistence and --group (supplements, foods_to_eat, foods_to_avoid) focuses a large set.

  _Closes the loop between guidance and outcome — the agent can ask 'did the last fix work?' instead of 'what is recommended now?'._

  ```bash
  function-health-pp-cli recommendations stale --json
  ```

### Agent-native plumbing
- **`bundle`** — Composes a single Markdown file with a biomarker's full history, every clinician note mentioning it (FTS5), Function's optimal range, and relevant recommendations — ready to paste into Claude or ChatGPT.

  _When the agent is being asked to draft a question for the user's clinician, this is the prefab context block._

  ```bash
  function-health-pp-cli bundle ApoB --window 3rounds
  ```

## Command Reference

**biological_age** — Biological-age and BMI calculations Function derives from your panels.

- `function-health-pp-cli biological-age bio-age` — Your biological age vs. chronological age. 404 if not yet calculated.
- `function-health-pp-cli biological-age bmi` — BMI with the weight and height inputs Function recorded.

**biomarkers** — Function Health's full biomarker catalog with names, units, reference ranges, and Function's "optimal" ranges.

- `function-health-pp-cli biomarkers get` — Get one biomarker's full result history across every round you've drawn, with values, units, status, and ranges.
- `function-health-pp-cli biomarkers list` — List every biomarker the platform knows about (across all categories).

**categories** — The ~13 medical categories biomarkers are organized into (Heart, Hormones, Thyroid, Metabolic, Liver, Kidney, etc.).

- `function-health-pp-cli categories` — List every biomarker category with the biomarkers nested under it.

**notes** — Clinician notes attached to your results.

- `function-health-pp-cli notes` — List all clinician notes (annotations on biomarkers / rounds).

**notifications** — Change notifications (new results landing, biomarker direction changes).

- `function-health-pp-cli notifications` — Read all unread/read notifications about result changes.

**recommendations** — Personalized health recommendations tied to your results.

- `function-health-pp-cli recommendations` — Per-category health guidance. May 404 if Function hasn't computed any yet.

**requisitions** — Lab requisitions — pending (in-progress draws) and completed (rounds with results).

- `function-health-pp-cli requisitions completed` — Completed requisitions (your past test rounds, keyed by requisitionId).
- `function-health-pp-cli requisitions pending` — Currently in-progress requisitions (lab orders awaiting completion).

**results** — Lab results — both the structured bio