graham/prop
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
prop/priv/agent-skills/read-algorithm.md
Graham McIntire fc9d0dc977
feat(agent-discovery): Link/markdown/content-signal/api-catalog/skills 
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.
2026-04-17 12:09:05 -05:00

1.5 KiB
Raw Blame History

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.