Skip to content
supercarto
Esc
↑↓navigate↵open⌘Jpreview
On this page

Honesty rules

The refusal, absence, and degradation semantics that run through every tool — silence is never punctuality.

Every tool in supercarto is built on one rule, applied everywhere: a missing answer must not read like a present-and-fine answer. An agent’s failure mode is not saying “I don’t know”; it is saying something plausible-sounding that the person then acts on. These are the semantics that policy enforces:

Situation What the deployment does What it never does
No traffic credential tool not advertised; routing labels free-flow report free-flow as live congestion
No GTFS feed transit tools not advertised answer “no service”
Date with no scheduled service keeps stops, routes: [], says so in the note read as “the feed is broken”
Feed without a calendar whole network, window declared unknown present whole-feed data as today’s schedule
Stop with no realtime prediction no live: entry, note says “unknown” render as “on time”
Weather source unreachable degraded set, tool raises return zeroes
Place with no recorded hours no hours: field at all render as closed — or open
Source used is a fallback source: names the fallback, warnings travel name the primary source
Public demo router route demoted to feasibility hand over fiction as fact

Three states, never two

The pattern underlying most rows: absence is a third state. Known-open and known-closed are facts; never-recorded is unknown. hours absent is not closed. A stop without a prediction is not on time. A no-service day is not no stops. Each distinction changes what a person should do next, so each is encoded in the output — inside the map where a model reading only one block still sees it, not on this documentation page.

A developer’s sketch

Before a feature ships, its failure behavior is designed — at length and in the open. The honest-refusal states are part of the specification: one tool that could return “on time” for a scheduled-and-silent bus has more to prove than ten that came up short on tokens.

Last updated on

Was this page helpful?