1
0
mirror of synced 2025-12-19 18:06:02 -05:00

Clarify pre-computation timing and anti-pattern reasoning

- "pre-computed" → "pre-computed at publish time" (reinforces static nature)
- Anti-pattern now explains why: "(this adds fetches and duplicates work
  the graph already did)"

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Richard Lander
2025-12-08 16:06:55 -08:00
parent daa493cb34
commit d58db9fc08
2 changed files with 4 additions and 4 deletions

View File

@@ -51,7 +51,7 @@ Reference:
4. Filter by `affected_releases` if user specified versions
5. Only fetch `cve.json` for CVSS vectors, CWE, or package version ranges
The `prev-security` links are pre-computed and cross year boundaries automatically (e.g., `2025/01` → `2024/11`). Following them is O(security-months), not O(all-months). No year index fetches needed after the first.
The `prev-security` links are pre-computed at publish time and cross year boundaries automatically (e.g., `2025/01` → `2024/11`). Following them is O(security-months), not O(all-months). No year index fetches needed after the first.
Example traversal for "CVEs since September 2024":
@@ -66,7 +66,7 @@ Timeline Index → 2025/index.json
→ prev-security → 2024/08 (before Sept, STOP)
```
**Anti-pattern:** Do not fetch year indexes to inspect `_embedded.months[]` and plan fetches manually. The `prev-security` chain already encodes this — follow it instead.
**Anti-pattern:** Do not fetch year indexes to inspect `_embedded.months[]` and plan fetches manually (this adds fetches and duplicates work the graph already did). The `prev-security` chain already encodes this — follow it instead.
**"What patch should I install for .NET X?"** — Direct version lookup:

View File

@@ -497,9 +497,9 @@ The CVE JSON file provides full details and pre-computed query dictionaries:
6. **Always ask**: "Would you like inline diffs for these fixes?"
7. If yes: **Fetch immediately** — firewall or domain restrictions may block later access
The `prev-security` links are pre-computed and cross year boundaries automatically (e.g., `2025/01``2024/11`). Following them is O(security-months), not O(all-months). No year index fetches needed after the first.
The `prev-security` links are pre-computed at publish time and cross year boundaries automatically (e.g., `2025/01``2024/11`). Following them is O(security-months), not O(all-months). No year index fetches needed after the first.
**Anti-pattern:** Do not fetch year indexes to inspect `_embedded.months[]` and plan fetches manually. The `prev-security` chain already encodes this — follow it instead.
**Anti-pattern:** Do not fetch year indexes to inspect `_embedded.months[]` and plan fetches manually (this adds fetches and duplicates work the graph already did). The `prev-security` chain already encodes this — follow it instead.
**For specific month queries**, navigate directly: