# Demo Runbook

This runbook verifies the public workflow without committing generated reports
or API keys.

## 1. Check Help

```bash
bun scripts/digest.ts --help
```

Expected shape:

```text
AI Daily Digest - AI-powered RSS digest from 90 top tech blogs
Usage:
  bun scripts/digest.ts [options]
```

## 2. Configure API Access

Use an environment variable for the key:

```bash
export GEMINI_API_KEY="your-key"
```

Do not commit this value. If you run through the skill, reusable preferences may
be written outside the repo at:

```text
~/.hn-daily-digest/config.json
```

## 3. Generate a Small Digest

```bash
mkdir -p output
bun scripts/digest.ts --hours 24 --top-n 10 --lang zh --output ./output/digest-smoke.md
```

If Bun is not installed:

```bash
npx -y bun scripts/digest.ts --hours 24 --top-n 10 --lang zh --output ./output/digest-smoke.md
```

## 4. Inspect the Report

Check that the report includes:

- daily highlights
- top reads
- data overview
- category sections
- source/run metadata footer

## 5. Keep Generated Files Local

`output/` and `digest-*.md` are ignored by git. Move or publish reports manually
only after reviewing the content and checking source links.