ANTRequest's PlanetSpec Specification (Version 0.1.0)

Feature Testing is the practice of discovering which features a Planet supports. This specification intentionally keeps feature discovery simple.

Table Of Contents

Table Of Contents

Status of this document

this document written on Mon Mar 16 2026 is Semantic version 0.1.0. this document is self-published independently.

This Specification Depends On

• Foundation: (0.4.0)

This Specification uses external references

• The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119.

planet.json

planet.json is a file in your /Favicond_/ folder (the /Favicond_/ folder MUST be after the domain, so it MUST be at https://{your-domain}/Favicond_/planet.json). which states some information of the planet. A valid planet.json file follows all these requirements

• Edges MUST fetch it via HTTPS and SHOULD verify the Content-Type is application/json.
• At the Root Object in the JSON you MUST have a key called compat with as value an object, this object is called the compat object.
• inside the compat object, keys MUST be absolute HTTPS URLs identifying the specifications and the values MUST be objects. the objects MUST have Feature-Slugs and values MUST be booleans
• These absolute HTTPS URLs identifying the specifications SHOULD define what their Feature-Slugs mean. This Specification makes no demands for meanings.
• Each of the Feature-Slugs MUST have a boolean indicating whether the feature of that specification is supported.
• A Feature-Slug MUST match this ECMAScript flavored RegExp /^[A-Za-z0-9\-_]+$/. slugs are case-sensitive.
• URLs MUST be HTTPS URLs
• A Feature-Slug MUST NOT be
  • extends
• A Feature-Slug MUST NOT start with Favicond_.
• the URL https://antrequest.nl/standard/PlanetSpec/0.1.0/ and the Feature-Slug main MUST be listed as supported.
• An extends key where the Feature-Slugs MUST link to a specification linked in the compat object or be Omitted entirely.

A Feature-Slug is a string set forth by a Specification Linked to by the url which is the parent object's key.

Examples of PlanetSpec (non normative)

For Illustrative purposes Only.

{
    "compat": {
        "https://antrequest.nl/standard/PlanetSpec/0.1.0/": {
            "main": true
        },
        "https://antrequest.nl/standard/FaviDiD/0.3.1/": {
            "keygen": true,
            "auth": true,
            "newProto": false
        },
        "https://antrequest.nl/standard/FaviDiD/0.1.1/": {
            "extends": "https://antrequest.nl/standard/FaviDiD/0.3.1/",
            "newProto": true
        }
    }
}

Error Handling

Edges SHOULD attempt to do the following when parsing:

An URL is HTTP, not HTTPS.

the Edge SHOULD ignore that url and its feature slugs.

An extends URL is HTTP, not HTTPS.

the Edge SHOULD ignore that url and its feature slugs. it SHOULD also ignore any children of the extended url.

A REQUIRED feature is listed as unsupported as set forth by the Specification Linked

the Edge SHOULD do as set forth in that Linked Specification, otherwise the Edge MAY ignore the entire Specification and its Feature-Slugs.

An OPTIONAL feature is listed as unsupported as set forth by the Specification Linked

the Edge SHOULD do as set forth in that Linked Specification. otherwise the Edge SHOULD ignore the section of that Specification and not too much else and its Feature-Slugs.

a Feature-Slug is absent.

the extends Feature-Slug (key) is a boolean.

the extends Feature-Slug (key) points not to a standard listed in the compat object.

a Feature-Slug (which is not extends) is not a boolean.

ignore it, and treat it as if it was false.

the planet.json isnt valid json or it wasnt served with 200

Resolve {"compat":{}} instead, basically nothing is supported

a planet.json lists https://antrequest.nl/standard/PlanetSpec/0.1.0/ as false.

this is Edge-Approximated. the ideal behavior is as follows: Edges MAY cancel the whole operation. Edges SHOULD do as the Fork (if any) set forth unless that is impossible or otherwise unachievable (for example violates applicable law).

Extendable Features

if a standard is forked (like i encourage mine to be) you might inherit features from them. which is where the extends comes in. if a feature doesnt exist in this feature object the Edge MUST go to the extends object and look there.

Edges MUST detect cycles in the extends chain (e.g., A -> B -> C -> A) and return false for the feature if a cycle is detected.

Philosophy

PlanetSpec only cares about what a planet can do Right Now, as in "Does this Planet support Specification Z as described Right Now", this is an objective fact and doesnt impact anyone's privacy or security. Edges are instructed to take your word for it if it is listed as false and MUST verify as set forth in Specification Z if it is listed as true. Edges MAY have a local reputation bank and MAY decrease or blacklist a planet if it is true but not supported. but that is fully Edge-Defined.

also Edge-Defined is that if the user can and wants to is to share their local reputation bank with others. this Specification makes no demands about how Edged and users treat, use, and distribute their local reputation bank (or even if they have any). Such sharing, if it occurs, is between users and outside the scope of this protocol.

Caching

Edges SHOULD respect caching headers. caching headers Planets set is Planet-Defined.

Author's Notes

please tell me how i did. this is self-published independently.