# Always Be Selling — Operator Reference

================================================================

## PIPELINE (daily use)

```bash
absel brief                    # Full pipeline, top 10 leads
absel brief -d 3               # Last 3 days instead of 1
absel brief -l 20              # Show 20 leads
absel brief --no-draft         # Harvest + enrich only, skip LLM
absel brief -c fresh           # Only fresh leads (0-14 days)
absel brief -c recent          # Only recent leads (15-89 days)
absel brief -c historical      # Only historical leads (90+ days)
absel brief --drafted-only     # Show only already-drafted leads
absel brief --undrafted-only   # Show only leads without drafts
absel brief --strong-only      # Only leads with signal
absel brief -c historical --drafted-only -o /tmp/hist.md  # Combine + save
```

## REVIEW QUEUE (interactive)

```bash
absel review                   # Paginated list of drafted leads
absel review -c fresh          # Only fresh category
absel review --strong-only     # Only high-signal leads
absel review -p 10             # 10 per page instead of 25
```

Inside review:

```
burn #3 "remove me"    # Permanently remove lead #3
pause #5 "bad timing"  # Pause lead #5
delete #2              # Remove draft only, lead stays
regen #4               # Regenerate draft with LLM
approve #1             # Mark cleared for sending
next / prev            # Navigate pages
quit                   # Exit
```

## OUTREACH CONTROL

```bash
absel burn <id> "reason"    # Permanently remove a lead
absel pause <id> "reason"   # Pause a lead (resumable)
absel unpause <id>          # Resume a paused lead
```

## GATE (global pause)

```bash
absel gate status           # Check gate state
absel gate close -r "holiday"  # Pause outreach, keep harvesting
absel gate open             # Resume outreach
```

## OUTSIDE SALES (Brian's list)

```bash
absel export outside-sales              # All counties, text
absel export outside-sales -c "New Haven"   # One county
absel export outside-sales -c "Fairfield" -f csv -o ff.csv  # CSV file
absel export outside-sales -c "Hartford" -f csv -o hf.csv
```

Order: New Haven first, then Fairfield, Hartford, others alpha, then UNKNOWN. Sorted by score within each county.

## COMPETITIVE INTELLIGENCE

```bash
absel intel agents          # Agent displacement rates
absel intel agents -m 5     # Agents with 5+ filings
absel intel principals      # Principal overlap (WRITES FLAGS)
absel intel addresses       # Address clustering (WRITES FLAGS)
absel intel addresses -m 3  # 3+ businesses per address
absel intel wins            # Stub (needs Zoho)
```

## HARVEST

```bash
absel harvest recent              # Last 1 day (default)
absel harvest recent -d 7         # Last 7 days
absel harvest range -s 2025-01-01 -e 2025-06-01   # Historical sweep
absel harvest range -s 2025-01-01 -e 2025-06-01 -r  # Resume from checkpoint
absel harvest milestone -y 5      # Businesses near 5-year anniversary
absel harvest milestone -y 3 -w 60  # 3-year, 60-day window
```

## DATA

```bash
absel counts               # Lead counts by status and stage
absel purge --confirm      # Wipe backlog (keeps gate state)
absel enrich <id>          # Enrich a single lead
absel draft <id>           # Draft a single lead
absel status <id>          # Full state of a lead
absel classify <id>        # Zoho vertical classification
```

================================================================

## SIGNAL TIERS

| Tier | Criteria |
|------|----------|
| **Strong** | email + phone + live website |
| **Good** | email + phone OR email + website |
| **Basic** | email only OR phone only |
| **Weak** | filing-service email, no phone |

================================================================

## TEMPORAL CATEGORIES

| Category | Days Since Filing |
|----------|-------------------|
| `fresh` | 0-14 days |
| `recent` | 15-89 days |
| `historical` | 90+ days |

================================================================

## OUTSIDE SALES CRITERIA

A lead qualifies when **ALL** are true:

- No usable email (empty, filing-service, or free provider)
- No phone (`phone`, `domain_phone`, `brave_phone` all empty)
- Has a physical address

**Note:** Leads WITH a phone but no email are NOT outside sales.

================================================================

## KNOWN ISSUES

### agent_name Field Empty (2026-05-21)

The CT SOS API does not expose registered agent data. All 9,828 leads have empty `agent_name` field. The harvester correctly maps the field, but the source dataset doesn't include it.

Alternative groupings: email domain, NAICS category, city.

### Greeting Name from brave_summary (2026-05-21)

Context assembly bug: LLM may extract greeting names from unvalidated `brave_summary` text. See DEVLOG.md for details.

================================================================