Graham McIntire
fc9d0dc977
Implements the subset of the isitagentready.com checklist that maps to
real capabilities of this site:
- RFC 8288 Link headers on every browser response advertising
service-doc (/algo), about, privacy-policy, and sitemap.
- Markdown-for-Agents content negotiation: requests with
Accept: text/markdown for / or /algo return real markdown
(curated summary + verbatim algo.md) with x-markdown-tokens hint.
Other paths still 406 — no synthesizing markdown from LiveView HTML.
- Content-Signal directive in robots.txt declaring
search=yes, ai-train=no, ai-input=no.
- RFC 9727 API catalog at /.well-known/api-catalog with the sole
public endpoint (/api/contacts/map) linking status -> /health and
service-desc -> /openapi.json (a new minimal OpenAPI 3.0 spec).
- Agent Skills Discovery index at /.well-known/agent-skills/index.json
listing two skill documents (fetch-contacts, read-algorithm) with
sha256 digests computed at compile time; documents served at
/.well-known/agent-skills/{name}/SKILL.md.
Skipped (don't match actual site capabilities): Web Bot Auth JWKS,
OAuth/OIDC discovery, MCP server card.
27 lines
1.5 KiB
Markdown
27 lines
1.5 KiB
Markdown
# Read propagation algorithm documentation
|
||
|
||
The scoring algorithm for amateur-radio microwave propagation (902 MHz – 241 GHz) is documented in long-form markdown, covering factor weights, band-specific configurations, ITU-R atmospheric models, and calibration dataset composition.
|
||
|
||
## Endpoint
|
||
|
||
```
|
||
GET https://prop.w5isp.com/algo
|
||
```
|
||
|
||
The default response is HTML. Send `Accept: text/markdown` to receive the raw markdown source directly:
|
||
|
||
```
|
||
GET https://prop.w5isp.com/algo
|
||
Accept: text/markdown
|
||
```
|
||
|
||
Response: `Content-Type: text/markdown; charset=utf-8`. An `x-markdown-tokens` header gives a rough token-count estimate for context-window planning.
|
||
|
||
## Content summary
|
||
|
||
- Scoring methodology: 10 weighted factors combining to a 0–100 composite score per grid point per band.
|
||
- Factor weights (humidity 13.6 %, time of day 5.0 %, T-Td depression 9.8 %, refractivity 10.5 %, sky 8.0 %, season 11.1 %, wind 8.0 %, rain 13.6 %, pressure 10.3 %, PWAT 11.3 %) recalibrated 2026-04-11 via gradient descent against 57,488 tropospheric QSOs.
|
||
- Band-dependent humidity effect: beneficial at 10 GHz (refractivity gradients), harmful at 24 GHz+ (gaseous absorption).
|
||
- ITU-R model references: P.838-3 (rain attenuation), P.526-16 (diffraction), P.676 (gaseous absorption).
|
||
- Terrain analysis: 97.2 % of all analysed QSO paths are terrain-blocked; atmospheric ducting and refraction are the primary enabling mechanisms.
|
||
- Calibration dataset: 58 k+ QSOs, HRRR atmospheric profiles, RAOB soundings, IEMRE gridded observations, SRTM terrain, and commercial link SNMP polling at 11/24/68 GHz.
|