# Source Document Retrieval — Summary Report

**Task:** Retrieve primary source document for 20-Year Bond Auction (ID: 418789)  
**Date:** March 17, 2026  
**Status:** ⚠️ **INCOMPLETE** — Document not yet located; potential future/pending publication  

---

## Executive Summary

The 20-Year Bond Auction announcement for March 17, 2026 (yield: 4.817%) could not be fully retrieved due to:

1. **Possible Future Event** — The date (March 17, 2026) may be future or results may not yet be published
2. **JavaScript Rendering Requirement** — TreasuryDirect and Treasury press release pages require JavaScript execution to display results
3. **API Authentication Constraint** — Perplexity web search API returned 401 Unauthorized, preventing enhanced search
4. **URL Pattern Uncertainty** — Direct URL pattern for this specific auction not yet constructed

Despite these limitations, **complete metadata** and **structured result documentation** have been created to guide future retrieval.

---

## Retrieval Workflow

### Phase 1: Direct URL Pattern Resolution

**Attempt 1:** TreasuryDirect Auction Results  
- Tried: `/auctions/results/` (direct page fetch)
- Result: **Page found but no March 17 entry** — Data is JS-rendered; static curl cannot access tabulated results

**Attempt 2:** Treasury Press Releases Archive  
- Tried: `home.treasury.gov/news/press-releases/2026`
- Result: **Page found** — Archive exists but specific March 17 entry not located via static search

**Attempt 3:** FiscalService Auction Announcements  
- Tried: `fiscalservice.treasury.gov/reports-statements/auction-information/`
- Result: **HTTP 404** — Endpoint not found or inaccessible

### Phase 2: Site-Scoped Web Search

**Attempt 4:** Perplexity API Search  
```bash
python3 scripts/search.py "site:treasury.gov 20-year bond auction March 2026"
```
- Result: **HTTP 401 Unauthorized** — PERPLEXITY_API_KEY invalid or missing

### Phase 3: Browser Navigation (Incomplete)

**Attempt 5:** TreasuryDirect Query Tool  
- URL: https://www.treasurydirect.gov/auctions/auction-query/
- Method: Browser navigation required (auction query uses JavaScript UI)
- Status: **Not attempted** — Requires browser session

---

## Document Characteristics

### Expected Source
- **Institution:** U.S. Department of the Treasury / TreasuryDirect
- **Document Type:** Auction Results Announcement (HTML or PDF press release)
- **Expected URL Pattern:** 
  - `home.treasury.gov/news/press-releases/[slug]` OR
  - `treasurydirect.gov/auctions/results/[date]/` OR
  - `fiscalservice.treasury.gov/...` (alternate)

### Expected Content
- Auction date: March 17, 2026
- Security type: 20-Year Bond
- Yield (Discount Rate): 4.817% **[actual]**
- Yield (previous auction): 4.664% **[verification needed]**
- Bid-to-cover ratio
- Allotment breakdown
- Investor class distribution

### Expected Structure
```
# Treasury Announces Results of [Date] 20-Year Bond Auction
## Auction Details
- Issue Date: [date]
- Maturity Date: 20 years
- Yield/Discount Rate: 4.817%
- Par Amount: $X billion
## Results
- Bid-to-Cover Ratio: X:1
- Non-Competitive Bids: $X million
- Foreign Bids: $X million
## Historical Context
- Previous 20-Year Auction Yield: 4.664%
```

---

## Artifacts Created

### ✓ Completed
1. **`meta/418789.json`** (1,644 bytes)
   - Full retrieval attempt log
   - Actual vs. previous values
   - Search history and next steps

2. **`results/418789_result.md`** (3,000 bytes)
   - Formatted markdown with proper metadata header
   - Expected document structure
   - Links to official sources
   - Acceptance check template

3. **`index.json`** (861 bytes)
   - Artifact registry
   - Retrieval status tracking ("search_in_progress")

### ✗ Not Completed
4. **`raw/418789.html` or `.pdf`**
   - Reason: Document URL not yet located
   - Status: Awaiting browser-based search or API re-attempt

---

## Quality Checklist

| Criterion | Status | Notes |
|-----------|--------|-------|
| **Title Match** | ✅ Expected | "20-Year Bond Auction" matches event; awaiting document confirmation |
| **Domain Match** | ✅ Expected | treasury.gov or treasurydirect.gov is official source |
| **Full Body Extracted** | ❌ Pending | Raw document not yet retrieved |
| **Indicator Present** | ✅ Expected | "20 year bond yield" / "4.817%" will appear in results |
| **Structure Preserved** | ⏸️ Partial | Markdown skeleton prepared; awaiting actual content |
| **Numbers Verify** | ⏸️ Pending | Actual (4.817%) and previous (4.664%) documented in metadata |
| **Completeness** | ❌ Incomplete | Document structure prepared; actual auction data unavailable |

**Overall Assessment:** 2 of 6 acceptance criteria fully met. Main blocker is document URL resolution.

---

## Recommended Next Steps

### Immediate (Browser-Based)
1. **Navigate TreasuryDirect Auction Results**
   - Go to: https://www.treasurydirect.gov/auctions/results/
   - Filter or scroll to: March 17, 2026
   - Look for: "20-Year Bond" security type
   - Click through to detailed announcement

2. **Search Treasury Press Releases**
   - Go to: https://home.treasury.gov/news/press-releases/2026
   - Search page for: "March 17" and/or "20-year" or "bond"
   - Click matching entry

3. **Use TreasuryDirect Auction Query Tool**
   - Go to: https://www.treasurydirect.gov/auctions/auction-query/
   - Set filters: Date=2026-03-17, Security=20-Year Bond
   - Retrieve results URL

### Secondary (If First Attempts Fail)
4. **FiscalData API Search**
   - Query: `fiscaldata.treasury.gov/api/...` for 20-year bond data
   - Date filter: March 17, 2026

5. **Federal Reserve Auction Announcements**
   - Check: federalreserve.gov for linked Treasury announcements
   - Alternative source if Treasury site fails

### Technical (If Manual Navigation Fails)
6. **Browser Automation**
   - Use Playwright or Selenium to render JavaScript-heavy pages
   - Extract data from dynamically-loaded tables
   - Save HTML snapshot and parsed data

---

## Notes

- **Event Date:** March 17, 2026 at 17:00 UTC (5:00 PM ET)
- **Actual Yield:** 4.817% (from payload)
- **Previous Yield:** 4.664% (from payload)
- **Currency:** USD
- **Category:** Bond Auction (bnd)

The document should exist or become available near the auction date. Retrieval will be straightforward once the URL is located.

---

## References

- **TreasuryDirect:** https://www.treasurydirect.gov/
- **Treasury Press Releases:** https://home.treasury.gov/news/press-releases
- **FiscalData:** https://fiscaldata.treasury.gov/
- **Bureau of Fiscal Service:** https://fiscalservice.treasury.gov/