Skip to content

Commit a4b1d36

Browse files
richlanderclaude
andcommitted
Clarify pre-computed security navigation links
Address LLM feedback about trusting the pre-computed links: - latest-security-month starts at most recent security month (skipping empty months) - prev-security links skip non-security months automatically - Added explicit stop condition: "stop when month < target" These links are pre-computed, so LLMs should trust them rather than manually checking each month for security content. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <[email protected]>
1 parent 978a3bb commit a4b1d36

File tree

2 files changed

+5
-5
lines changed

2 files changed

+5
-5
lines changed

llms.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -45,13 +45,13 @@ Reference:
4545

4646
**"What CVEs since [date]?"** — Timeline with `prev-security`:
4747

48-
1. Timeline Index → year → `latest-security-month`
49-
2. Follow `prev-security` links until reaching target date (skips non-security months)
48+
1. Timeline Index → year → `latest-security-month` (starts at most recent security month, skipping empty months)
49+
2. Follow `prev-security` links until the month is before target date (stop when `month < target`)
5050
3. Each month index has `_embedded.disclosures[]` with severity, title, affected versions, fix commits
5151
4. Filter by `affected_releases` if user specified versions (e.g., "for my .NET 8 and 9")
5252
5. Only fetch `cve.json` if detailed descriptions or package version ranges are needed
5353

54-
This approach deduplicates CVEs affecting multiple versionseach CVE appears once per month, not once per affected version.
54+
The `latest-security-month` and `prev-security` links are pre-computedtrust them to skip non-security months efficiently. This approach also deduplicates CVEs affecting multiple versions.
5555

5656
**"What patch should I install for .NET X?"** — Direct version lookup:
5757

llms/reference.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -490,14 +490,14 @@ The CVE JSON file provides full details and pre-computed query dictionaries:
490490
**For "CVEs since [date]" queries** (with or without version filter), use `prev-security` to walk backwards:
491491

492492
1. GET `timeline/index.json` → navigate to year → `_links["latest-security-month"].href`
493-
2. Follow `prev-security` links until reaching target date (skips non-security months automatically)
493+
2. Follow `prev-security` links until the month is before target date (stop when `month < target`)
494494
3. Each month has `_embedded.disclosures[]` with severity, title, affected versions, fix commits
495495
4. Filter by `affected_releases` if user specified versions (e.g., "for my .NET 8 and 9")
496496
5. Only fetch `cve.json` if detailed descriptions or package version ranges are needed
497497
6. **Always ask**: "Would you like inline diffs for these fixes?"
498498
7. If yes: **Fetch immediately** — firewall or domain restrictions may block later access
499499

500-
Timeline is more efficient than version-based for "since [date]" queries because month indexes deduplicate CVEs affecting multiple versions (fetched once, not per-version).
500+
The `latest-security-month` and `prev-security` links are pre-computed — trust them to skip non-security months. This approach also deduplicates CVEs affecting multiple versions (fetched once, not per-version).
501501

502502
**For specific month queries**, navigate directly:
503503

0 commit comments

Comments
 (0)