2. Generate Curated Entries

Purpose: Use AI to generate notable entity names for a topic category and insert them into the seed entry queue before explosion.

Prerequisites:

  • .env.local has API key for the routed model (see available models)
  • Target topic category exists in topic_categories and is active (1,104 categories across 33 roots)
  • Category specs are configured in packages/ai/src/config/categories.ts (44 CategorySpec definitions)
  • AI model available for the default tier (check ai_model_tier_config — the seed_explosion task maps to default tier)

Cost / Duration: ~$1-5 per category (depends on entity count and model) | 5-15 minutes

Prompt

I need to generate curated seed entries for topic categories.

First, read `packages/ai/src/config/categories.ts` to see available category specs
(44 specs covering all 33 active roots), and run the stats command to see what
entries already exist:

```bash
bun scripts/seed/seed-from-files.ts --stats
```

Now help me generate entries for the following topic: <TOPIC_SLUG>

### Step A: Preview (no DB writes)

Run the generator in preview mode so we can review the output for quality:

```bash
bun scripts/seed/generate-curated-entries.ts --category <TOPIC_SLUG>
```

Review the generated entity names. Flag any that look low-quality, duplicate,
or off-topic before we commit.

### Step B: Insert into seed_entry_queue

Once we are satisfied with the preview, insert them:

```bash
bun scripts/seed/generate-curated-entries.ts --category <TOPIC_SLUG> --insert
```

If I want to generate for ALL active topics instead, run:

```bash
bun scripts/seed/generate-curated-entries.ts --insert
```

Use `--limit N` to cap the total number of entities generated.

Note: The CategorySpec `slug` must match a root category slug in
`topic_categories`. Some roots have multiple specs (e.g., sports
has per-sport specs like `baseball`, `basketball`). Use the slug
from the CategorySpec, not the root slug, when targeting those.

### Step C: Confirm insertion

Run stats again to verify the entries landed:

```bash
bun scripts/seed/seed-from-files.ts --stats
```

Report how many new entries were added per topic.

Verification

  • Preview output reviewed for quality and relevance
  • Entries appear in seed_entry_queue with status = 'pending'
  • Each entry has topic_category_id set correctly
  • No duplicate entity names for the same topic
  • Stats command shows expected counts

Back to index