I/O projection contract

Calendar data without heavyweight clients.

Super-Calendar I/O exposes stable nodes from calendar resources as plain text, tables, rows, columns, cells, JSON, CSV, TSV, and NDJSON. A device can read one forecast line without parsing the whole API response.

Full API

Full JSON, ICS, or app-facing response.

Node I/O

One table, row, column, field, or cell in a simple format.

Shared runtime

The same source can feed docs, status checks, calendar previews, and low-level clients.

Addressing

One resolver, predictable paths.

Address	Type	Meaning
`/api/weather/io`	root	Manifest for one resource.
`/api/weather/io/events`	table	Events table.
`/api/weather/io/events/1`	row	First event row. Indexes start at 1.
`/api/weather/io/events/summary.txt`	column	All event summaries as text lines.
`/api/weather/io/events/1/summary.txt`	cell	One event summary as text.
`/api/weather/io/meta/calendarDesc.txt`	field	One metadata field.

Formats

Suffixes for clients that cannot negotiate headers.

txt json csv tsv ndjson

Resources

Examples generated from the I/O manifest.

⛅ Weather

Weather forecast calendar nodes.

/api/weather/io/events/summary.txt?city=Sao%20Paulo&units=metric&lang=pt-BR&emoji=true

events table
events/summary column txt, json, csv, tsv
meta/calendarDesc field txt, json

Open example Feed page

💱 Exchange

Currency exchange calendar nodes.

/api/exchange/io/events/summary.txt?base=USD&target=BRL&lang=pt-BR&emoji=true

events table
events/summary column txt, json, csv, tsv

Open example Feed page

🌙 Moon

Moon phase calendar nodes.

/api/moon/io/events/summary.txt?lang=en&emoji=true

events table
events/summary column txt, json, csv, tsv

Open example Feed page

🛐 Religion

Religious observance calendar nodes.

/api/religion/io/events/summary.txt?religion=christianity&lang=en&emoji=true

events table
events/summary column txt, json, csv, tsv

Open example Feed page

Shared snapshot

Use one source for docs, status, and calendar tests.

The test calendar should serve a real fixture-backed ICS instead of fan-out requests. That keeps docs deterministic and avoids accidental provider cost.

/api/super-node/scn_7c7db0f8b8b84f3ca57e25f9/calendar.ics

Open calendar test Open snapshot ICS